JDBC+MySQL图书管理系统：从环境搭建到增删改查全解析

刚把这套“JDBC+MySQL图书管理系统”做完的时候，我最大的感受是：成品的代码量其实不大，满打满算也就两三百行，但里面塞进去的东西，几乎把JavaSE阶段最容易被忽略的基础知识全复习了一遍。它的功能看起来就是图书管理里最常见的查询、新增、修改、删除和退出，没什么新鲜感，但如果你真的动手写一遍，你会发现在这个“迷你系统”里，任何一个功能想写得干净、写得稳，都需要解决一连串实际的问题：驱动怎么加载、连接怎么建、参数怎么传、结果集怎么遍历、资源怎么释放、异常怎么处理。这篇东西就围绕我自己的实现过程，把设计和踩坑的点都掰开来讲一遍，希望能帮到正准备拿这个练手的人。

先说几句定位：这个项目适合什么水平的人？我觉得是已经学完Java基础语法（集合、面向对象、异常处理），想看看Java怎么和数据库产生联系的同学。它不需要任何Web框架，不需要前端，更不需要Spring，就用纯JDBC写一个跑在控制台里的小程序。整个过程不依赖那些高大上的技术栈，反而能让人看清底层的数据流动路径。我这套实现里，数据库用的是MySQL 8.x，JDBC驱动用的对应版本，下面的内容也会把这些细节说清楚，避免你在第一步就被环境问题卡住。

1. 项目设计与思路拆解：练手的价值不在功能多，而在于让知识形成闭环

很多初学者会有一个疑问：图书管理系统这么多人在写，网上抄抄改改，有什么好练的？我的看法正好相反——正因为它是经典的CRUD场景，才适合用来打通Java和数据库之间的完整链条。你学到的东西，不是“查一下数据”这一个动作，而是从“用户输入”到“Java方法”再到“SQL语句”，最后变成“数据库里一条真实记录”的全过程，中间任何一环断了，程序都会给你很明确的反馈。这种反馈带来的理解，比看十遍语法书都管用。

1.1 为什么选JDBC而不是直接迁移到框架

这个年代学Java，很多人一上来就直接用JPA或者MyBatis，觉得JDBC太原始。但恰恰是这个“原始”，才让开发者必须亲自处理连接、语句、结果集、异常这些最底层的东西。框架本质上是对JDBC的封装和增强，如果你连底层是怎么打开连接的、SQL是走什么渠道发出去的、参数是怎么绑定进去的都不清楚，后面遇到框架里莫名其妙的问题时会非常难受。把这个项目写完，你再看其他持久层框架的文档，会发现很多概念都能对上，比如“占位符”“预编译”就是JDBC里的PreparedStatement，理解了它，MyBatis里的#{}为什么能防注入你一秒钟就能想明白。

我建议你在这个项目里坚持用纯JDBC，不要为了方便去引入DBUtils这类小工具，也不要急着上框架。练习的意义是让自己“亲手穿过一次泥泞”，等以后走高速公路的时候，你才知道路下面哪里容易塌。这也是我认为这个迷你管理系统最值得认真对待的地方。

1.2 命令行交互的妙处：强制你考虑流程和状态

图形界面的图书系统看起来很吸引人，但对学习来说是个干扰。做界面会把大量精力耗在布局和组件的堆叠上，反而模糊了业务逻辑。选用命令行菜单，你会被迫去思考几件事：程序什么时候开始运行？用户输入“1”之后发生什么？输完信息后要不要提示成功？输完要不要回到主菜单？退出时怎么跳出循环？这些流程控制能力恰恰是编程入门的核心。

在我的实现里，主程序是一个while(true)循环加一个switch分支结构，用户录入的选项决定执行哪个功能模块，选“0”则使用return直接结束main方法，程序自然退出。这个结构虽然简单，但它就是很多后台服务主循环的雏形，这也是练手项目少有的“小而完整”的体验。

1.3 核心功能拆解和数据库字段的对应关系

这个图书系统虽然迷你，但该有的字段一个都不能少。我设计了一张图书表，字段包括：图书编号（自增主键）、书名、作者、价格、库存量、出版日期。你一来就要把这些字段敲定，因为后面所有的方法签名、SQL占位符个数、控制台读入的数据类型，全都要跟这张表对齐。下面是字段类型和对应的Java类型，这里要特别注意对应关系是否匹配。

这里有一个我在初学阶段经常错的点：数据库的decimal(10,2)对应Java里要用BigDecimal，而不是double。如果用double，等到你做修改操作时，价格的小数位偶尔会出现精度误差，明明存的是39.90，读出来变成39.899999...，这类问题在金融场景里会很严重。图书管理系统价格虽然不重要，但用它来养成正确习惯是值得的。

2. 开发环境准备与数据库建表：先别急着写代码，把基础设施弄对

