:從環(huán)境配置到期末答辯完整指南)
簡介一份基于Java與MySQL的圖書館信息管理系統(tǒng)完整項(xiàng)目面向計(jì)算機(jī)專業(yè)學(xué)生適用于期末大作業(yè)、課程設(shè)計(jì)或本科畢業(yè)設(shè)計(jì)參考。項(xiàng)目包含前端Vue頁面、后端Java服務(wù)、數(shù)據(jù)庫SQL腳本以及配套說明文檔代碼注釋詳細(xì)清晰降低了初學(xué)者的理解門檻。資源包內(nèi)共152個(gè)文件大小約11.79MB主要包括Java源碼、Vue組件、JavaScript腳本、CSS樣式表、SQL數(shù)據(jù)腳本和Markdown說明文件文件分類明確前后端與數(shù)據(jù)庫結(jié)構(gòu)一目了然便于按模塊查閱與二次開發(fā)。系統(tǒng)實(shí)現(xiàn)了圖書信息管理、借閱與歸還流程、讀者資料維護(hù)、圖書檢索等常用功能界面簡潔美觀操作邏輯順暢經(jīng)過完整調(diào)試后可直接部署使用。該項(xiàng)目由作者在課程作業(yè)中開發(fā)并獲得高分目前已有153人在CSDN學(xué)習(xí)下載整體評價(jià)良好是完成期末大作業(yè)和畢業(yè)設(shè)計(jì)的實(shí)用參考資料。1. 圖書館信息管理系統(tǒng)期末大作業(yè)里最容易被低估的JavaMySQL項(xiàng)目期末周拿到這套題的人多半先搜個(gè)開源項(xiàng)目改改結(jié)果困在JDBC驅(qū)動版本、MySQL 8認(rèn)證插件和Tomcat端口沖突里正經(jīng)業(yè)務(wù)代碼一行沒寫。圖書館信息管理系統(tǒng)作為Java和MySQL期末大作業(yè)核心是登錄會話、圖書/讀者/借閱三類對象的增刪改查以及借書還書時(shí)的事務(wù)邊界——沒有高并發(fā)、沒有分布式但它恰好把JavaWeb最該考的語法、JDBC操作、SQL設(shè)計(jì)全串起來了。這個(gè)方向適合兩類人一是想用一個(gè)完整案例把JavaWeb鏈路走通的初學(xué)者二是需要一份能過答辯、文檔齊全的期末交付物。別指望它炫技它值錢的地方是結(jié)構(gòu)完整、能跑通、能講明白。2. 項(xiàng)目結(jié)構(gòu)與技術(shù)選型先分清JSPServlet和Spring Boot的邊界2.1 這套系統(tǒng)到底長什么樣三個(gè)功能域與兩條數(shù)據(jù)流我拿到這種標(biāo)題的項(xiàng)目第一件事不是看代碼是畫功能邊界。圖書館信息管理系統(tǒng)無論怎么改功能域都不會跑出三塊讀者端查書借書還書、管理員端圖書管理、系統(tǒng)端的登錄與權(quán)限控制。對應(yīng)到數(shù)據(jù)流就是兩條一條是讀者發(fā)起借閱系統(tǒng)扣減庫存并生成借閱記錄另一條是管理員維護(hù)圖書信息所有操作落MySQL。把這兩個(gè)流畫清楚后面所有表和代碼都是順著填坑。期末大作業(yè)的常見做法是用JSPServletJDBC不引Spring Boot。原因很實(shí)際多數(shù)學(xué)校JavaWeb課程教的就是Servlet和JSPSpring Boot在答辯時(shí)容易被追問“依賴原理”答不上來反而減分。但如果你是自學(xué)者Spring Boot能省掉大量web.xml配置用RestController暴露JSON接口前端用簡單HTMLaxios就夠。標(biāo)題只說JAVA和MySQL沒限定框架我建議按你課程進(jìn)度選——課程教的是Servlet就寫Servlet別用一個(gè)你沒在課堂上講過的框架冒險(xiǎn)。2.2 環(huán)境清單與版本對應(yīng)JDK、Tomcat、MySQL怎么配對環(huán)境配不齊是這類項(xiàng)目跑不起來的頭號原因。我一般用這套組合JDK 8、Tomcat 8.5、MySQL 5.7或8.0、Eclipse或IDEA。JDK 8配Tomcat 8.5幾乎不會有什么兼容問題Servlet 3.1規(guī)范對應(yīng)Tomcat 8.5JavaEE項(xiàng)目粘貼進(jìn)去直接部署。MySQL方面5.7和8.0都行但JDBC連接串不一樣尤其是8.0必須帶serverTimezone參數(shù)驅(qū)動類名也從com.mysql.jdbc.Driver變成了com.mysql.cj.jdbc.Driver。這一點(diǎn)在避坑章節(jié)我會展開說。如果你的機(jī)器還沒裝MySQL網(wǎng)上mysql安裝配置教程非常多我提三個(gè)要點(diǎn)安裝時(shí)選UTF-8字符集、端口保持默認(rèn)3306、服務(wù)名記住別和舊版沖突。裝好以后用命令行驗(yàn)證一下能進(jìn)MySQL才繼續(xù)下一步。JDK環(huán)境變量配置同樣是個(gè)常見卡點(diǎn)配好后在命令行執(zhí)行java -version確認(rèn)輸出1.8版本再開始寫代碼。2.3 建庫建賬號先給項(xiàng)目開一塊獨(dú)立數(shù)據(jù)庫空間不要直接拿root賬號連數(shù)據(jù)庫更不要和別人的作業(yè)共用一個(gè)庫。我建這類項(xiàng)目時(shí)固定先創(chuàng)建一個(gè)獨(dú)立數(shù)據(jù)庫和專用賬號權(quán)限只給這一個(gè)庫這樣即使代碼里寫錯(cuò)SQL也不會影響機(jī)器上其他數(shù)據(jù)庫。CREATE DATABASE IF NOT EXISTS library_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER lib_userlocalhost IDENTIFIED BY Lib2024; GRANT SELECT, INSERT, UPDATE, DELETE ON library_db.* TO lib_userlocalhost; FLUSH PRIVILEGES;utf8mb4和utf8的區(qū)別在于emoji和生僻字雖然期末項(xiàng)目用不到但答辯時(shí)說出這個(gè)細(xì)節(jié)是加分項(xiàng)。GRANT語句只授權(quán)了SELECT/INSERT/UPDATE/DELETE四種操作沒給DROP和CREATE權(quán)限這會在建表階段帶來一點(diǎn)麻煩。實(shí)際做法是先用root建完表再回收權(quán)限重新授權(quán)或者直接給lib_user加上CREATE和DROP權(quán)限等項(xiàng)目收尾再收回來。命令行工具里SHOW DATABASES;能看到新庫就說明環(huán)境這塊已經(jīng)通了。2.4 項(xiàng)目目錄結(jié)構(gòu)與JDBC連接池從哪里放Java文件、哪里放JSP完整的期末項(xiàng)目目錄都是按Maven或WebContent組織的。如果是Maven工程結(jié)構(gòu)固定為src/main/java放Servlet和工具類src/main/webapp放JSP、CSS、JS和WEB-INF/web.xml。如果是WebContent結(jié)構(gòu)Java文件在src下JSP在WebContent下兩個(gè)結(jié)構(gòu)本質(zhì)上一樣。library-system/ ├── src/main/java/com/library/ │ ├── dao/ # 數(shù)據(jù)訪問層全是JDBC操作 │ ├── model/ # 圖書、讀者、借閱記錄的實(shí)體類 │ ├── servlet/ # 控制器接收HTTP請求并跳轉(zhuǎn) │ └── util/ # DBUtil數(shù)據(jù)庫連接工具 ├── src/main/webapp/ │ ├── WEB-INF/web.xml │ ├── css/ js/ │ ├── login.jsp │ └── book_list.jsp └── src/main/resources/db.propertiesdb.properties放數(shù)據(jù)庫連接配置這是整個(gè)項(xiàng)目最容易改錯(cuò)的地方。我把這里單獨(dú)擰出來說因?yàn)楹芏嗤瑢W(xué)直接把這個(gè)文件里的URL寫錯(cuò)就報(bào)CommunicationsException。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/library_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernamelib_user jdbc.passwordLib2024 jdbc.maxPoolSize20 jdbc.initPoolSize5JDBC連接不建議每次都DriverManager.getConnection因?yàn)轭l繁創(chuàng)建連接非常慢。簡單做法是寫一個(gè)DBUtil類用靜態(tài)代碼塊讀取配置文件再用連接池管理。期末項(xiàng)目用DBCP或C3P0都行配置里maxPoolSize控制在20以內(nèi)就夠了不要抄生產(chǎn)環(huán)境的幾百那會讓Tomcat啟動變慢。serverTimezoneAsia/Shanghai是MySQL 8的強(qiáng)制要求不寫會直接報(bào)時(shí)區(qū)錯(cuò)誤。3. 數(shù)據(jù)庫設(shè)計(jì)與事務(wù)圖書、讀者、借閱三張表怎么撐起整套系統(tǒng)3.1 三張核心表的DDL字段類型、默認(rèn)值與索引圖書館系統(tǒng)的數(shù)據(jù)模型談不上復(fù)雜但期末答辯時(shí)老師最喜歡問的就是“為什么這樣設(shè)計(jì)”。圖書表、讀者表、借閱表三張是必備的管理員表視需求決定要不要。圖書表里book_id做主鍵stock字段記錄當(dāng)前可借數(shù)量total_stock記錄總量這兩個(gè)字段分開是有講究的——還書時(shí)要恢復(fù)stock但total_stock保持歷史總量不被動。讀者表里status默認(rèn)值為00表示正常1表示禁借這比刪除讀者更穩(wěn)妥因?yàn)闅v史借閱記錄不能因?yàn)樽x者被刪就斷了外鍵關(guān)聯(lián)。CREATE TABLE book ( book_id INT AUTO_INCREMENT PRIMARY KEY, isbn VARCHAR(20) NOT NULL UNIQUE, title VARCHAR(100) NOT NULL, author VARCHAR(50) NOT NULL, category VARCHAR(30), publisher VARCHAR(60), publish_date DATE, stock INT NOT NULL DEFAULT 0, total_stock INT NOT NULL DEFAULT 0, INDEX idx_book_title (title), INDEX idx_book_category (category) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE reader ( reader_id INT AUTO_INCREMENT PRIMARY KEY, reader_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, phone VARCHAR(20), status TINYINT NOT NULL DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, INDEX idx_reader_name (name) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE borrow ( borrow_id INT AUTO_INCREMENT PRIMARY KEY, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_date DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, due_date DATETIME NOT NULL, return_date DATETIME DEFAULT NULL, status TINYINT NOT NULL DEFAULT 0, CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book(book_id), CONSTRAINT fk_borrow_reader FOREIGN KEY (reader_id) REFERENCES reader(reader_id), INDEX idx_borrow_status (status), INDEX idx_borrow_due (due_date) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;三張表的字段設(shè)計(jì)是答辯的重點(diǎn)。book表的isbn加了UNIQUE約束防止同一本書錄入兩次。borrow表用status表示借閱狀態(tài)0表示借出未還1表示已歸還2表示逾期未還——逾期狀態(tài)通常是定時(shí)任務(wù)或還書時(shí)判斷。外鍵在期末項(xiàng)目里必須加老師用Navicat看表關(guān)系圖時(shí)外鍵連線能直接證明你理解了數(shù)據(jù)關(guān)聯(lián)。有人會圖省事用MyBatis-Plus根據(jù)實(shí)體類生成建表SQL但手寫DDL在答辯時(shí)被問字段含義時(shí)能答得有條理建議你親自寫一遍這些建表語句。3.2 借書與還書事務(wù)為什么必須用Connection控制借書操作不是一條INSERT就完事。它要做兩件事在borrow表插入借閱記錄同時(shí)把book表的stock減1。這兩件事必須放在同一個(gè)事務(wù)里否則會出現(xiàn)“記錄插了但庫存沒減”或“庫存減了卻沒記錄”的臟數(shù)據(jù)。期末項(xiàng)目很多人忽略這一點(diǎn)直接用兩個(gè)dao方法各執(zhí)行各的答辯演示時(shí)連點(diǎn)兩次借書庫存就變成負(fù)數(shù)了。public void borrowBook(int bookId, int readerId) { Connection conn null; PreparedStatement psInsert null; PreparedStatement psUpdate null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); String sqlInsert INSERT INTO borrow(book_id, reader_id, due_date) VALUES(?, ?, DATE_ADD(NOW(), INTERVAL 30 DAY)); psInsert conn.prepareStatement(sqlInsert); psInsert.setInt(1, bookId); psInsert.setInt(2, readerId); psInsert.executeUpdate(); String sqlUpdate UPDATE book SET stock stock - 1 WHERE book_id ? AND stock 0; psUpdate conn.prepareStatement(sqlUpdate); psUpdate.setInt(1, bookId); int rows psUpdate.executeUpdate(); if (rows 0) { conn.rollback(); throw new RuntimeException(庫存不足借閱失敗); } conn.commit(); } catch (SQLException e) { try { if (conn ! null) conn.rollback(); } catch (SQLException ex) {} e.printStackTrace(); } finally { DBUtil.close(conn, psInsert, psUpdate); } }這段代碼的要點(diǎn)全在setAutoCommit(false)和rollback()上。MySQL默認(rèn)autocommit為1每條SQL都自動提交手動關(guān)閉后INSERT和UPDATE變成一個(gè)原子操作任何一個(gè)失敗都能撤回。WHERE book_id ? AND stock 0這句是防止并發(fā)超借的關(guān)鍵——即使連續(xù)兩個(gè)人同時(shí)借同一本書也只能有一個(gè)走通因?yàn)榈诙€(gè)的stock 0條件在行鎖下不成立。這就是MySQL鎖分類里InnoDB行鎖的實(shí)際應(yīng)用比單純在Java代碼里判斷庫存數(shù)量可靠得多。期末答辯時(shí)把這個(gè)邏輯講清楚老師會認(rèn)為你理解了并發(fā)下的數(shù)據(jù)一致性。3.3 還書與逾期罰款存儲過程不是必須的還書操作跟借書對偶更新borrow表把return_date設(shè)為當(dāng)前時(shí)間、status設(shè)為1再把book表stock加1。這里有個(gè)邊界情況就是逾期。我的做法是還書時(shí)判斷due_date和NOW()的大小如果還書時(shí)間大于應(yīng)還時(shí)間就把borrow表里加一個(gè)overdue_days字段記錄逾期天數(shù)罰款金額在Java代碼計(jì)算而不是在SQL里算。常見做法是寫一個(gè)MySQL存儲過程處理整個(gè)還書流程但我不會這么干——期末作業(yè)寫存儲過程答辯時(shí)老師會抓住不放問存儲過程和普通SQL的性能差異、調(diào)試手段反而容易翻車。MySQL存儲過程更適合那種固定流程、多步操作、反復(fù)調(diào)用的場景但JavaServlet項(xiàng)目里事務(wù)控制已經(jīng)在代碼層做了存儲過程的價(jià)值就沒那么大。你要是在課程里學(xué)了存儲過程想展示一下可以寫一個(gè)簡單的count_overdue()返回當(dāng)前逾期記錄數(shù)掛在管理員統(tǒng)計(jì)頁面上不至于說不清楚。4. 登錄、CRUD與分頁從Servlet到JDBC的完整請求鏈4.1 登錄會話與過濾器每個(gè)頁面都要防未授權(quán)訪問圖書管理里登錄模塊是第一個(gè)要寫的功能也是期末答辯進(jìn)場必演示的功能。流程是JSP頁面提交用戶名密碼到LoginServletServlet查管理員表驗(yàn)證通過就request.getSession().setAttribute(admin, adminUser)寫入會話驗(yàn)證失敗就重定向回登錄頁并帶一個(gè)error參數(shù)。這類系統(tǒng)里密碼存儲建議用MD5加鹽至少比明文強(qiáng)一個(gè)檔次答辯時(shí)被問安全問題也能給出合理回復(fù)。但光登錄成功還不夠如果不攔截未登錄訪問別人直接輸入book_list.jsp的地址就能繞過登錄進(jìn)入系統(tǒng)這道防線必須補(bǔ)上。Servlet 3.0以后支持注解方式配置過濾器不用動web.xml代碼量也小。WebFilter(/*) public class AuthFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; String uri req.getRequestURI(); if (uri.endsWith(login.jsp) || uri.contains(LoginServlet) || uri.contains(/css/) || uri.contains(/js/)) { chain.doFilter(request, response); return; } Object admin req.getSession().getAttribute(admin); if (admin null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }過濾器的邏輯很簡單靜態(tài)資源和登錄相關(guān)的路徑放行其余路徑全部檢查Session里有沒有admin對象。這個(gè)過濾器寫在com.library.filter包里是典型的一勞永逸組件。注意WebFilter(/*)攔截的是所有請求所以放行條件必須把JSP、Servlet、靜態(tài)資源分清楚否則會陷入頁面無限重定向。用uri.contains()判斷路徑時(shí)要帶上前綴比如/css/不然xxxcssss.jsp這種路徑也會被誤放行。4.2 圖書增刪改查PreparedStatement防注入與參數(shù)校驗(yàn)圖書管理是管理員端的主界面包含列表展示、新增、修改、刪除四個(gè)操作分別對應(yīng)BookServlet里四個(gè)方法或用action參數(shù)區(qū)分。每一個(gè)操作都要走“接收參數(shù) → 構(gòu)建SQL → 執(zhí)行 → 回顯結(jié)果”這條線但新手最容易犯的錯(cuò)是在Servlet里拼接SQL字符串String title request.getParameter(title); String sql SELECT * FROM book WHERE title title ;這種做法在期末作業(yè)里能跑通但只要在搜索框輸入 OR 11就會把整個(gè)圖書表拉出來答辯演示時(shí)現(xiàn)場翻車非常難看。正確寫法是用PreparedStatement占位符讓JDBC驅(qū)動處理特殊字符。public ListBook searchBooks(String keyword) { String sql SELECT * FROM book WHERE title LIKE ? OR author LIKE ? ORDER BY book_id DESC; ListBook books new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ps.setString(2, % keyword %); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Book book new Book(); book.setBookId(rs.getInt(book_id)); book.setTitle(rs.getString(title)); book.setAuthor(rs.getString(author)); books.add(book); } } } catch (SQLException e) { e.printStackTrace(); } return books; }PreparedStatement的setString會把單引號轉(zhuǎn)義這是防SQL注入的最低門檻。搜索條件用LIKE ?配合%keyword%MySQL排序默認(rèn)按主鍵升序這里用ORDER BY book_id DESC讓新書顯示在最前面很符合圖書管理的展示習(xí)慣。還有一個(gè)容易忽略的點(diǎn)增刪改操作執(zhí)行完必須做重定向resp.sendRedirect(BookServlet?actionlist)如果用了forward轉(zhuǎn)發(fā)用戶按F5刷新頁面會重復(fù)提交表單造成重復(fù)插入數(shù)據(jù)。4.3 分頁查詢與狀態(tài)篩選LIMIT的offset該怎么算圖書列表頁數(shù)據(jù)一多不分頁就會被老師指出頁面性能問題。MySQL分頁用LIMIT offset, size但很多人會猛地忘了offset從0開始第二頁直接傳pageNum * pageSize導(dǎo)致每頁最后一兩條數(shù)據(jù)被跳過去或重復(fù)顯示。我一般用這個(gè)公式offset (currentPage - 1) * pageSize。public ListBook getBooksByPage(int currentPage, int pageSize) { int offset (currentPage - 1) * pageSize; String sql SELECT * FROM book ORDER BY book_id DESC LIMIT ?, ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, offset); ps.setInt(2, pageSize); try (ResultSet rs ps.executeQuery()) { // 遍歷結(jié)果集封裝Book對象 } } catch (SQLException e) { e.printStackTrace(); } return books; } public int getTotalCount() { String sql SELECT COUNT(*) FROM book; // 返回記錄總數(shù)用于計(jì)算總頁數(shù) }LIMIT后的兩個(gè)參數(shù)分別是offset和rowsLIMIT 0, 10取第1到10條LIMIT 10, 10取第11到20條。前端頁面用一個(gè)pageNav.jsp公共組件接收currentPage和totalPages渲染上一頁/下一頁按鈕。totalPages通過(totalCount pageSize - 1) / pageSize計(jì)算這種寫法比浮點(diǎn)數(shù)除法然后向上取整更穩(wěn)不會出現(xiàn)10條記錄、pageSize為3時(shí)算出的頁數(shù)偏小的問題。如果每頁想顯示借閱次數(shù)最多的圖書來豐富頁面MySQL排序換成ORDER BY borrow_count DESC但需要在book表加一個(gè)冗余字段borrow_count每次借書成功時(shí)順便把它加1比每次實(shí)時(shí)COUNT(*)關(guān)聯(lián)查詢快得多。5. 常見問題與避坑排查為什么在別人電腦能跑到你這就啟動失敗5.1 Tomcat啟動即報(bào)ClassNotFoundException驅(qū)動JAR到底放哪個(gè)目錄現(xiàn)象項(xiàng)目部署到Tomcat啟動時(shí)立刻報(bào)ClassNotFoundException: com.mysql.cj.jdbc.Driver或com.mysql.jdbc.Driver但I(xiàn)DE里明明引用了mysql-connector-java包。原因驅(qū)動JAR的發(fā)布范圍不對。在IDEA里如果把JAR加到Project Structure的Libraries里編譯期能找到類但運(yùn)行時(shí)Web應(yīng)用是加載WEB-INF/lib下的JAR。scope為provided的依賴也不會被復(fù)制到lib目錄。解決把JAR物理復(fù)制到src/main/webapp/WEB-INF/lib/下或者在Maven的pom.xml中確認(rèn)scope不是provided。檢查方法很簡單展開部署目錄看看WEB-INF/lib里有沒有那個(gè)jar包沒有就手工復(fù)制。順帶確認(rèn)驅(qū)動類名和你MySQL版本匹配MySQL 5.7用com.mysql.jdbc.DriverMySQL 8.0用com.mysql.cj.jdbc.Driver寫錯(cuò)一個(gè)字都不可能注冊成功。5.2 Communications link failureMySQL 8的認(rèn)證插件和時(shí)區(qū)兩個(gè)坑疊加現(xiàn)象連接串寫對了、用戶密碼也對但報(bào)Communications link failure后面跟一串Server connection failure或Public Key Retrieval is not allowed。原因MySQL 8.0默認(rèn)用caching_sha2_password認(rèn)證插件而一些老版本JDBC驅(qū)動只支持mysql_native_password另外連接串缺了serverTimezone參數(shù)也會在握手階段失敗。解決驅(qū)動換成8.0.x連接串路徑補(bǔ)上useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8。如果已經(jīng)在生產(chǎn)環(huán)境不好換驅(qū)動也可以執(zhí)行ALTER USER lib_userlocalhost IDENTIFIED WITH mysql_native_password BY yourpass;把認(rèn)證插件改回去。我一般兩條路同時(shí)走驅(qū)動升級到位認(rèn)證插件也改成native兩邊兼容最少折騰。allowPublicKeyRetrievaltrue這個(gè)參數(shù)在首次連接時(shí)也需要尤其當(dāng)你用root賬號通過TCP遠(yuǎn)程連MySQL時(shí)建議在連接串里一并加上。5.3 中文亂碼三個(gè)層級的編碼必須一致現(xiàn)象JSP頁面顯示“圖書名稱”變成“???1|????”或者寫進(jìn)數(shù)據(jù)庫的漢字全部變成問號。原因三個(gè)層級的編碼不一致——JSP文件本身的編碼、服務(wù)器響應(yīng)編碼、數(shù)據(jù)庫連接參數(shù)編碼和表字段編碼。最常見的是JSP文件用了GBK但連接串characterEncodingutf8再往utf8mb4表里寫必然亂碼。解決統(tǒng)一成UTF-8。JSP文件頭寫% page languagejava contentTypetext/html; charsetUTF-8 pageEncodingUTF-8%Servlet里request.setCharacterEncoding(UTF-8)必須在讀取第一個(gè)參數(shù)之前調(diào)用放在doGet/doPost第一行MySQL連接串帶characterEncodingutf8表的DEFAULT CHARSETutf8mb4。還需要在Tomcat的server.xml給Connector加URIEncodingUTF-8處理GET請求參數(shù)的中文亂碼。這四個(gè)地方全對齊后再測試就不會出現(xiàn)玄學(xué)亂碼了。5.4 端口被占用與虛擬機(jī)內(nèi)存不足Tomcat起不來的兩個(gè)隱性原因現(xiàn)象Tomcat啟動時(shí)IDE控制臺報(bào)Port 8080 required by Tomcat v8.5 Server at localhost is already in use或者啟動一半就崩last line是OutOfMemoryError。原因8080被其他進(jìn)程占了常見是之前調(diào)試時(shí)的殘留進(jìn)程也可能被一些開發(fā)工具占用。內(nèi)存不足則是因?yàn)镴SP編譯和IDE同時(shí)吃內(nèi)存默認(rèn)的JVM堆不夠。解決Windows命令行執(zhí)行netstat -ano | findstr 8080查到占用進(jìn)程的PID再用taskkill /PID pid /F結(jié)束它或換一個(gè)端口在server.xml里把Connector port8080改成8081然后所有訪問URL同步改。內(nèi)存問題在Catalina的setenv.sh或IDEA的VM options里設(shè)-Xms256m -Xmx512m期末項(xiàng)目這個(gè)量級足夠了不要盲目調(diào)大因?yàn)槲锢韮?nèi)存不夠時(shí)設(shè)大反而報(bào)錯(cuò)。改完端口啟動成功后用瀏覽器訪問http://localhost:8080/項(xiàng)目名驗(yàn)證能打開登錄頁就說明Web容器這層通了。5.5 連接未關(guān)閉導(dǎo)致連接池耗盡finally里忘了close會怎樣現(xiàn)象系統(tǒng)用著用著突然變慢接著報(bào)Too many connections或Connection is not available, request timed out重啟Tomcat又能用幾分鐘然后繼續(xù)變慢。原因DBUtil.getConnection()每調(diào)用一次連接池就借出一個(gè)連接代碼里ResultSet或PreparedStatement沒有在finally塊中關(guān)閉連接不會自動歸還。DBCP連接池默認(rèn)最大連接數(shù)20借出一個(gè)少一個(gè)泄漏到20個(gè)就徹底卡住。解決所有數(shù)據(jù)庫操作都按“try-with-resources或finally關(guān)閉”的固定寫法。我強(qiáng)烈建議用Java 7以后的try-with-resources它自動處理關(guān)閉邏輯少寫很多重復(fù)代碼。public ListBook listBooks() { String sql SELECT * FROM book ORDER BY book_id DESC; ListBook books new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { // 封裝Book對象寫入books } } catch (SQLException e) { e.printStackTrace(); } return books; }try (Connection conn ...)會在try塊結(jié)束自動調(diào)用closePreparedStatement和ResultSet同樣被自動關(guān)閉。注意關(guān)閉順序問題——Connection、Statement、ResultSet誰先關(guān)try-with-resources是按聲明逆序關(guān)閉先關(guān)ResultSet再關(guān)Statement最后關(guān)Connection正好符合要求。手寫finally時(shí)最容易踩的反而是反著關(guān)先關(guān)Connection導(dǎo)致后續(xù)關(guān)閉Statement拋異常被吞掉后很難排查。你可以在DBUtil里加一個(gè)計(jì)數(shù)器靜態(tài)變量每次getConnection加一、每次close減一跑幾個(gè)操作后打出數(shù)值驗(yàn)證是否有泄漏。6. 文檔說明與答辯準(zhǔn)備一份能加分的期末作業(yè)怎么收尾標(biāo)題末尾寫著“文檔說明”這意味著交付物里除了能跑的代碼還有配套文檔。期末答辯老師看文檔第一看格式是否完整第二看重點(diǎn)有沒有講透。我在交付這類項(xiàng)目時(shí)文檔通常包含四件套需求說明、數(shù)據(jù)庫設(shè)計(jì)說明、系統(tǒng)操作手冊、核心代碼講解。數(shù)據(jù)庫設(shè)計(jì)說明要放E-R圖和三張表的字段說明表字段說明表里列出字段名、類型、是否為空、默認(rèn)值、注釋這比貼一段DDL直觀得多老師掃一眼就知道你設(shè)計(jì)表的思路。答辯演示有一條技巧是我的血淚經(jīng)驗(yàn)不要從登錄頁開始點(diǎn)先打開數(shù)據(jù)庫客戶端展示三張表和它們的關(guān)聯(lián)關(guān)系再打開項(xiàng)目跑登錄然后演示借書流程。這樣做的目的是讓老師一開始就看到“數(shù)據(jù)模型”這個(gè)設(shè)計(jì)核心而不是花三分鐘看你輸入賬號密碼。借書時(shí)故意把圖書庫存加到很大的書里連續(xù)借兩本展示stock遞減還書時(shí)演示逾期判斷。功能演示完再翻到文檔里的E-R圖把外鍵關(guān)系和事務(wù)邊界說一遍整個(gè)過程控制在十分鐘內(nèi)。驗(yàn)證做完以后有一件事容易忽略——把MySQL連接信息從代碼里抽出去改用配置文件并在文檔里說明db.properties是唯一需要按環(huán)境修改的文件。老師把項(xiàng)目拷回去自己跑的時(shí)候只需要改數(shù)據(jù)庫密碼就能運(yùn)行不需要翻遍Servlet找JDBC連接串這個(gè)細(xì)節(jié)直接關(guān)系到最后印象分。還要確認(rèn)Java文件里的注釋是中文且覆蓋關(guān)鍵方法不要讓代碼里殘留一堆TODO和無注釋的詭異邏輯。我每次帶學(xué)生交付這套項(xiàng)目都會提醒一個(gè)收尾習(xí)慣把SQL建表腳本放在項(xiàng)目的sql/目錄下文件名帶上日期和版本比如20240610_library_schema.sql。這看起來多了一步但老師讓你現(xiàn)場建庫或者你自己換機(jī)器演示時(shí)一句source sql/20240610_library_schema.sql就能恢復(fù)整個(gè)環(huán)境不用手工一條條執(zhí)行。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取