从小到大如果你想碰数据库JDBC几乎是绕不开的第一道门。网上有很多大而全的视频教程但是真正自己写下来的东西少得可怜。今天要聊的这个“JDBC MySQL 图书馆迷你图书管理系统”是我个人非常推荐拿来当练习的入门小项目没有网页没有框架就一个控制台能查询、新增、修改、删除、退出。把它手敲一遍你会比看十期教程都明白什么叫做“数据库应用”。这个项目到底解决什么问题说白了它就是让你把脑子里零散的 JDBC 知识点串成一条完整的线怎么连数据库、怎么写 SQL、怎么处理结果集、怎么关资源、怎么在控制台里组织一套能跑起来的业务逻辑。适合正在学 Java 基础、刚接触数据库的同学也适合那些想复习 JDBC 的老手——毕竟很多细节隔一段时间不看真的会忘。1. 这个“迷你”系统为什么值得手敲一遍1.1 控制台应用是学习阶段的正确选择很多同学一上来就想写 Web 项目Spring Boot 一套基础框架搭起来连接池配好MVC 分层一铺然后就发现自己连最基础的数据流都没搞明白请求是怎么进来的参数是怎么传的SQL 是怎么发的结果又是怎么返回到界面上的。框架把这些东西全都藏掉了出了问题你根本不知道是框架的锅还是自己的锅。控制台项目完全没有这个问题。没有隐藏的封装没有自动配置你写的每一行 Java 代码都直接对应最终发生的事。用户输入一个数字代码就去执行操作查出来的数据用 System.out.println 一行一行打出来。这种“所见即所得”的方式对建立底层认知特别重要。等你有过几次从 null 查到、从 SQLException 里看 stack trace 排查的经历再去碰框架会有完全不同的底气。1.2 程序整体流程一个循环五个选项这个系统的骨架并不复杂核心就是一个 while 循环加 switch 分支判断。用户在控制台键入“1”到“5”程序分别走到查询、新增、修改、删除、对应的处理逻辑然后重新回到菜单直到用户输入“5”退出。Scanner scanner new Scanner(System.in); while (true) { System.out.println( 迷你图书馆管理系统 ); System.out.println(1. 查询全部书籍); System.out.println(2. 新增书籍); System.out.println(3. 修改书籍); System.out.println(4. 删除书籍); System.out.println(5. 退出系统); System.out.print(请选择操作); 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(感谢使用再见。); System.exit(0); } default - System.out.println(输入有误请选择 1 - 5 之间的数字。); } }你可能会问为什么不直接用 int 接收数字然后用 switch 匹配因为用户真的会输入各种奇怪的东西比如“abc”“空格”之类。用 nextLine() 接收字符串可以更好地容错。我见过很多人在这上面踩坑用 nextInt() 接收选项结果下次再用 nextLine() 读书籍标题的时候就会吞掉那个换行符导致输入直接错乱。所以从一开始就统一用 nextLine() 读字符串是最省心的做法。1.3 代码分层不搞架构但要有一点边界感练习项目不需要整高深的分层架构但建议还是把代码拆成几个类而不是全部怼进一个 main 方法里。我自己写的时候习惯至少分成三层实体类 Book对应数据库表的一行数据属性就是表的字段数据访问类 BookDao里面封装所有 JDBC 操作每个方法负责一条 SQL 该干的事主类 Main负责控制台菜单和用户交互。这样拆的好处有两个。第一main 方法里不会堆几十行 JDBC 代码看着清爽。第二当你后面想扩展功能比如加一个“按出版社查询”的方法只需要在 BookDao 里加方法不会牵一发动全身。实体类的写法很简单就是私有属性加 getter/setter。有些人觉得这种类没有技术含量但它其实是后面所有框架里实体映射的基础老老实实写一遍没有坏处。2. 动手前准备环境、建库建表与命名习惯2.1 版本搭配与驱动下载别在第一步卡住环境这块其实没什么玄学。JDK 用 8 以上就好我现在用得比较多的是 JDK 11往下兼容基本没什么问题。MySQL 用 5.7 或 8.0 都可以这个项目用到的功能非常基础不会触及版本间差异太大的特性。真正要注意的是 JDBC 驱动 jar 包的版本。MySQL 8.0 之后驱动类名变成了com.mysql.cj.jdbc.Driver而老版本是com.mysql.jdbc.Driver。你如果拿一个旧的 5.x 驱动 jar 去连 MySQL 8很可能会报各种奇怪的兼容错误。我个人建议直接引入较新版本的驱动 jar下载之后把它放到项目的 lib 目录然后在 IDE 里 Add as Library。这一步看似简单但 90% 的初学者卡住都是因为这个 jar 没放进去或者放进去没生效。判断方法也很简单代码里用到Class.forName(com.mysql.cj.jdbc.Driver)如果运行时报了ClassNotFoundException那就说明驱动类根本没被加载进来先检查 jar 是否真的被依赖上再去查别的问题。2.2 建库建表字段类型不要乱选接下来是数据库设计。这个小系统的表结构非常容易CREATE DATABASE library_db DEFAULT CHARACTER SET utf8mb4; USE library_db; CREATE TABLE book ( id INT AUTO_INCREMENT PRIMARY KEY COMMENT 图书编号, title VARCHAR(200) NOT NULL COMMENT 书名, author VARCHAR(100) NOT NULL COMMENT 作者, price DECIMAL(8, 2) DEFAULT 0.00 COMMENT 价格, publisher VARCHAR(100) COMMENT 出版社, publish_date DATE COMMENT 出版日期 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有几个细节值得拿出来说。第一价格字段别用 FLOAT 或 DOUBLE。二进制浮点数存十进制小数会产生精度问题比如存 39.9读出来可能是 39.900000001。DBA 看到这种设计会皱眉做练习的时候就应该养成用 DECIMAL 的习惯。第二日期字段用 DATE而不是 VARCHAR。有些教程为了省事把日期当字符串存程序里面也能跑但你后面一旦要做日期范围查询就会非常痛苦字面比较和日期比较的逻辑完全不同。第三主键用自增 INT 就好。别去搞那种“业务编号”比如什么“ISBN”ISBN 本身有数据录入错误的风险不适合当主键。小型练习项目里代理主键就是最省事的解。2.3 字符集与存储引擎这两个坑你在代码里感受不到在 MySQL 里utf8mb4和utf8的差别很多人一直没搞清楚。MySQL 的utf8最多只能存 3 字节编码的字符这意味着像 emoji 这类 4 字节字符它会报错或者存成乱码。utf8mb4是真正兼容完整 Unicode 的字符集。书名里如果出现特殊符号用utf8mb4就不会出幺蛾子。存储引擎建议显式写成 InnoDB。MySQL 5.5 以后默认就是 InnoDB但作为练习最好知道为什么要选它只有 InnoDB 支持事务和外键。本项目里用到的事务不多但你在建表的时候把它当成默认标准后续做转账练习、订单练习就会顺手很多。建表之后顺手插几条测试数据方便后面调试查询功能INSERT INTO book (title, author, price, publisher, publish_date) VALUES (Java核心技术, 某作者, 139.00, 某出版社, 2022-01-15), (代码整洁之道, 某作者, 59.00, 某出版社, 2020-06-30), (数据库系统概论, 某作者, 49.50, 某出版社, 2019-03-20);3. JDBC 连接新手翻车总数最多的一道门槛3.1 用 Properties 文件管理连接参数别在代码里写死密码刚开始练习的时候很多人会把连接参数直接写在 Java 代码里图省事String url jdbc:mysql://localhost:3306/library_db?useSSLfalseserverTimezoneAsia/Shanghai; String username root; String password 123456;这样写不是不能跑但有一个非常现实的坏处改数据库密码、换库名的时候你得跑回代码里改改完还要重新编译。这还算小事更麻烦的是代码一旦提交到团队仓库等于把数据库密码暴露给所有人。从练习第一天开始养成好习惯把连接信息放到jdbc.properties文件里drivercom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/library_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 usernameroot password123456在 Java 里用Properties类加载Properties props new Properties(); try (InputStream in DBUtil.class.getClassLoader().getResourceAsStream(jdbc.properties)) { props.load(in); }这样数据库配置和代码就完全分开了。以后不管换环境还是调参数都只需要改一个配置文件比在代码里找连接字符串舒服得多。3.2 连接参数里那几段神秘字符串逐个解释URL 里那串useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8看起来很劝退其实每一段都有原因。useSSLfalse本机调试阶段根本不需要加密加上等于告诉驱动不用做证书校验省去一堆握手时间。生产环境再考虑开 SSL那又是另一套话题。serverTimezoneAsia/ShanghaiMySQL 8 驱动要求明确指定时区否则会报一个关于 CST 时区的歧义异常。不管你的机器在哪写明确时区是最稳妥的。characterEncodingutf8这个要和建表时的utf8mb4区分开。它管的是客户端和服务器之间传输字符的编码方式如果不加中文写入后很容易变成问号。3.3 连接资源抓住 try-with-resources 这个救命语法JDBC 最容易被忽视但又最致命的问题就是资源泄漏。每个操作都要拿到 Connection用完如果不关数据库连接池里的连接就会被耗尽系统最终表现为“越来越慢然后直接挂掉”。所以从写第一版代码开始就一定要用 try-with-resources 语法。它会在 try 代码块结束时自动关闭所有实现了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; }你可能会想既然 try-with-resources 这么方便是不是完全不用手动写 close 了其实不是如果你用一个Connection对象执行多个操作比如用同一个连接先查再改那你不能把连接写在方法内部的 try 里否则一个方法结束连接就关了。对于这个迷你系统每次操作独立开一个连接用完即关是最清醒简单的模型。3.4 每次操作都连接一次会不会太浪费会有一点浪费但这是练习项目优先级不是性能而是结构清晰。每次操作都新建连接意味着每次操作都是独立的、可预测的不会出现一个连接状态影响另一个操作的情景。真到性能有要求的时候再去引入连接池比如 HikariCP。连接池的原理很好理解预先创建一批连接放在池子里程序要连接时从池子里拿用完放回去而不是真的断开。你在这个练习项目里理解了 Connection 的生命周期再去看连接池的配置参数就完全不会懵了。4. 四个核心功能的一次性实现与常遇易错点4.1 查询先写出不带条件的再写模糊查询查询功能是四个功能里最直接的但依然有值得注意的地方。第一步先实现“查询全部”就是上面代码里那段跑起来能在控制台看到表格里已有的数据。第二步可以在菜单里加一个“按书名模糊查询”的选项。这里有一个很重要的知识点为什么用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 结构定下来用户输入的内容只能作为参数传进去。如果你图省事直接拼接字符串String sql SELECT * FROM book WHERE title LIKE % keyword %;这时候用户如果输入一个单引号SQL 语句就变了这就是传说中的 SQL 注入。别觉得练习项目不用考虑安全问题养成正确的习惯比什么都重要写 SQL 就用占位符永远不要在 SQL 字符串里直接拼接用户输入。4.2 新增别只写 INSERT带上返回主键新增功能看起来就是往表里插入一行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这里做个转换 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; } }这里有个很多人不会在小项目里注意的点prepareStatement(sql)和prepareStatement(sql, Statement.RETURN_GENERATED_KEYS)的区别。默认情况下PreparedStatement 执行完 INSERT 不会拿回自增主键如果你后面需要这个新记录的 id 去操作关联表比如插入“图书借阅记录”主键就非常有用。所以养成一个习惯新增操作尽量考虑是否需要返回主键。插入操作还要注意 NULL 的处理。用户在控制台可能把出版日期留空了那么你就不能强制调用ps.setDate(5, date)而没有 null 判断。JDBC 规定如果你传入 null必须显式调用setDate(5, null)直接传 Java null 进去有时候会抛异常。4.3 修改注意“只更新用户填了的那部分”要怎么做修改功能比新增稍微复杂一点点因为它面临一个选择是把所有字段都更新一遍还是只更新用户填写的字段。最省事的方案是让用户把 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; } }另一种方案是“动态 SQL”只更新用户传入的非空字段。但是用纯 JDBC 写动态 SQL 非常啰嗦你需要根据不同的情况拼接 SQL 语句和参数。初学者很容易在这里写出字符串拼接而且容易漏掉逗号。所以对于这个迷你项目我建议就选整行更新的方案逻辑清楚、代码短小。等以后学了 MyBatis会发现动态 SQL 是框架帮你解决的问题而这里先把静态 SQL 写熟练更重要。4.4 删除执行成功不一定代表真的删掉了东西删除操作是四个操作里代码最短的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; } }这里的关键是executeUpdate()返回的“受影响行数”是 0不代表执行出错而是说没有匹配到对应的记录。所以在控制台层面你应该根据这个返回值给用户不同的反馈int rows bookDao.deleteById(id); if (rows 0) { System.out.println(删除成功); } else { System.out.println(没有找到 ID 对应的书籍请检查后重试); }这种看似微不足道的反馈恰恰是系统可用性的体现。直接把“删除成功”打印出去但实际什么都没删用户会非常困惑。5. 实战中的故障排查——这些坑我替你踩过了5.1 高频报错速查表我把练习过程中最容易撞到的几个问题和排查方法整理成了一张表新手照着查就行报错信息通常原因排查顺序ClassNotFoundException: com.mysql.cj.jdbc.Driver驱动 jar 没引入或类名写错检查 lib 目录检查类名是否带 cjAccess denied for user rootlocalhost用户名或密码不对先用命令行工具连一遍确认账号Unknown database library_db数据库没建或库名写错执行SHOW DATABASES确认Public Key Retrieval is not allowedMySQL 8 的认证插件问题URL 加allowPublicKeyRetrievaltrueConnection refusedMySQL 服务没启动确认服务状态也确认端口不是默认 3306Column xxx cannot be null插入/更新时空值没处理检查代码里是否传了 null 给非空字段Data too long for column xxx字段长度设小了调整 VARCHAR 长度比如书名设 200 很合理控制台中文乱码成一堆????连接 URL 没带 characterEncoding 或表不是 utf8mb4两头排查连接参数和表字符集5.2 最容易忽略的根因IDE 与文件编码中文乱码还有一个特别隐蔽的来源就是你的 Java 源文件本身的编码不对。IDE 默认可能是 GBK但是编译的时候又按 UTF-8 去解码中文字符串直接变成乱码。这个和数据库一点关系都没有。解决办法很简单统一把整个项目的字符编码设置为 UTF-8。在 IDE 里找到编码设置把项目全局、文件的默认编码都改成 UTF-8。数据库那边确认表是 utf8mb4连接 URL 带 characterEncodingutf8这样一套组合下来中文就非常稳。5.3 排查问题的标准流程5.3 排查问题的标准流程遇到报错不要急着到处找答案我给你一套百试百灵的方法。先把异常信息完整读一遍找到 “Caused by” 那一行那通常才是真正的病根。然后按下面顺序检查确认 MySQL 服务正常命令行执行SELECT 1如果能查出结果说明服务端没问题。确认驱动 jar 确实在 classpath手动在代码里新建一个驱动类看看能不能编译过。确认 SQL 语法本身没问题把我上面写的 SQL 直接复制到数据库客户端执行比如用 Navicat 或命令行看看能不能跑。这一步能帮你把“SQL 错误”和“Java 代码错误”快速区分开。确认参数绑定顺序?占位符的顺序和setXxx的顺序必须一一对应这个错误很难肉眼发现建议一行一行对。这套流程走一遍可以说覆盖了 90% 的 JDBC 连接与执行问题。6. 做完之后下一步还能怎么练6.1 用“三层结构”重写一遍如果你把第一个版本写出来并且跑通了别急着发朋友圈庆祝我先给你留一个作业把项目拆成 Service 层、DAO 层、实体层然后给 DAO 加一个接口。为什么要做接口因为你现在的 BookDao 是直接实现代码接口的意义在于你定义“这个系统需要哪些数据操作能力”然后在实现类里做具体的事情。以后你想把 BookDao 的实现换成别的数据库比如换成 PostgreSQL只需要再写一个新的实现类控制台主程序几乎不用动。这个练习不需要新的框架就是纯 Java 就能做建一个接口BookDao里面放ListBook findAll()、int insert(Book book)、int update(Book book)、int deleteById(int id)这些方法然后让BookDaoImpl去实现它。改完之后你会发现面向接口编程并没有想象中那么玄学就是你平时做事的一种方式先定好规矩再谈具体怎么做。6.2 试着加一个“借书还书”场景练练事务如果你觉得 CRUD 已经手到擒来了可以在这个图书馆系统里加一个借书还书的功能专门用来练事务。场景是这样的图书馆里每一本书有库存数量用户借一本书不仅要往“借阅记录表”里插入一条记录还要把书的库存减一。这两个操作必须同时成功或者同时失败否则就会出现“记录借出去了但库存没减”这种数据不一致。在 JDBC 里面事务代码的正规写法是这样的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(库存不足或书籍不存在); } } 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(); } } } }注意这里我没有用 try-with-resources 来管理 Connection因为事务要求连接在多个操作之间保持一致try-with-resources 放在外围会把连接提前关掉。你要手工控制 commit 和 rollback以及确保 finally 里把连接关掉。练完这个小场景你会对事务、原子性、回滚这些东西有非常直观的理解比单纯背概念强十倍。7. 我把这个项目重新做一遍的体会说起来这个项目我已经不是第一次写了。每次重新写都会发现一些之前没注意的细节比如 DECIMAL 和 DOUBLE 的差别比如设置RETURN_GENERATED_KEYS比如字符集统一。技术这东西就是这样光看永远觉得简单真正动手才会暴露自己的盲区。如果你正要开始做这个练习我建议你给自己定一个硬指标不要直接复制本文任何代码全部手打每一行都要能说出它是干什么的。遇到不会的先查 Java 文档再看别人怎么写最后回来自己写一遍。这个过程会比较慢但每解决一个问题你就积攒了一个真实的经验这种经验是你刷再多的题都换不来的。最后再分享一个小技巧写完之后把项目的运行截图和过程总结保存下来哪怕只是扔在自己的博客里。过三个月再回头看你会发现这些记录提醒你自己的成长到底有多大。继续往下走就把这个书架上的第一本“书”越做越厚。