從小到大如果你想碰數(shù)據(jù)庫(kù)JDBC幾乎是繞不開(kāi)的第一道門(mén)。網(wǎng)上有很多大而全的視頻教程但是真正自己寫(xiě)下來(lái)的東西少得可憐。今天要聊的這個(gè)“JDBC MySQL 圖書(shū)館迷你圖書(shū)管理系統(tǒng)”是我個(gè)人非常推薦拿來(lái)當(dāng)練習(xí)的入門(mén)小項(xiàng)目沒(méi)有網(wǎng)頁(yè)沒(méi)有框架就一個(gè)控制臺(tái)能查詢、新增、修改、刪除、退出。把它手敲一遍你會(huì)比看十期教程都明白什么叫做“數(shù)據(jù)庫(kù)應(yīng)用”。這個(gè)項(xiàng)目到底解決什么問(wèn)題說(shuō)白了它就是讓你把腦子里零散的 JDBC 知識(shí)點(diǎn)串成一條完整的線怎么連數(shù)據(jù)庫(kù)、怎么寫(xiě) SQL、怎么處理結(jié)果集、怎么關(guān)資源、怎么在控制臺(tái)里組織一套能跑起來(lái)的業(yè)務(wù)邏輯。適合正在學(xué) Java 基礎(chǔ)、剛接觸數(shù)據(jù)庫(kù)的同學(xué)也適合那些想復(fù)習(xí) JDBC 的老手——畢竟很多細(xì)節(jié)隔一段時(shí)間不看真的會(huì)忘。1. 這個(gè)“迷你”系統(tǒng)為什么值得手敲一遍1.1 控制臺(tái)應(yīng)用是學(xué)習(xí)階段的正確選擇很多同學(xué)一上來(lái)就想寫(xiě) Web 項(xiàng)目Spring Boot 一套基礎(chǔ)框架搭起來(lái)連接池配好MVC 分層一鋪然后就發(fā)現(xiàn)自己連最基礎(chǔ)的數(shù)據(jù)流都沒(méi)搞明白請(qǐng)求是怎么進(jìn)來(lái)的參數(shù)是怎么傳的SQL 是怎么發(fā)的結(jié)果又是怎么返回到界面上的?？蚣馨堰@些東西全都藏掉了出了問(wèn)題你根本不知道是框架的鍋還是自己的鍋。控制臺(tái)項(xiàng)目完全沒(méi)有這個(gè)問(wèn)題。沒(méi)有隱藏的封裝沒(méi)有自動(dòng)配置你寫(xiě)的每一行 Java 代碼都直接對(duì)應(yīng)最終發(fā)生的事。用戶輸入一個(gè)數(shù)字代碼就去執(zhí)行操作查出來(lái)的數(shù)據(jù)用 System.out.println 一行一行打出來(lái)。這種“所見(jiàn)即所得”的方式對(duì)建立底層認(rèn)知特別重要。等你有過(guò)幾次從 null 查到、從 SQLException 里看 stack trace 排查的經(jīng)歷再去碰框架會(huì)有完全不同的底氣。1.2 程序整體流程一個(gè)循環(huán)五個(gè)選項(xiàng)這個(gè)系統(tǒng)的骨架并不復(fù)雜核心就是一個(gè) while 循環(huán)加 switch 分支判斷。用戶在控制臺(tái)鍵入“1”到“5”程序分別走到查詢、新增、修改、刪除、對(duì)應(yīng)的處理邏輯然后重新回到菜單直到用戶輸入“5”退出。Scanner scanner new Scanner(System.in); while (true) { System.out.println( 迷你圖書(shū)館管理系統(tǒng) ); System.out.println(1. 查詢?nèi)繒?shū)籍); System.out.println(2. 新增書(shū)籍); System.out.println(3. 修改書(shū)籍); System.out.println(4. 刪除書(shū)籍); System.out.println(5. 退出系統(tǒng)); System.out.print(請(qǐng)選擇操作); String option scanner.nextLine(); switch (option) { case 1 - listAllBooks(); case 2 - addBook(scanner); case 3 - updateBook(scanner); case 4 - deleteBook(scanner); case 5 - { System.out.println(感謝使用再見(jiàn)。); System.exit(0); } default - System.out.println(輸入有誤請(qǐng)選擇 1 - 5 之間的數(shù)字。); } }你可能會(huì)問(wèn)為什么不直接用 int 接收數(shù)字然后用 switch 匹配因?yàn)橛脩粽娴臅?huì)輸入各種奇怪的東西比如“abc”“空格”之類(lèi)。用 nextLine() 接收字符串可以更好地容錯(cuò)。我見(jiàn)過(guò)很多人在這上面踩坑用 nextInt() 接收選項(xiàng)結(jié)果下次再用 nextLine() 讀書(shū)籍標(biāo)題的時(shí)候就會(huì)吞掉那個(gè)換行符導(dǎo)致輸入直接錯(cuò)亂。所以從一開(kāi)始就統(tǒng)一用 nextLine() 讀字符串是最省心的做法。1.3 代碼分層不搞架構(gòu)但要有一點(diǎn)邊界感練習(xí)項(xiàng)目不需要整高深的分層架構(gòu)但建議還是把代碼拆成幾個(gè)類(lèi)而不是全部懟進(jìn)一個(gè) main 方法里。我自己寫(xiě)的時(shí)候習(xí)慣至少分成三層實(shí)體類(lèi) Book對(duì)應(yīng)數(shù)據(jù)庫(kù)表的一行數(shù)據(jù)屬性就是表的字段數(shù)據(jù)訪問(wèn)類(lèi) BookDao里面封裝所有 JDBC 操作每個(gè)方法負(fù)責(zé)一條 SQL 該干的事主類(lèi) Main負(fù)責(zé)控制臺(tái)菜單和用戶交互。這樣拆的好處有兩個(gè)。第一main 方法里不會(huì)堆幾十行 JDBC 代碼看著清爽。第二當(dāng)你后面想擴(kuò)展功能比如加一個(gè)“按出版社查詢”的方法只需要在 BookDao 里加方法不會(huì)牽一發(fā)動(dòng)全身。實(shí)體類(lèi)的寫(xiě)法很簡(jiǎn)單就是私有屬性加 getter/setter。有些人覺(jué)得這種類(lèi)沒(méi)有技術(shù)含量但它其實(shí)是后面所有框架里實(shí)體映射的基礎(chǔ)老老實(shí)實(shí)寫(xiě)一遍沒(méi)有壞處。2. 動(dòng)手前準(zhǔn)備環(huán)境、建庫(kù)建表與命名習(xí)慣2.1 版本搭配與驅(qū)動(dòng)下載別在第一步卡住環(huán)境這塊其實(shí)沒(méi)什么玄學(xué)。JDK 用 8 以上就好我現(xiàn)在用得比較多的是 JDK 11往下兼容基本沒(méi)什么問(wèn)題。MySQL 用 5.7 或 8.0 都可以這個(gè)項(xiàng)目用到的功能非?；A(chǔ)不會(huì)觸及版本間差異太大的特性。真正要注意的是 JDBC 驅(qū)動(dòng) jar 包的版本。MySQL 8.0 之后驅(qū)動(dòng)類(lèi)名變成了com.mysql.cj.jdbc.Driver而老版本是com.mysql.jdbc.Driver。你如果拿一個(gè)舊的 5.x 驅(qū)動(dòng) jar 去連 MySQL 8很可能會(huì)報(bào)各種奇怪的兼容錯(cuò)誤。我個(gè)人建議直接引入較新版本的驅(qū)動(dòng) jar下載之后把它放到項(xiàng)目的 lib 目錄然后在 IDE 里 Add as Library。這一步看似簡(jiǎn)單但 90% 的初學(xué)者卡住都是因?yàn)檫@個(gè) jar 沒(méi)放進(jìn)去或者放進(jìn)去沒(méi)生效。判斷方法也很簡(jiǎn)單代碼里用到Class.forName(com.mysql.cj.jdbc.Driver)如果運(yùn)行時(shí)報(bào)了ClassNotFoundException那就說(shuō)明驅(qū)動(dòng)類(lèi)根本沒(méi)被加載進(jìn)來(lái)先檢查 jar 是否真的被依賴上再去查別的問(wèn)題。2.2 建庫(kù)建表字段類(lèi)型不要亂選接下來(lái)是數(shù)據(jù)庫(kù)設(shè)計(jì)。這個(gè)小系統(tǒng)的表結(jié)構(gòu)非常容易CREATE DATABASE library_db DEFAULT CHARACTER SET utf8mb4; USE library_db; CREATE TABLE book ( id INT AUTO_INCREMENT PRIMARY KEY COMMENT 圖書(shū)編號(hào), title VARCHAR(200) NOT NULL COMMENT 書(shū)名, author VARCHAR(100) NOT NULL COMMENT 作者, price DECIMAL(8, 2) DEFAULT 0.00 COMMENT 價(jià)格, publisher VARCHAR(100) COMMENT 出版社, publish_date DATE COMMENT 出版日期 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;這里有幾個(gè)細(xì)節(jié)值得拿出來(lái)說(shuō)。第一價(jià)格字段別用 FLOAT 或 DOUBLE。二進(jìn)制浮點(diǎn)數(shù)存十進(jìn)制小數(shù)會(huì)產(chǎn)生精度問(wèn)題比如存 39.9讀出來(lái)可能是 39.900000001。DBA 看到這種設(shè)計(jì)會(huì)皺眉做練習(xí)的時(shí)候就應(yīng)該養(yǎng)成用 DECIMAL 的習(xí)慣。第二日期字段用 DATE而不是 VARCHAR。有些教程為了省事把日期當(dāng)字符串存程序里面也能跑但你后面一旦要做日期范圍查詢就會(huì)非常痛苦字面比較和日期比較的邏輯完全不同。第三主鍵用自增 INT 就好。別去搞那種“業(yè)務(wù)編號(hào)”比如什么“ISBN”ISBN 本身有數(shù)據(jù)錄入錯(cuò)誤的風(fēng)險(xiǎn)不適合當(dāng)主鍵。小型練習(xí)項(xiàng)目里代理主鍵就是最省事的解。2.3 字符集與存儲(chǔ)引擎這兩個(gè)坑你在代碼里感受不到在 MySQL 里utf8mb4和utf8的差別很多人一直沒(méi)搞清楚。MySQL 的utf8最多只能存 3 字節(jié)編碼的字符這意味著像 emoji 這類(lèi) 4 字節(jié)字符它會(huì)報(bào)錯(cuò)或者存成亂碼。utf8mb4是真正兼容完整 Unicode 的字符集。書(shū)名里如果出現(xiàn)特殊符號(hào)用utf8mb4就不會(huì)出幺蛾子。存儲(chǔ)引擎建議顯式寫(xiě)成 InnoDB。MySQL 5.5 以后默認(rèn)就是 InnoDB但作為練習(xí)最好知道為什么要選它只有 InnoDB 支持事務(wù)和外鍵。本項(xiàng)目里用到的事務(wù)不多但你在建表的時(shí)候把它當(dāng)成默認(rèn)標(biāo)準(zhǔn)后續(xù)做轉(zhuǎn)賬練習(xí)、訂單練習(xí)就會(huì)順手很多。建表之后順手插幾條測(cè)試數(shù)據(jù)方便后面調(diào)試查詢功能INSERT INTO book (title, author, price, publisher, publish_date) VALUES (Java核心技術(shù), 某作者, 139.00, 某出版社, 2022-01-15), (代碼整潔之道, 某作者, 59.00, 某出版社, 2020-06-30), (數(shù)據(jù)庫(kù)系統(tǒng)概論, 某作者, 49.50, 某出版社, 2019-03-20);3. JDBC 連接新手翻車(chē)總數(shù)最多的一道門(mén)檻3.1 用 Properties 文件管理連接參數(shù)別在代碼里寫(xiě)死密碼剛開(kāi)始練習(xí)的時(shí)候很多人會(huì)把連接參數(shù)直接寫(xiě)在 Java 代碼里圖省事String url jdbc:mysql://localhost:3306/library_db?useSSLfalseserverTimezoneAsia/Shanghai; String username root; String password 123456;這樣寫(xiě)不是不能跑但有一個(gè)非?，F(xiàn)實(shí)的壞處改數(shù)據(jù)庫(kù)密碼、換庫(kù)名的時(shí)候你得跑回代碼里改改完還要重新編譯。這還算小事更麻煩的是代碼一旦提交到團(tuán)隊(duì)倉(cāng)庫(kù)等于把數(shù)據(jù)庫(kù)密碼暴露給所有人。從練習(xí)第一天開(kāi)始養(yǎng)成好習(xí)慣把連接信息放到j(luò)dbc.properties文件里drivercom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/library_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 usernameroot password123456在 Java 里用Properties類(lèi)加載Properties props new Properties(); try (InputStream in DBUtil.class.getClassLoader().getResourceAsStream(jdbc.properties)) { props.load(in); }這樣數(shù)據(jù)庫(kù)配置和代碼就完全分開(kāi)了。以后不管換環(huán)境還是調(diào)參數(shù)都只需要改一個(gè)配置文件比在代碼里找連接字符串舒服得多。3.2 連接參數(shù)里那幾段神秘字符串逐個(gè)解釋URL 里那串useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8看起來(lái)很勸退其實(shí)每一段都有原因。useSSLfalse本機(jī)調(diào)試階段根本不需要加密加上等于告訴驅(qū)動(dòng)不用做證書(shū)校驗(yàn)省去一堆握手時(shí)間。生產(chǎn)環(huán)境再考慮開(kāi) SSL那又是另一套話題。serverTimezoneAsia/ShanghaiMySQL 8 驅(qū)動(dòng)要求明確指定時(shí)區(qū)否則會(huì)報(bào)一個(gè)關(guān)于 CST 時(shí)區(qū)的歧義異常。不管你的機(jī)器在哪寫(xiě)明確時(shí)區(qū)是最穩(wěn)妥的。characterEncodingutf8這個(gè)要和建表時(shí)的utf8mb4區(qū)分開(kāi)。它管的是客戶端和服務(wù)器之間傳輸字符的編碼方式如果不加中文寫(xiě)入后很容易變成問(wèn)號(hào)。3.3 連接資源抓住 try-with-resources 這個(gè)救命語(yǔ)法JDBC 最容易被忽視但又最致命的問(wèn)題就是資源泄漏。每個(gè)操作都要拿到 Connection用完如果不關(guān)數(shù)據(jù)庫(kù)連接池里的連接就會(huì)被耗盡系統(tǒng)最終表現(xiàn)為“越來(lái)越慢然后直接掛掉”。所以從寫(xiě)第一版代碼開(kāi)始就一定要用 try-with-resources 語(yǔ)法。它會(huì)在 try 代碼塊結(jié)束時(shí)自動(dòng)關(guān)閉所有實(shí)現(xiàn)了AutoCloseable的資源。public ListBook findAll() { String sql SELECT id, title, author, price, publisher, publish_date FROM book; ListBook books new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { Book book new Book(); book.setId(rs.getInt(id)); book.setTitle(rs.getString(title)); book.setAuthor(rs.getString(author)); book.setPrice(rs.getBigDecimal(price)); book.setPublisher(rs.getString(publisher)); book.setPublishDate(rs.getDate(publish_date)); books.add(book); } } catch (SQLException e) { e.printStackTrace(); } return books; }你可能會(huì)想既然 try-with-resources 這么方便是不是完全不用手動(dòng)寫(xiě) close 了其實(shí)不是如果你用一個(gè)Connection對(duì)象執(zhí)行多個(gè)操作比如用同一個(gè)連接先查再改那你不能把連接寫(xiě)在方法內(nèi)部的 try 里否則一個(gè)方法結(jié)束連接就關(guān)了。對(duì)于這個(gè)迷你系統(tǒng)每次操作獨(dú)立開(kāi)一個(gè)連接用完即關(guān)是最清醒簡(jiǎn)單的模型。3.4 每次操作都連接一次會(huì)不會(huì)太浪費(fèi)會(huì)有一點(diǎn)浪費(fèi)但這是練習(xí)項(xiàng)目?jī)?yōu)先級(jí)不是性能而是結(jié)構(gòu)清晰。每次操作都新建連接意味著每次操作都是獨(dú)立的、可預(yù)測(cè)的不會(huì)出現(xiàn)一個(gè)連接狀態(tài)影響另一個(gè)操作的情景。真到性能有要求的時(shí)候再去引入連接池比如 HikariCP。連接池的原理很好理解預(yù)先創(chuàng)建一批連接放在池子里程序要連接時(shí)從池子里拿用完放回去而不是真的斷開(kāi)。你在這個(gè)練習(xí)項(xiàng)目里理解了 Connection 的生命周期再去看連接池的配置參數(shù)就完全不會(huì)懵了。4. 四個(gè)核心功能的一次性實(shí)現(xiàn)與常遇易錯(cuò)點(diǎn)4.1 查詢先寫(xiě)出不帶條件的再寫(xiě)模糊查詢查詢功能是四個(gè)功能里最直接的但依然有值得注意的地方。第一步先實(shí)現(xiàn)“查詢?nèi)俊本褪巧厦娲a里那段跑起來(lái)能在控制臺(tái)看到表格里已有的數(shù)據(jù)。第二步可以在菜單里加一個(gè)“按書(shū)名模糊查詢”的選項(xiàng)。這里有一個(gè)很重要的知識(shí)點(diǎn)為什么用PreparedStatement而不是Statement。public ListBook findByTitle(String keyword) { String sql SELECT id, title, author, price, publisher, publish_date FROM book WHERE title LIKE ?; ListBook books new ArrayList(); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Book book new Book(); book.setId(rs.getInt(id)); book.setTitle(rs.getString(title)); book.setAuthor(rs.getString(author)); book.setPrice(rs.getBigDecimal(price)); book.setPublisher(rs.getString(publisher)); book.setPublishDate(rs.getDate(publish_date)); books.add(book); } } } catch (SQLException e) { e.printStackTrace(); } return books; }PreparedStatement最大的好處是用占位符?先把 SQL 結(jié)構(gòu)定下來(lái)用戶輸入的內(nèi)容只能作為參數(shù)傳進(jìn)去。如果你圖省事直接拼接字符串String sql SELECT * FROM book WHERE title LIKE % keyword %;這時(shí)候用戶如果輸入一個(gè)單引號(hào)SQL 語(yǔ)句就變了這就是傳說(shuō)中的 SQL 注入。別覺(jué)得練習(xí)項(xiàng)目不用考慮安全問(wèn)題養(yǎng)成正確的習(xí)慣比什么都重要寫(xiě) SQL 就用占位符永遠(yuǎn)不要在 SQL 字符串里直接拼接用戶輸入。4.2 新增別只寫(xiě) INSERT帶上返回主鍵新增功能看起來(lái)就是往表里插入一行public int insert(Book book) { String sql INSERT INTO book (title, author, price, publisher, publish_date) VALUES (?, ?, ?, ?, ?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)) { ps.setString(1, book.getTitle()); ps.setString(2, book.getAuthor()); ps.setBigDecimal(3, book.getPrice()); ps.setString(4, book.getPublisher()); // setDate 需要 java.sql.Date這里做個(gè)轉(zhuǎn)換 if (book.getPublishDate() ! null) { ps.setDate(5, new java.sql.Date(book.getPublishDate().getTime())); } else { ps.setDate(5, null); } int rows ps.executeUpdate(); try (ResultSet keys ps.getGeneratedKeys()) { if (keys.next()) { int id keys.getInt(1); book.setId(id); System.out.println(新增成功生成的主鍵 ID id); } } return rows; } catch (SQLException e) { e.printStackTrace(); return 0; } }這里有個(gè)很多人不會(huì)在小項(xiàng)目里注意的點(diǎn)prepareStatement(sql)和prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)的區(qū)別。默認(rèn)情況下PreparedStatement 執(zhí)行完 INSERT 不會(huì)拿回自增主鍵如果你后面需要這個(gè)新記錄的 id 去操作關(guān)聯(lián)表比如插入“圖書(shū)借閱記錄”主鍵就非常有用。所以養(yǎng)成一個(gè)習(xí)慣新增操作盡量考慮是否需要返回主鍵。插入操作還要注意 NULL 的處理。用戶在控制臺(tái)可能把出版日期留空了那么你就不能強(qiáng)制調(diào)用ps.setDate(5, date)而沒(méi)有 null 判斷。JDBC 規(guī)定如果你傳入 null必須顯式調(diào)用setDate(5, null)直接傳 Java null 進(jìn)去有時(shí)候會(huì)拋異常。4.3 修改注意“只更新用戶填了的那部分”要怎么做修改功能比新增稍微復(fù)雜一點(diǎn)點(diǎn)因?yàn)樗媾R一個(gè)選擇是把所有字段都更新一遍還是只更新用戶填寫(xiě)的字段。最省事的方案是讓用戶把 id 和所有字段都重輸一遍然后整行更新public int update(Book book) { String sql UPDATE book SET title ?, author ?, price ?, publisher ?, publish_date ? WHERE id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, book.getTitle()); ps.setString(2, book.getAuthor()); ps.setBigDecimal(3, book.getPrice()); ps.setString(4, book.getPublisher()); if (book.getPublishDate() ! null) { ps.setDate(5, new java.sql.Date(book.getPublishDate().getTime())); } else { ps.setDate(5, null); } ps.setInt(6, book.getId()); return ps.executeUpdate(); } catch (SQLException e) { e.printStackTrace(); return 0; } }另一種方案是“動(dòng)態(tài) SQL”只更新用戶傳入的非空字段。但是用純 JDBC 寫(xiě)動(dòng)態(tài) SQL 非常啰嗦你需要根據(jù)不同的情況拼接 SQL 語(yǔ)句和參數(shù)。初學(xué)者很容易在這里寫(xiě)出字符串拼接而且容易漏掉逗號(hào)。所以對(duì)于這個(gè)迷你項(xiàng)目我建議就選整行更新的方案邏輯清楚、代碼短小。等以后學(xué)了 MyBatis會(huì)發(fā)現(xiàn)動(dòng)態(tài) SQL 是框架幫你解決的問(wèn)題而這里先把靜態(tài) SQL 寫(xiě)熟練更重要。4.4 刪除執(zhí)行成功不一定代表真的刪掉了東西刪除操作是四個(gè)操作里代碼最短的public int deleteById(int id) { String sql DELETE FROM book WHERE id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, id); return ps.executeUpdate(); } catch (SQLException e) { e.printStackTrace(); return 0; } }這里的關(guān)鍵是executeUpdate()返回的“受影響行數(shù)”是 0不代表執(zhí)行出錯(cuò)而是說(shuō)沒(méi)有匹配到對(duì)應(yīng)的記錄。所以在控制臺(tái)層面你應(yīng)該根據(jù)這個(gè)返回值給用戶不同的反饋int rows bookDao.deleteById(id); if (rows 0) { System.out.println(刪除成功); } else { System.out.println(沒(méi)有找到 ID 對(duì)應(yīng)的書(shū)籍請(qǐng)檢查后重試); }這種看似微不足道的反饋恰恰是系統(tǒng)可用性的體現(xiàn)。直接把“刪除成功”打印出去但實(shí)際什么都沒(méi)刪用戶會(huì)非常困惑。5. 實(shí)戰(zhàn)中的故障排查——這些坑我替你踩過(guò)了5.1 高頻報(bào)錯(cuò)速查表我把練習(xí)過(guò)程中最容易撞到的幾個(gè)問(wèn)題和排查方法整理成了一張表新手照著查就行報(bào)錯(cuò)信息通常原因排查順序ClassNotFoundException: com.mysql.cj.jdbc.Driver驅(qū)動(dòng) jar 沒(méi)引入或類(lèi)名寫(xiě)錯(cuò)檢查 lib 目錄檢查類(lèi)名是否帶 cjAccess denied for user rootlocalhost用戶名或密碼不對(duì)先用命令行工具連一遍確認(rèn)賬號(hào)Unknown database library_db數(shù)據(jù)庫(kù)沒(méi)建或庫(kù)名寫(xiě)錯(cuò)執(zhí)行SHOW DATABASES確認(rèn)Public Key Retrieval is not allowedMySQL 8 的認(rèn)證插件問(wèn)題URL 加allowPublicKeyRetrievaltrueConnection refusedMySQL 服務(wù)沒(méi)啟動(dòng)確認(rèn)服務(wù)狀態(tài)也確認(rèn)端口不是默認(rèn) 3306Column xxx cannot be null插入/更新時(shí)空值沒(méi)處理檢查代碼里是否傳了 null 給非空字段Data too long for column xxx字段長(zhǎng)度設(shè)小了調(diào)整 VARCHAR 長(zhǎng)度比如書(shū)名設(shè) 200 很合理控制臺(tái)中文亂碼成一堆????連接 URL 沒(méi)帶 characterEncoding 或表不是 utf8mb4兩頭排查連接參數(shù)和表字符集5.2 最容易忽略的根因IDE 與文件編碼中文亂碼還有一個(gè)特別隱蔽的來(lái)源就是你的 Java 源文件本身的編碼不對(duì)。IDE 默認(rèn)可能是 GBK但是編譯的時(shí)候又按 UTF-8 去解碼中文字符串直接變成亂碼。這個(gè)和數(shù)據(jù)庫(kù)一點(diǎn)關(guān)系都沒(méi)有。解決辦法很簡(jiǎn)單統(tǒng)一把整個(gè)項(xiàng)目的字符編碼設(shè)置為 UTF-8。在 IDE 里找到編碼設(shè)置把項(xiàng)目全局、文件的默認(rèn)編碼都改成 UTF-8。數(shù)據(jù)庫(kù)那邊確認(rèn)表是 utf8mb4連接 URL 帶 characterEncodingutf8這樣一套組合下來(lái)中文就非常穩(wěn)。5.3 排查問(wèn)題的標(biāo)準(zhǔn)流程5.3 排查問(wèn)題的標(biāo)準(zhǔn)流程遇到報(bào)錯(cuò)不要急著到處找答案我給你一套百試百靈的方法。先把異常信息完整讀一遍找到 “Caused by” 那一行那通常才是真正的病根。然后按下面順序檢查確認(rèn) MySQL 服務(wù)正常命令行執(zhí)行SELECT 1如果能查出結(jié)果說(shuō)明服務(wù)端沒(méi)問(wèn)題。確認(rèn)驅(qū)動(dòng) jar 確實(shí)在 classpath手動(dòng)在代碼里新建一個(gè)驅(qū)動(dòng)類(lèi)看看能不能編譯過(guò)。確認(rèn) SQL 語(yǔ)法本身沒(méi)問(wèn)題把我上面寫(xiě)的 SQL 直接復(fù)制到數(shù)據(jù)庫(kù)客戶端執(zhí)行比如用 Navicat 或命令行看看能不能跑。這一步能幫你把“SQL 錯(cuò)誤”和“Java 代碼錯(cuò)誤”快速區(qū)分開(kāi)。確認(rèn)參數(shù)綁定順序?占位符的順序和setXxx的順序必須一一對(duì)應(yīng)這個(gè)錯(cuò)誤很難肉眼發(fā)現(xiàn)建議一行一行對(duì)。這套流程走一遍可以說(shuō)覆蓋了 90% 的 JDBC 連接與執(zhí)行問(wèn)題。6. 做完之后下一步還能怎么練6.1 用“三層結(jié)構(gòu)”重寫(xiě)一遍如果你把第一個(gè)版本寫(xiě)出來(lái)并且跑通了別急著發(fā)朋友圈慶祝我先給你留一個(gè)作業(yè)把項(xiàng)目拆成 Service 層、DAO 層、實(shí)體層然后給 DAO 加一個(gè)接口。為什么要做接口因?yàn)槟悻F(xiàn)在的 BookDao 是直接實(shí)現(xiàn)代碼接口的意義在于你定義“這個(gè)系統(tǒng)需要哪些數(shù)據(jù)操作能力”然后在實(shí)現(xiàn)類(lèi)里做具體的事情。以后你想把 BookDao 的實(shí)現(xiàn)換成別的數(shù)據(jù)庫(kù)比如換成 PostgreSQL只需要再寫(xiě)一個(gè)新的實(shí)現(xiàn)類(lèi)控制臺(tái)主程序幾乎不用動(dòng)。這個(gè)練習(xí)不需要新的框架就是純 Java 就能做建一個(gè)接口BookDao里面放ListBook findAll()、int insert(Book book)、int update(Book book)、int deleteById(int id)這些方法然后讓BookDaoImpl去實(shí)現(xiàn)它。改完之后你會(huì)發(fā)現(xiàn)面向接口編程并沒(méi)有想象中那么玄學(xué)就是你平時(shí)做事的一種方式先定好規(guī)矩再談具體怎么做。6.2 試著加一個(gè)“借書(shū)還書(shū)”場(chǎng)景練練事務(wù)如果你覺(jué)得 CRUD 已經(jīng)手到擒來(lái)了可以在這個(gè)圖書(shū)館系統(tǒng)里加一個(gè)借書(shū)還書(shū)的功能專門(mén)用來(lái)練事務(wù)。場(chǎng)景是這樣的圖書(shū)館里每一本書(shū)有庫(kù)存數(shù)量用戶借一本書(shū)不僅要往“借閱記錄表”里插入一條記錄還要把書(shū)的庫(kù)存減一。這兩個(gè)操作必須同時(shí)成功或者同時(shí)失敗否則就會(huì)出現(xiàn)“記錄借出去了但庫(kù)存沒(méi)減”這種數(shù)據(jù)不一致。在 JDBC 里面事務(wù)代碼的正規(guī)寫(xiě)法是這樣的public boolean borrowBook(int bookId) { Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); String updateStock UPDATE book SET stock stock - 1 WHERE id ? AND stock 0; String insertRecord INSERT INTO borrow_record (book_id, borrow_time) VALUES (?, NOW()); try (PreparedStatement ps conn.prepareStatement(updateStock)) { ps.setInt(1, bookId); int rows ps.executeUpdate(); if (rows 0) { throw new SQLException(庫(kù)存不足或書(shū)籍不存在); } } try (PreparedStatement ps conn.prepareStatement(insertRecord)) { ps.setInt(1, bookId); ps.executeUpdate(); } conn.commit(); return true; } catch (SQLException e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } } e.printStackTrace(); return false; } finally { if (conn ! null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }注意這里我沒(méi)有用 try-with-resources 來(lái)管理 Connection因?yàn)槭聞?wù)要求連接在多個(gè)操作之間保持一致try-with-resources 放在外圍會(huì)把連接提前關(guān)掉。你要手工控制 commit 和 rollback以及確保 finally 里把連接關(guān)掉。練完這個(gè)小場(chǎng)景你會(huì)對(duì)事務(wù)、原子性、回滾這些東西有非常直觀的理解比單純背概念強(qiáng)十倍。7. 我把這個(gè)項(xiàng)目重新做一遍的體會(huì)說(shuō)起來(lái)這個(gè)項(xiàng)目我已經(jīng)不是第一次寫(xiě)了。每次重新寫(xiě)都會(huì)發(fā)現(xiàn)一些之前沒(méi)注意的細(xì)節(jié)比如 DECIMAL 和 DOUBLE 的差別比如設(shè)置RETURN_GENERATED_KEYS比如字符集統(tǒng)一。技術(shù)這東西就是這樣光看永遠(yuǎn)覺(jué)得簡(jiǎn)單真正動(dòng)手才會(huì)暴露自己的盲區(qū)。如果你正要開(kāi)始做這個(gè)練習(xí)我建議你給自己定一個(gè)硬指標(biāo)不要直接復(fù)制本文任何代碼全部手打每一行都要能說(shuō)出它是干什么的。遇到不會(huì)的先查 Java 文檔再看別人怎么寫(xiě)最后回來(lái)自己寫(xiě)一遍。這個(gè)過(guò)程會(huì)比較慢但每解決一個(gè)問(wèn)題你就積攢了一個(gè)真實(shí)的經(jīng)驗(yàn)這種經(jīng)驗(yàn)是你刷再多的題都換不來(lái)的。最后再分享一個(gè)小技巧寫(xiě)完之后把項(xiàng)目的運(yùn)行截圖和過(guò)程總結(jié)保存下來(lái)哪怕只是扔在自己的博客里。過(guò)三個(gè)月再回頭看你會(huì)發(fā)現(xiàn)這些記錄提醒你自己的成長(zhǎng)到底有多大。繼續(xù)往下走就把這個(gè)書(shū)架上的第一本“書(shū)”越做越厚。