这个环节看起来不涉及业务逻辑，但很多人一开始就是栽在这里。驱动没放进lib、MySQL端口被占、时区报错、连接URL少了编码参数……每一个都足够让你卡一个小时。我建议严格按照下面步骤来，不要“大概差不多”就往下走。

2.1 JDK和MySQL版本的选择，以及JDBC驱动的差异

开发环境我用的是JDK 8，虽然新版本JDK也完全能用，但教材和网上资料大部分以JDK 8为例，遇到问题时更容易找到答案。MySQL用的是8.x版本，这里有一个巨大差异点：MySQL 5.x用的驱动类是com.mysql.jdbc.Driver，而MySQL 8.x必须改成com.mysql.cj.jdbc.Driver。很多同学把网上5.x的代码搬下来跑，卡在ClassNotFounderException上，多半就是这个原因。

驱动jar包怎么处理？如果你是Maven项目，在pom.xml里引入mysql-connector-java对应版本即可；如果你是传统Java工程，就下载jar包放到项目的lib目录，再把它Add to Build Path。IDE里每换一次工作空间，都要检查一下依赖是否还在，这个不起眼的问题其实经常发生。

2.2 建库建表SQL：字符集和字段类型都不要省

我先在MySQL里执行了下面这段SQL，把它当成项目的“地基”：

CREATE DATABASE IF NOT EXISTS library DEFAULT CHARACTER SET utf8mb4; USE library; CREATE TABLE IF NOT EXISTS book ( id INT PRIMARY KEY AUTO_INCREMENT, book_name VARCHAR(50) NOT NULL, author VARCHAR(30) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, publish_date DATE );

这里最重要的一步是创建database时指定utf8mb4。如果你不指定，MySQL的默认字符集可能是latin1，中文存进去会变成乱码或报错。表名和字段名我特意避开了order、group、desc这些MySQL保留字，免得后面执行SQL时莫名其妙被语法错误折腾。publish_date用DATE类型，对应的Java类型不必用java.util.Date，直接用字符串存就可以，减少转换复杂度。

2.3 连接URL的参数：时区、编码和SSL的坑

JDBC连接数据库，URL不是随便写个地址就行。我的连接串长这样：

String url = "jdbc:mysql://localhost:3306/library?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8";

这个URL里每一个参数都对应一个实际问题：useSSL=false是关闭SSL警告，MySQL 8.x默认开了SSL，不关会打出一大堆看不懂的警告日志；serverTimezone=Asia/Shanghai是解决中国时区下的时间偏移问题，不加它你会看到“The server time zone value”异常；characterEncoding=utf8是让中文在驱动层面按UTF-8编码传输，避免另一个乱码来源。你可以把这段话直接复制进工具类，基本不会踩坑。

3. 核心代码落地：连接工具类到增删改查模块逐个拆解

代码部分是这个项目的主菜。我建议不要一上来就写完整程序，而是按照“工具类→实体类→DAO→菜单”的顺序逐步推进。写完一个方法就停下来想一想：这个方法的输入是什么，输出是什么，哪里容易出错？下面是我整个代码的骨架，每段代码和解释都是我在实际运行过的版本上提炼出来的。

3.1 包结构与JDBC工具类：连接管理必须先做对

我建了com.library.entity、com.library.util、com.library.dao、com.library.main四个包。很多同学可能觉得包结构是形式主义，但在代码量增加后，它能帮你快速定位问题所在。工具类最核心的职责是两件事：获取Connection，关闭资源。下面就是我写的JDBCUtil：

