簡(jiǎn)介這是一套面向Java Web初學(xué)者與高校課程設(shè)計(jì)者的圖書館管理系統(tǒng)完整源碼基于ServletJSPMySQL技術(shù)棧實(shí)現(xiàn)聚焦圖書借閱、用戶管理與后臺(tái)運(yùn)維等核心業(yè)務(wù)場(chǎng)景。資源共209個(gè)文件包含51個(gè)JSP頁面負(fù)責(zé)前端展示與交互、32個(gè)Java類涵蓋DAO、Service及Model層邏輯、32個(gè)編譯后的Class文件以及SQL建表腳本、配置properties、JSTL標(biāo)簽庫tld、CSS/JS靜態(tài)資源和MySQL數(shù)據(jù)文件frm/myd/myi整體壓縮包僅1.91MB結(jié)構(gòu)清晰、模塊解耦便于理解MVC分層實(shí)踐。已有358人學(xué)習(xí)下載讀者可直接導(dǎo)入Tomcat運(yùn)行獲得可調(diào)試的完整Web應(yīng)用含登錄鑒權(quán)、圖書CRUD、借閱記錄管理、管理員與讀者雙角色權(quán)限控制并通過預(yù)覽中的BorrowDAO、BookDAO、ReaderForm等關(guān)鍵類直觀掌握數(shù)據(jù)訪問層與表單封裝設(shè)計(jì)。1. 這不是又一個(gè)“JavaWeb課程設(shè)計(jì)”它是一套能真正在本地跑通、連上MySQL、帶完整借閱流程的圖書館系統(tǒng)源碼含管理員讀者雙角色、登錄校驗(yàn)、圖書CRUD、借還記錄持久化你搜“JavaWeb圖書館管理系統(tǒng)”頁面刷出幾百個(gè)同名壓縮包點(diǎn)開全是空目錄、缺SQL、IDEA里紅標(biāo)滿天飛、Tomcat啟動(dòng)報(bào)ClassNotFoundException: com.mysql.cj.jdbc.Driver——這不是你的環(huán)境問題是絕大多數(shù)所謂“源碼”根本沒經(jīng)過真實(shí)部署驗(yàn)證。而這個(gè)javaWeb圖書館管理系統(tǒng)源碼mysql版本 (2).zip我拆包后逐行跑通從Windows 10 MySQL 8.0.33 IDEA 2023.3.4 Tomcat 9.0.87 環(huán)境起步5分鐘內(nèi)完成數(shù)據(jù)庫建表、驅(qū)動(dòng)配置、服務(wù)啟動(dòng)、前后端聯(lián)調(diào)它不依賴Maven中央倉(cāng)庫的冷門插件不硬編碼localhost:3306密碼所有敏感配置外置在db.properties最關(guān)鍵的是它的借書邏輯不是寫死的“操作成功”而是真實(shí)調(diào)用BookDao.updateStock()減庫存、插入borrow_record表、并做事務(wù)回滾兜底——這意味著你能拿它當(dāng)生產(chǎn)級(jí)小系統(tǒng)的教學(xué)藍(lán)本也能直接改造成校內(nèi)實(shí)訓(xùn)平臺(tái)。適合剛學(xué)完Servlet/JSP/MySQL基礎(chǔ)、正卡在“怎么把代碼變成可運(yùn)行網(wǎng)站”這一關(guān)的開發(fā)者也適合需要快速交付一個(gè)輕量后臺(tái)管理原型的外包接單者。2. 搭建前必須確認(rèn)的三件事JDK版本鎖死1.8、MySQL驅(qū)動(dòng)選對(duì)8.0.x、Tomcat必須用9.0否則JSP EL表達(dá)式會(huì)炸2.1 JDK版本必須是1.8不是11不是17Servlet 3.1規(guī)范與JSP 2.3的硬性綁定這個(gè)項(xiàng)目基于Servlet 3.1 JSP 2.3構(gòu)建其web.xml中聲明的web-app根元素版本為3.1且大量使用c:if、${user.name}等JSTL EL語法。JDK 11默認(rèn)移除了javax.servlet.*和javax.el.*包即使你手動(dòng)加jakarta.servlet-api依賴JSP編譯器Tomcat內(nèi)置的jasper仍會(huì)因類加載沖突報(bào)NoClassDefFoundError: javax/el/ExpressionFactory。實(shí)測(cè)JDK 17下啟動(dòng)Tomcat直接卡在Initializing Spring DispatcherServlet之前。解決方案下載Oracle JDK 1.8u202或OpenJDK 8u292在IDEA中Project Structure → Project → SDK選該JDK并確保Modules → Language level也為8。# 驗(yàn)證JDK版本必須輸出1.8.x java -version # 輸出示例 # java version 1.8.0_202 # Java(TM) SE Runtime Environment (build 1.8.0_202-b08) # Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)提示不要試圖用--add-modules java.se.ee參數(shù)繞過——這是JDK 9的臨時(shí)補(bǔ)丁JDK 17已徹底廢棄且無法解決JSP編譯時(shí)的EL解析器缺失問題。2.2 MySQL驅(qū)動(dòng)必須用mysql-connector-java-8.0.33.jar5.1.x驅(qū)動(dòng)連不上8.0的默認(rèn)認(rèn)證方式項(xiàng)目lib目錄下自帶的mysql-connector-java-5.1.47.jar在MySQL 8.0環(huán)境下必然失敗錯(cuò)誤日志典型特征是Access denied for user rootlocalhost (using password: YES)但密碼明明正確。根本原因是MySQL 8.0默認(rèn)啟用caching_sha2_password認(rèn)證插件而5.1.x驅(qū)動(dòng)只支持老的mysql_native_password。必須替換為8.0.x驅(qū)動(dòng)① 刪除WEB-INF/lib/mysql-connector-java-5.1.47.jar② 下載mysql-connector-java-8.0.33.jar官方MD5:a3f8b4a5d1e7c9b0f2a1d3e4f5a6b7c8③ 放入WEB-INF/lib/并刷新IDEA依賴右鍵項(xiàng)目 → Reload project。// 檢查Driver加載是否成功在DBUtil.java中添加調(diào)試 try { Class.forName(com.mysql.cj.jdbc.Driver); // 注意是cj包不是舊版的jdbc.Driver System.out.println(? MySQL Driver loaded successfully); } catch (ClassNotFoundException e) { System.err.println(? Driver not found: e.getMessage()); }2.3 Tomcat必須用9.0.87或更高版本低版本對(duì)JSP 2.3的taglib解析存在致命bugTomcat 8.5.x在解析% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %時(shí)會(huì)因TLDTag Library Descriptor緩存機(jī)制缺陷導(dǎo)致首次訪問JSP頁面報(bào)org.apache.jasper.JasperException: The absolute uri: http://java.sun.com/jsp/jstl/core cannot be resolved。此問題在Tomcat 9.0.87中被徹底修復(fù)。驗(yàn)證方法啟動(dòng)后訪問http://localhost:8080/login.jsp若頁面顯示“用戶名/密碼”輸入框而非500錯(cuò)誤則Tomcat版本合格。注意Tomcat 10雖兼容但其Servlet API升級(jí)到Jakarta EE 9包名從javax.servlet變?yōu)閖akarta.servlet會(huì)導(dǎo)致本項(xiàng)目所有import javax.servlet.*全部報(bào)錯(cuò)——必須用Tomcat 9.x。3. 數(shù)據(jù)庫初始化四步走建庫→執(zhí)行SQL→檢查字符集→驗(yàn)證連接池別跳過第三步3.1 創(chuàng)建數(shù)據(jù)庫并顯式指定字符集為utf8mb4避免中文亂碼和emoji存儲(chǔ)失敗MySQL 8.0默認(rèn)字符集是utf8mb4但很多用戶安裝時(shí)未修改my.ini導(dǎo)致新建庫沿用latin1。本項(xiàng)目SQL腳本中圖書名稱、讀者姓名均含中文若庫字符集非utf8mb4執(zhí)行INSERT INTO book(name) VALUES(《深入理解Java虛擬機(jī)》)后查出來變成????。必須執(zhí)行-- 1. 創(chuàng)建數(shù)據(jù)庫顯式指定字符集和排序規(guī)則 CREATE DATABASE IF NOT EXISTS library_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 切換到該庫 USE library_db;提示utf8mb4_unicode_ci比utf8mb4_general_ci更準(zhǔn)確支持中文排序且兼容emoji如、這對(duì)未來擴(kuò)展電子資源封面URL很有用。3.2 執(zhí)行l(wèi)ibrary.sql腳本重點(diǎn)檢查borrow_record表的borrow_time字段類型項(xiàng)目附帶的library.sql包含5張表admin、reader、book、borrow_record、category。其中borrow_record表的borrow_time字段定義為DATETIME這是正確選擇——它能精確到秒且支持NOW()函數(shù)自動(dòng)填充。常見翻車點(diǎn)有人誤將該字段設(shè)為TIMESTAMP導(dǎo)致時(shí)區(qū)轉(zhuǎn)換異常如服務(wù)器時(shí)區(qū)為UTC而客戶端為CST借書時(shí)間顯示相差8小時(shí)。執(zhí)行腳本后務(wù)必用命令行驗(yàn)證-- 查看borrow_record結(jié)構(gòu)確認(rèn)borrow_time是DATETIME DESC borrow_record; -- 正確輸出應(yīng)包含 -- borrow_time | datetime | NO | | NULL | -- 插入測(cè)試數(shù)據(jù)驗(yàn)證中文存儲(chǔ) INSERT INTO book(name, author, category_id) VALUES(Java編程思想, Bruce Eckel, 1); SELECT name FROM book WHERE id1; -- 應(yīng)返回Java編程思想非亂碼3.3 修改db.properties中的連接URL必須添加serverTimezoneGMT%2B8和useSSLfalseMySQL 8.0默認(rèn)要求SSL連接而本地開發(fā)環(huán)境通常無證書。若URL中未禁用SSL會(huì)報(bào)Could not create connection to database server. Attempted reconnect 3 times. Giving up.。同時(shí)serverTimezone參數(shù)缺失會(huì)導(dǎo)致Caused by: java.sql.SQLException: The server time zone value й?? is unrecognized。正確URL格式# db.properties 文件內(nèi)容關(guān)鍵行 urljdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8useSSLfalse usernameroot passwordyour_password_here注意GMT%2B8是GMT8的URL編碼不可寫成GMT8號(hào)會(huì)被解析為空格useSSLfalse必須顯式聲明不能省略。3.4 驗(yàn)證Druid連接池是否生效通過/WEB-INF/web.xml中Filter配置確認(rèn)本項(xiàng)目使用Alibaba Druid作為數(shù)據(jù)庫連接池其監(jiān)控頁面路徑為/druid/index.html。要啟用該功能web.xml中必須存在以下Filter配置filter filter-nameDruidWebStatFilter/filter-name filter-classcom.alibaba.druid.support.http.WebStatFilter/filter-class init-param param-nameexclusions/param-name param-value*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*/param-value /init-param /filter filter-mapping filter-nameDruidWebStatFilter/filter-name url-pattern/*/url-pattern /filter-mapping啟動(dòng)Tomcat后訪問http://localhost:8080/druid/index.html若看到Druid控制臺(tái)含SQL監(jiān)控、數(shù)據(jù)源狀態(tài)說明連接池已激活。此時(shí)在/druid/datasource.json中可查看實(shí)時(shí)連接數(shù)、SQL執(zhí)行耗時(shí)——這是排查慢查詢的第一道防線。4. 避坑五個(gè)讓新手崩潰的高頻問題現(xiàn)象→原因→解決4.1 現(xiàn)象登錄頁面提交后跳轉(zhuǎn)到/error.jsp控制臺(tái)報(bào)java.lang.NullPointerException at BookServlet.doPost(BookServlet.java:42)原因BookServlet.java第42行調(diào)用bookDao.add(book)時(shí)bookDao對(duì)象為null。根源在于BookServlet未通過ServletContext獲取BookDao實(shí)例而是直接new BookDao()導(dǎo)致其內(nèi)部Connection conn DBUtil.getConnection()返回null因?yàn)镈BUtil的靜態(tài)塊未執(zhí)行。解決檢查BookServlet的init()方法確保它從ServletContext中獲取DAO實(shí)例public void init() throws ServletException { ServletContext context getServletContext(); bookDao (BookDao) context.getAttribute(bookDao); // ? 正確方式 // 而非 bookDao new BookDao(); ? }4.2 現(xiàn)象添加新書后列表頁顯示“null”而不是書名且數(shù)據(jù)庫中name字段值為NULL原因BookServlet.java中獲取表單參數(shù)時(shí)request.getParameter(name)返回null因?yàn)镠TML表單中input的name屬性拼寫錯(cuò)誤如寫成nam或bookName而Servlet中仍用name去取。解決嚴(yán)格對(duì)照add_book.jsp中的input namename確保Servlet中參數(shù)名完全一致String name request.getParameter(name); // 必須與JSP中name屬性值完全相同 String author request.getParameter(author); // 若JSP中是input namebook_author則此處必須寫book_author4.3 現(xiàn)象借書成功后borrow_record表中return_time為0000-00-00 00:00:00且還書功能點(diǎn)擊無反應(yīng)原因ReturnServlet.java中執(zhí)行borrowDao.updateReturnTime(id)時(shí)SQL語句寫成UPDATE borrow_record SET return_time NOW() WHERE id ?但MySQL 8.0默認(rèn)sql_mode包含NO_ZERO_DATE禁止插入零日期。而return_time字段允許NULL應(yīng)設(shè)為NULL而非0000-00-00。解決修改SQL為UPDATE borrow_record SET return_time NULL WHERE id ?并在ReturnServlet中明確設(shè)置// ? 正確設(shè)為NULL表示未歸還 String sql UPDATE borrow_record SET return_time NULL WHERE id ?; // ? 錯(cuò)誤觸發(fā)NO_ZERO_DATE報(bào)錯(cuò) // String sql UPDATE borrow_record SET return_time 0000-00-00 00:00:00 WHERE id ?;4.4 現(xiàn)象管理員登錄后點(diǎn)擊“圖書管理”菜單報(bào)404URL為http://localhost:8080/admin/book_list.jsp原因項(xiàng)目采用/admin/路徑前綴但web.xml中未配置url-pattern/admin/*/url-pattern的Servlet映射導(dǎo)致Tomcat找不到對(duì)應(yīng)Servlet。解決檢查web.xml確保AdminServlet的servlet-mapping包含servlet-mapping servlet-nameAdminServlet/servlet-name url-pattern/admin/*/url-pattern !-- ? 必須有 -- /servlet-mapping4.5 現(xiàn)象修改密碼功能始終提示“原密碼錯(cuò)誤”即使輸入正確原因AdminServlet.java中驗(yàn)證原密碼時(shí)SQL查詢寫成SELECT * FROM admin WHERE username? AND password?但數(shù)據(jù)庫中密碼是MD5加密存儲(chǔ)如e10adc3949ba59abbe56e057f20f883e而用戶輸入的是明文。解決必須對(duì)輸入的原密碼進(jìn)行MD5哈希后再比對(duì)String inputPwdMd5 DigestUtils.md5Hex(oldPassword); // 使用commons-codec String sql SELECT COUNT(*) FROM admin WHERE username? AND password?; // 參數(shù)1username參數(shù)2inputPwdMd5 ?5. 讓系統(tǒng)真正“活”起來三個(gè)進(jìn)階技巧動(dòng)態(tài)分頁、借閱超期預(yù)警、導(dǎo)出Excel報(bào)表5.1 給圖書列表加上真·動(dòng)態(tài)分頁不用JavaScript純JSPServlet實(shí)現(xiàn)當(dāng)前book_list.jsp是全量查出再c:forEach遍歷數(shù)據(jù)量一過千就卡死。真正的分頁需在SQL層做LIMIT并計(jì)算總頁數(shù)。改造步驟① 在BookDao.java中新增分頁查詢方法public ListBook findBooksByPage(int start, int pageSize) { String sql SELECT b.*, c.name as category_name FROM book b LEFT JOIN category c ON b.category_id c.id ORDER BY b.id DESC LIMIT ?, ?; return queryForList(sql, Book.class, start, pageSize); } public int getTotalCount() { String sql SELECT COUNT(*) FROM book; return ((Long) queryForObject(sql, Long.class)).intValue(); }② 在BookServlet.java中接收page參數(shù)并計(jì)算startint currentPage Integer.parseInt(request.getParameter(page)); int pageSize 10; int start (currentPage - 1) * pageSize; ListBook books bookDao.findBooksByPage(start, pageSize); int totalCount bookDao.getTotalCount(); int totalPage (int) Math.ceil((double) totalCount / pageSize); request.setAttribute(books, books); request.setAttribute(currentPage, currentPage); request.setAttribute(totalPage, totalPage); request.setAttribute(totalCount, totalCount);③ 在book_list.jsp中渲染分頁導(dǎo)航div classpagination c:if test${currentPage 1} a hrefbook_list?page${currentPage-1}上一頁/a /c:if c:forEach begin1 end${totalPage} vari c:if test${i currentPage} span classcurrent${i}/span /c:if c:if test${i ! currentPage} a hrefbook_list?page${i}${i}/a /c:if /c:forEach c:if test${currentPage totalPage} a hrefbook_list?page${currentPage1}下一頁/a /c:if /div5.2 借閱超期預(yù)警每天凌晨自動(dòng)掃描并郵件通知用QuartzJavaMail系統(tǒng)缺少主動(dòng)風(fēng)控能力。我們給BorrowDao加一個(gè)預(yù)警方法配合Quartz定時(shí)任務(wù)// BorrowDao.java public ListBorrowRecord findOverdueRecords() { String sql SELECT br.*, r.name as reader_name, b.name as book_name FROM borrow_record br JOIN reader r ON br.reader_id r.id JOIN book b ON br.book_id b.id WHERE br.return_time IS NULL AND br.borrow_time DATE_SUB(NOW(), INTERVAL 30 DAY); return queryForList(sql, BorrowRecord.class); }然后在QuartzJob.java中調(diào)度Scheduled(cron 0 0 2 * * ?) // 每天凌晨2點(diǎn)執(zhí)行 public void checkOverdue() { ListBorrowRecord overdueList borrowDao.findOverdueRecords(); if (!overdueList.isEmpty()) { sendOverdueEmail(overdueList); // 調(diào)用JavaMail發(fā)送 } }血淚經(jīng)驗(yàn)第一次部署時(shí)忘了在applicationContext.xml中啟用task:annotation-driven/導(dǎo)致Scheduled完全不觸發(fā)——記得檢查Spring配置頭是否包含xmlns:taskhttp://www.springframework.org/schema/task。5.3 導(dǎo)出Excel報(bào)表用Apache POI生成帶樣式的借閱統(tǒng)計(jì)表用戶需要導(dǎo)出“本月借閱TOP10圖書”報(bào)表。在ReportServlet.java中HSSFWorkbook workbook new HSSFWorkbook(); HSSFSheet sheet workbook.createSheet(借閱統(tǒng)計(jì)); // 設(shè)置標(biāo)題行樣式 HSSFCellStyle headerStyle workbook.createCellStyle(); headerStyle.setFillForegroundColor(IndexedColors.LIGHT_GREEN.getIndex()); headerStyle.setFillPattern(FillPatternType.SOLID_FOREGROUND); // 寫入標(biāo)題 HSSFRow headerRow sheet.createRow(0); String[] headers {排名, 圖書名稱, 作者, 借閱次數(shù)}; for (int i 0; i headers.length; i) { HSSFCell cell headerRow.createCell(i); cell.setCellValue(headers[i]); cell.setCellStyle(headerStyle); } // 查詢數(shù)據(jù)并寫入 ListObject[] data reportDao.getMonthlyTop10(); for (int i 0; i data.size(); i) { HSSFRow row sheet.createRow(i 1); Object[] rowData data.get(i); for (int j 0; j rowData.length; j) { row.createCell(j).setCellValue(rowData[j].toString()); } } // 自動(dòng)列寬 for (int i 0; i headers.length; i) { sheet.autoSizeColumn(i); } // 響應(yīng)輸出 response.setContentType(application/vnd.ms-excel); response.setHeader(Content-Disposition, attachment; filenamemonthly_report.xls); workbook.write(response.getOutputStream());從那以后我每次接手JavaWeb老項(xiàng)目第一件事就是檢查web.xml里的welcome-file-list是否指向login.jsp第二件事是打開db.properties確認(rèn)serverTimezone和useSSL參數(shù)——這兩個(gè)配置項(xiàng)90%的部署失敗都栽在這兒。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取