package com.library.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; public class JDBCUtil { private static final String URL = "jdbc:mysql://localhost:3306/library?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8"; private static final String USERNAME = "root"; private static final String PASSWORD = "自己的密码"; static { try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USERNAME, PASSWORD); } public static void close(Connection conn, Statement stmt, ResultSet rs) { if (rs != null) { try { rs.close(); } catch (SQLException e) { e.printStackTrace(); } } if (stmt != null) { try { stmt.close(); } catch (SQLException e) { e.printStackTrace(); } } if (conn != null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }

注意两点：用户名和密码是写在代码里的，这对学习项目没问题，但心里要清楚，真实项目里这些敏感信息必须放配置文件，再配合加密手段；close方法里判断null是必需的，因为有的调用方可能没创建Statement或ResultSet就异常了，不判断会空指针。我还用了静态代码块加载驱动，确保这行代码在类第一次被使用时就执行，避免后面忘了加载。

3.2 Book实体类：职责单一，别往里面塞逻辑

实体类的作用就是“对应一行数据库数据”的载体。我写了id、bookName、author、price、stock、publishDate六个字段，并提供标准的getter/setter方法。要注意字段名不能凭空写，必须和表结构的列名保持语义一致。

package com.library.entity; import java.math.BigDecimal; public class Book { private int id; private String bookName; private String author; private BigDecimal price; private int stock; private String publishDate; public Book() {} public Book(String bookName, String author, BigDecimal price, int stock, String publishDate) { this.bookName = bookName; this.author = author; this.price = price; this.stock = stock; this.publishDate = publishDate; } // getter和setter省略，其实每个字段都要完整生成 @Override public String toString() { return "Book{id=" + id + ", bookName='" + bookName + "', author='" + author + "', price=" + price + ", stock=" + stock + ", publishDate='" + publishDate + "'}"; } }

有同学会问，为什么不把增删改查方法直接写在实体里？这样写起来更快。我的建议是不要，因为“一个类只有一个职责”是长期工程的基本修养。Book只负责描述书本数据，数据库操作放DAO层。这个习惯养成了，以后代码规模增大时能少受很多罪。

3.3 DAO层的查询功能：PreparedStatement必须成为习惯

DAO就是数据库访问对象，我把所有SQL操作都放在BookDAO里。先看查询全部图书的方法：

public List<Book> findAll() { List<Book> list = new ArrayList<>(); String sql = "SELECT id, book_name, author, price, stock, publish_date FROM book"; try (Connection conn = JDBCUtil.getConnection(); Statement stmt = conn.createStatement(); ResultSet rs = stmt.executeQuery(sql)) { while (rs.next()) { Book b = new Book(); b.setId(rs.getInt("id")); b.setBookName(rs.getString("book_name")); b.setAuthor(rs.getString("author")); b.setPrice(rs.getBigDecimal("price")); b.setStock(rs.getInt("stock")); b.setPublishDate(rs.getString("publish_date")); list.add(b); } } catch (SQLException e) { e.printStackTrace(); } return list; }

这里我用了try-with-resources，它能自动关闭实现了AutoCloseable接口的资源，代码会清爽很多，也避免了忘记关闭连接的问题。从ResultSet取值时，列名要和SQL里查出来的列名一致，不能写成Java字段名bookName，因为数据库里这个列叫book_name。

查询单本图书的方法类似，区别在于SQL要加WHERE条件，并且用PreparedStatement绑定参数：

public Book findById(int id) { Book b = null; String sql = "SELECT id, book_name, author, price, stock, publish_date FROM book WHERE id = ?"; try (Connection conn = JDBCUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, id); try (ResultSet rs = ps.executeQuery()) { if (rs.next()) { b = new Book(); b.setId(rs.getInt("id")); // 其余字段赋值略 } } } catch (SQLException e) { e.printStackTrace(); } return b; }

关于用Statement拼接SQL还是用PreparedStatement，我见过太多同学图省事写这种代码：

String sql = "SELECT * FROM book WHERE id = " + id;

这个写法在练习模式下不太会出事，但它本质上是把用户输入直接塞进SQL语句，遇到单引号就会语法错位，遇到恶意输入会变成注入攻击。PreparedStatement把参数通过占位符分离出去，由驱动帮你做转义和类型转换，安全性高一个级别。这个习惯越早建立越省事，我就是从这个小项目开始之后写SQL都默认用它。

3.4 新增、修改、删除：三个方法处理方式一脉相承

新增图书的本质就是执行一条INSERT语句。我把用户从控制台输入的数据组装成一个Book对象，然后传给DAO。这样一来，DAO方法就非常通用：

public int addBook(Book book) { String sql = "INSERT INTO book(book_name, author, price, stock, publish_date) VALUES(?, ?, ?, ?, ?)"; try (Connection conn = JDBCUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, book.getBookName()); ps.setString(2, book.getAuthor()); ps.setBigDecimal(3, book.getPrice()); ps.setInt(4, book.getStock()); ps.setString(5, book.getPublishDate()); return ps.executeUpdate(); } catch (SQLException e) { e.printStackTrace(); return 0; } }

executeUpdate()的返回值是受影响的行数。INSERT成功返回1，失败返回0，这个数字可以用来给用户弹提示：录入成功还是失败。修改和删除的思路完全一致，只是SQL换了关键字。修改的时候需要先判断传入的id在数据库里是否存在，否则会出现“你没改到任何行，但界面提示成功”这类尴尬状况。删除也是类似道理，executeUpdate返回0时就该提示用户“该编号不存在，删除失败”。

有同学会把id自增的字段也加进INSERT语句里，这是一个常见错误：明确给自增列赋0或null，数据库虽然可能不会报错，但逻辑上说不通。让数据库自己生成id才是最稳的。

3.5 主菜单和输入的坑：scanner的换行符陷阱

菜单部分我放在main方法里，核心结构是这样：

Scanner sc = 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("0. 退出系统"); System.out.print("请选择："); int choice = sc.nextInt(); switch (choice) { case 1: // 查询 break; case 2: // 新增 break; // 其余case略 case 0: System.out.println("感谢使用，再见！"); return; default: System.out.println("输入无效，请重新选择"); break; } }

这段代码看着没问题，但实际运行时会遇到一个非常经典的问题：你选了“2”之后，程序提示你输入书名，结果sc.nextLine()读出来却是一个空字符串，直接跳过了输入。原因是nextInt()只读取了数字，把数字后面的换行符留在了缓冲区里，紧跟着的nextLine()就把这个换行符吃了。

解决方案有两种：第一，每次在读完选项后加一个sc.nextLine()把残留的换行符消耗掉；第二，所有输入都统一用nextLine()读取字符串，然后用Integer.parseInt()转数字。我实际测试下来，第二种方式整体更顺畅，你只需要额外处理一下转型异常就好。这个坑几乎每个写控制台程序的人都会踩，提前避开了能省很多调试时间。

4. 运行效果与踩坑实录：常见问题排查和避坑技巧

第四章把我在整个实现过程中遇到的高频问题集中整理一下。这些问题有的直接报错，有的属于静默异常，我按现象、原因、解决思路做了一个速查表，方便你对着排查。

4.1 运行效果概览

程序启动后会先展示菜单，用户输入1回车，能看到当前库里所有图书的列表；输入2回车，依次录入书名、作者、价格、库存、出版日期，程序返回“新增成功”；输入3回车，先输入要修改的书编号，再依次覆盖录入新信息；输入4回车，输入书编号，返回“删除成功”。全程没有图形界面，但功能路径清晰，每一步都有明确的反馈信号。我测试的时候在库里插了三本测试图书，遍历、更新、删除的流程都能正常跑通，菜单循环也没有闪退。

为了让展示更直观，我建议你在测试时故意输入错误类型，比如提示输入数字时输入字母abc，亲眼看一看程序抛出InputMismatchException。这个异常能帮你理解Scanner的机制，也是后面写健壮代码的起点。如果不想看到异常堆栈，可以考虑加一个try-catch，这属于进阶优化。

4.2 常见错误速查表

下面是我筛选出的六个高频问题，每个都有明确的特征和解决方向。

别看这些问题小，它们的出现频率极高。我见过很多同学在这个阶段被其中一个问题卡住，最后归因为“JDBC太难了”，其实是细节没到位。遇到异常要养成先看最上面几行堆栈信息的习惯，驱动名、URL、SQL语句错误都会在那一行里直接提示。

4.3 典型的静默异常：小心数据根本没写进去

有一种异常最让人迷惑：程序不报错，运行也正常，但查数据库时发现数据不见了，或者修改没生效。这种静默问题通常来自两个地方：一是事务没提交，二是executeUpdate返回0但代码没有检查。JDBC默认是自动提交的，如果你没有手动开启事务，一般不会出现不提交的情况；但如果你在某个地方用了setAutoCommit(false)又忘记commit，数据就会留在连接缓冲区里，换一个连接就看不见。

更隐蔽的是第二种：你执行了DELETE语句，但id不存在，executeUpdate返回0，代码却不管返回值，直接输出“删除成功”。这种交互体验就是典型的“伪成功”。我在自己的代码里特意检查了每个增删改方法的返回值，然后根据结果打印不同的信息，这个细节会让整个系统的可信度高很多。

4.4 让代码更进一步的三个优化方向

做完基础功能之后，我建议不要停下，而是朝三个方向各加一点东西：第一，给查询功能加一个“按书名模糊搜索”，用LIKE关键字配合%拼接，体会一下模糊匹配和精确匹配的区别；第二，给新增和修改都增加输入校验，价格必须大于0、库存不能为负、书名不能为空，这比直接往数据库灌非法数据强得多；第三，把工具类里的数据库连接信息抽到一个properties配置文件里，用java.util.Properties类读取，感受一下配置和代码分离的思想。这三个方向都不复杂，但能让你在这个迷你项目里学到更多工程化习惯，后续再接触更大型项目时就不会觉得吃力。

写在最后的几句体会

这个项目在我最开始写的时候，花了大概一个晚上才把全流程跑通，中间经历了驱动类名错误、时区异常、中文乱码、回车键吞掉输入等一堆小插曲。等全部调通后，再去回想那些报错，发现每个异常背后其实都指向Java、JDBC和MySQL三者之间某个具体的协作细节。练习项目的意义正是如此：功能越简单，越能让你直面基础知识之间的缝隙，把这些缝隙都填上，后面写复杂系统才算真正有了底子。如果你也被某个奇怪的报错卡住，别急着找现成答案，试着把连接串、SQL和返回值都打印出来看一眼，答案往往就在那些输出里。希望这篇记录能帮你少走几圈弯路，动手写完这个系统，你再看JDBC的文档或框架源码，会有一种豁然开朗的感觉。