简介一套基于Java与MySQL实现的图书管理系统完整源码工程面向学习Java Web开发与数据库操作的初学者可帮助理解Servlet、JSP、MVC模式以及JDBC数据库连接等核心知识。压缩包共222个文件约8.58MB其中包含160个Java源程序、12个依赖jar包、10个class文件以及配置文件、SQL脚本、说明文档等覆盖后端逻辑、界面展示与数据初始化所需内容。项目已提供数据库脚本便于直接导入并运行体验。已有1468人学习下载。通过该工程读者可以掌握从数据库建表、JDBC连接、业务分层到借阅归还、用户管理等完整流程适合作为课程设计或入门实战项目也可借此学习项目结构组织与常见开发规范。1. 图书管理系统JavaMySQL不只是课设更是理解 JDBC 与分层设计的完整载体一个能跑起来的 Java MySQL 图书管理系统几乎是每个 Java 初学者绕不开的练手项目。它不像电商系统那么复杂却足够覆盖 Java SE 阶段最重要的几个技术点JDBC 数据库操作、Swing 或控制台交互、面向对象设计、基础 CRUD 逻辑。很多开发者包括我自己第一次真正理解「程序怎么和数据库对话」都是从一套这样的管理系统开始的。这套资源包含完整的 Java 源码和建表 SQL 脚本整体基于 JDBC MySQL 实现图书信息的增删改查、借阅归还和读者管理功能。适合刚学完 Java 基础想找个项目练手的新手也适合需要交课程设计的同学做二次修改。你拿到手之后需要做的事情很明确导入 SQL 建库、改数据库连接参数、编译运行剩下的就是根据你自己的业务场景去扩展。下面我直接进入正题从表结构设计开始讲因为所有功能的根基都在数据库这一层。2. 数据库表结构设计两个核心表撑起全部借阅逻辑2.1 图书表和读者表字段设计决定功能上限打开资源包里的 SQL 脚本你会发现整个系统的数据层只用到了两张核心表图书信息表和读者信息表。图书表包含书名、作者、出版社、ISBN、库存总量、可借数量等字段读者表包含读者编号、姓名、联系方式、可借额度等字段。实际运行时会发现借阅记录并没有单独建表而是通过更新图书可借数量和读者已借数量来实现的这是一种简化处理但足以支撑基本的借还流程。这种设计的优点在于入门友好——两张表就能讲清楚主键、唯一约束、默认值这些建表基本概念。缺点是如果你想做借阅历史查询或者逾期统计就得自己扩展第三张表。我在拿到这套资源后的第一件事就是在阅读建表脚本时先把每条字段的数据类型和约束过一遍因为后面 JDBC 代码里的 PreparedStatement 参数类型必须和表结构严格对齐。2.2 建表脚本解读与执行顺序打开library.sql文件你会看到标准的 CREATE TABLE 语句。这里有一个实战中容易忽略的点如果数据库里已经存在同名表直接执行脚本会报错所以脚本顶部通常会带上DROP TABLE IF EXISTS语句。我建议你先打开 MySQL 命令行工具执行以下操作-- 创建图书管理系统数据库 CREATE DATABASE IF NOT EXISTS db_library DEFAULT CHARSET utf8mb4; -- 切换到该数据库 USE db_library; -- 如果已存在相关表则删除重建方便反复调试 DROP TABLE IF EXISTS tb_book; DROP TABLE IF EXISTS tb_reader; -- 创建图书信息表 CREATE TABLE tb_book ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 图书ID自增主键, book_name VARCHAR(100) NOT NULL COMMENT 书名, author VARCHAR(50) DEFAULT NULL COMMENT 作者, publisher VARCHAR(80) DEFAULT NULL COMMENT 出版社, isbn VARCHAR(20) UNIQUE COMMENT ISBN编号唯一约束, total_qty INT DEFAULT 1 COMMENT 馆藏总量, available_qty INT DEFAULT 1 COMMENT 当前可借数量 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段建表语句里最需要注意的字段是available_qty。它代表了系统判断一本书能否借出的唯一依据所有业务逻辑里的「是否可借」判断都围绕它展开。UNIQUE约束加在isbn上能防止同一本书被重复录入属于用约束保护数据完整性的典型做法。实际开发中很多人会忽略这类细节结果功能跑通了但数据乱得不行。-- 创建读者信息表 CREATE TABLE tb_reader ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 读者ID, reader_name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) DEFAULT NULL COMMENT 联系电话, max_borrow INT DEFAULT 5 COMMENT 最大可借数量, borrowed_qty INT DEFAULT 0 COMMENT 已借数量 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;读者表里的max_borrow和borrowed_qty是配套字段。当borrowed_qty达到max_borrow时代码里就会拦截新的借书操作。这种字段搭配方式是这类管理系统中最常用的「额度控制」模式你可以把它理解成一种最简单的状态机实现。2.3 初始化数据的必要性建表完成后脚本里通常还会带几条 INSERT 语句作为初始演示数据。我一般建议把这些数据保留着因为对新手来说看到界面上有数据可比对着理解问题要舒服得多。你也可以手动添加几条中文书名测试数据注意编码必须匹配否则控制台或 Swing 界面会出现中文乱码。建表字符集统一使用 utf8mb4连接参数里也要显式指定编码这一点后面会重点讲。3. 连接层与 DAO 模式JDBC 封装方式决定项目能跑多远3.1 JDBC 连接配置六个参数必须对齐整个系统最关键的配置集中在DBUtil.java或ConnectionUtils.java这类工具类里。这个类负责数据库驱动的加载和连接对象的管理核心代码通常是这样的import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { // 数据库连接参数 private static final String DRIVER com.mysql.cj.jdbc.Driver; private static final String URL jdbc:mysql://localhost:3306/db_library?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4; private static final String USER root; private static final String PASSWORD 123456; // 加载驱动并获取连接 public static Connection getConnection() throws SQLException { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } return DriverManager.getConnection(URL, USER, PASSWORD); } }这段代码里有三个参数需要你根据自己的环境修改USER和PASSWORD是你本机 MySQL 的用户名密码URL中的localhost:3306对应 MySQL 服务地址和端口。serverTimezoneAsia/Shanghai是 MySQL 8 以后必须加的时区参数不加会在建立连接时抛出 SQLException 报错这是新手最容易翻车的点之一。连接参数的写法在不同 MySQL 版本里有差异。如果用 MySQL 5.x驱动类通常是com.mysql.jdbc.Driver如果用 MySQL 8.x必须改成com.mysql.cj.jdbc.Driver并且需要保证 mysql-connector jar 包的版本也匹配。你下载的资源包里一般会带一个 lib 文件夹里面就是连接驱动如果运行时报找不到驱动类先去看 jar 包版本和你要连的 MySQL 版本是否兼容。3.2 DAO 层封装把 SQL 操作隔离到类里DAOData Access Object是这个项目的核心结构。每个数据表对应一个 DAO 类类里封装了增删改查方法。以 BookDao 为例典型的添加图书方法长这样public boolean addBook(Book book) { String sql INSERT INTO tb_book (book_name, author, publisher, isbn, total_qty, available_qty) VALUES (?, ?, ?, ?, ?, ?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, book.getBookName()); ps.setString(2, book.getAuthor()); ps.setString(3, book.getPublisher()); ps.setString(4, book.getIsbn()); ps.setInt(5, book.getTotalQty()); ps.setInt(6, book.getAvailableQty()); return ps.executeUpdate() 0; } catch (SQLException e) { e.printStackTrace(); return false; } }使用 PreparedStatement 而不是 Statement 是这套资源里值得学习的习惯。?占位符配合setString、setInt这样的方法一方面避免了 SQL 拼接时的引号转义问题另一方面防止了 SQL 注入风险。我在看这个项目源码时注意到所有写操作都走了 PreparedStatement这是符合生产习惯的。3.3 事务处理借书操作要保证两步更新原子性这个系统里最需要事务保护的场景是借书。一次借书操作涉及两个动作把图书表的available_qty减 1把读者表的borrowed_qty加 1。如果第一步成功第二步失败数据就错了。资源里的实现方式是public boolean borrowBook(int bookId, int readerId) { Connection conn null; try { conn DBUtil.getConnection(); // 关闭自动提交开启事务 conn.setAutoCommit(false); // 第一步更新图书库存 String sqlBook UPDATE tb_book SET available_qty available_qty - 1 WHERE id ? AND available_qty 0; PreparedStatement psBook conn.prepareStatement(sqlBook); psBook.setInt(1, bookId); int bookRows psBook.executeUpdate(); // 第二步更新读者已借数量 String sqlReader UPDATE tb_reader SET borrowed_qty borrowed_qty 1 WHERE id ? AND borrowed_qty max_borrow; PreparedStatement psReader conn.prepareStatement(sqlReader); psReader.setInt(1, readerId); int readerRows psReader.executeUpdate(); // 两步都成功才提交 if (bookRows 0 readerRows 0) { conn.commit(); return true; } else { conn.rollback(); return false; } } catch (SQLException e) { e.printStackTrace(); try { if (conn ! null) conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } return false; } finally { try { if (conn ! null) conn.setAutoCommit(true); if (conn ! null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }这段代码里AND available_qty 0是一个容易被忽略的细节。它保证了并发场景下不会出现两个人同时借走最后一本书的情况。虽然这个系统本身是单机课设级别但这种写法已经具备基本的并发安全意识。你在改写这个系统时如果决定增加借阅记录表同样要在这段逻辑里补充一条 INSERT 语句并且保持在同一事务内。4. 部署与启动从源码到跑通全流程记录4.1 开发环境准备说明这个项目基于 Java MySQL推荐使用 JDK 8 或以上版本配合 MySQL 5.7/8.0。IDE 可以选择 Eclipse 或 IntelliJ IDEA两者都可以直接导入项目源码。资源包里通常是src源码目录、lib依赖目录、sql脚本目录和项目的配置文件。先看一眼目录结构确认依赖 jar 包是否已经放在lib里。4.2 导入与运行的完整步骤下面是基于 IDEA 的操作流程如果你用 Eclipse逻辑一致只是菜单名称不同# 第一步用命令行创建数据库并导入表结构 mysql -u root -p sql/library.sql # 第二步确认数据表创建成功 mysql -u root -p -e USE db_library; SHOW TABLES;上面的命令运行前提是 MySQL 已经加入系统 PATH 环境变量。如果提示找不到 mysql 命令可以在 MySQL 安装目录的 bin 文件夹下执行或者直接用 Navicat 之类的图形化工具运行 SQL 脚本。我建议新手先用命令行走通一遍这样对数据库层面的工作机制会有更直接的体感。接下来打开 IDEA选择File - New - Project from Existing Sources定位到资源包的根目录。导入完成后需要把lib文件夹下的 MySQL 驱动 jar 包添加为项目依赖。在 IDEA 中选中 jar 包后右键选择Add as Library这一步经常被新手漏掉漏掉的结果就是运行时报ClassNotFoundException。修改DBUtil.java里的数据库连接参数后找到包含main方法的启动类。通常是一个名为Main.java或LoginFrame.java的类运行它之后如果控制台输出连接成功日志或者弹出登录界面说明整个链路已经通了。如果只见报错不看界面优先检查连接 URL 里的库名和账号密码是否完全一致包括空格都不能多。4.3 功能模块与执行入口对照资源包的源码结构一般是按功能分包的我整理了一份常见的文件对照表供你导航文件/包名功能职责入口方式DBUtil.java管理数据库连接被 DAO 层调用BookDao.java图书增删改查被业务层调用ReaderDao.java读者增删改查被业务层调用BookService.java图书业务逻辑供界面层调用MainFrame.java主操作界面双击运行或由 Login 跳转这种分包方式实际上是 MVC 思想的简化版界面层只负责任务分发不直接写 SQL业务层封装规则判断比如借书前检查读者额度DAO 层只做最基础的数据访问。理解了这个结构你在做二次开发时就知道新功能应该放在哪个文件里。4.4 连接失败的快速定位思路运行阶段如果反复报错不要盲目修改代码。先确认 MySQL 服务是否启动Windows 下可以打开服务管理器查看再确认端口号是否 3306如果改过端口URL 要同步改最后确认防火墙是否拦截了本机连接。这三个问题是连接类项目最常见的报错源头逐一排除后再去看代码。5. 避坑手册这五个问题解决掉你的系统就已经稳定了一大半5.1 中文乱码现象是界面显示问号现象插入的中文书名在控制台或 Swing 界面显示为问号或乱码。原因建表库的字符集、连接 URL 的字符集、Java 项目文件自身的编码三处不一致。解决建表时明确指定DEFAULT CHARSET utf8mb4连接 URL 里追加characterEncodingutf8mb4项目文件编码设为 UTF-8。这三处统一后再有新数据写入就不会乱码已有的乱码数据需要删除后重新录入。5.2 Public Key Retrieval is not allowed 报错现象使用 MySQL 8 时连接抛出Public Key Retrieval is not allowed异常。原因MySQL 8 默认使用 caching_sha2_password 加密方式客户端首次连接需要获取服务端公钥。解决在连接 URL 末尾追加allowPublicKeyRetrievaltrueuseSSLfalse完整写法参考第 3 章给出的 JDBC URL。这个问题几乎只在 MySQL 8 环境下出现查资料时会看到很多帖子让改认证方式但那会带来额外风险追加参数是更安全的做法。5.3 Driver 类找不到的 ClassNotFoundException现象运行代码时先报ClassNotFoundException: com.mysql.cj.jdbc.Driver接着报空指针或 SQLException。原因使用的驱动 jar 包版本不对或者 jar 包根本没有被添加到项目依赖里。解决确认lib里的 MySQL Connector/J 版本。连 MySQL 8 必须用 8.x 的驱动连 MySQL 5.7 可以用 5.x 驱动jar 包需要添加到构建路径IDE 里通常是右键选择 Add as Library 或 Build Path。很多新手把 jar 包放进了文件夹却没有添加依赖所以编译能通过但运行必失败。5.4 借书时库存变成负数现象继续借书时图书表的可借数量出现负值。原因借书 SQL 里有available_qty 0的守卫条件但部分功能入口绕过业务逻辑直接调用了 DAO 更新库存。解决检查所有调用路径确保借书操作统一走事务方法同时给数据库表加非负约束比如ALTER TABLE tb_book ADD CONSTRAINT chk_available_qty CHECK (available_qty 0);数据库层面的约束兜底比代码里的判断更可靠。MySQL 8 对 CHECK 约束的支持已经比较完善。5.5 驱动的时区报错现象使用 JDK 8 项目连接 MySQL 8报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。原因MySQL 服务端的时区设置不符合驱动要求。解决连接 URL 里加serverTimezoneAsia/Shanghai这条参数在第 3 章的代码里已经包含。如果你手里的资源版本没有加这条参数就自己手动补上。这个报错信息里的中文是乱码本质就是时区问题看到time zone关键字直接往这个方向排查即可。6. 进阶改造给系统加上登录安全验证与个人借阅记录查询整套系统跑通以后往哪个方向做进阶改造价值最高我会推荐两个方向一是登录模块的安全加固二是借阅记录的独立存储。前者让你理解安全开发的基础套路后者让系统具备真正的历史数据追溯能力。登录加固的基本思路是把硬编码在代码里的账号密码改成数据库存储加密码哈希验证。我给这套资源做模拟项目X改造时加入了一张管理员表密码字段存储的是加盐后的 SHA-256 哈希值而不是明文。验证逻辑是用户输入密码后先做同样的哈希运算再和库里的哈希值比较。这样做之后即使数据库泄露密码原文也不会直接暴露。你可以参考下面的代码结构去改造public boolean login(String username, String password) throws NoSuchAlgorithmException { // 模拟从数据库查询到的哈希值 String storedHash adminDao.findPasswordHashByUsername(username); if (storedHash null) { return false; } // 对用户输入做同样的哈希运算后比较 MessageDigest md MessageDigest.getInstance(SHA-256); byte[] hashBytes md.digest(password.getBytes(StandardCharsets.UTF_8)); StringBuilder sb new StringBuilder(); for (byte b : hashBytes) { sb.append(String.format(%02x, b)); } return storedHash.equals(sb.toString()); }这里用MessageDigest生成哈希值%02x格式化保证输出固定长度的十六进制字符串。注意口令存储用 SHA-256 只是入门玩法生产环境应该用 BCrypt但作为课设级别的安全演示已经足够说明问题。借阅记录独立存储的改造则涉及建新表和调整借还逻辑CREATE TABLE tb_borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_date DATETIME DEFAULT CURRENT_TIMESTAMP, return_date DATETIME DEFAULT NULL ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;每次借书时插入一条记录还书时更新return_date。有了这张表后你可以多写一个方法根据读者 ID 查询当前未归还的书籍列表。这样读者就能在界面上看到自己借了哪些书、什么时候借的整个系统从管理视角延伸到用户视角属于性价比很高的功能扩展。改造过程中注意插入借阅记录和更新库存仍然要放在同一个事务里执行不能变成两步独立操作。回想我自己最开始做图书管理系统时只把功能跑通就以为完事了后来在一次课程展示里被问到「如果有人借了书但数据库连接断了怎么办」才意识到事务的重要性。从那以后我每次写涉及多表更新的功能都会强制检查一遍是否在事务保护内这个习惯到现在都没变过。希望这套资源的拆解过程也能帮你避开同样的弯路真正吃透 Java MySQL 的核心调用链路。本文还有配套的精品资源点击获取
简介一套基于Java与MySQL实现的图书管理系统完整源码工程面向学习Java Web开发与数据库操作的初学者可帮助理解Servlet、JSP、MVC模式以及JDBC数据库连接等核心知识。压缩包共222个文件约8.58MB其中包含160个Java源程序、12个依赖jar包、10个class文件以及配置文件、SQL脚本、说明文档等覆盖后端逻辑、界面展示与数据初始化所需内容。项目已提供数据库脚本便于直接导入并运行体验。已有1468人学习下载。通过该工程读者可以掌握从数据库建表、JDBC连接、业务分层到借阅归还、用户管理等完整流程适合作为课程设计或入门实战项目也可借此学习项目结构组织与常见开发规范。1. 图书管理系统JavaMySQL不只是课设更是理解 JDBC 与分层设计的完整载体一个能跑起来的 Java MySQL 图书管理系统几乎是每个 Java 初学者绕不开的练手项目。它不像电商系统那么复杂却足够覆盖 Java SE 阶段最重要的几个技术点JDBC 数据库操作、Swing 或控制台交互、面向对象设计、基础 CRUD 逻辑。很多开发者包括我自己第一次真正理解「程序怎么和数据库对话」都是从一套这样的管理系统开始的。这套资源包含完整的 Java 源码和建表 SQL 脚本整体基于 JDBC MySQL 实现图书信息的增删改查、借阅归还和读者管理功能。适合刚学完 Java 基础想找个项目练手的新手也适合需要交课程设计的同学做二次修改。你拿到手之后需要做的事情很明确导入 SQL 建库、改数据库连接参数、编译运行剩下的就是根据你自己的业务场景去扩展。下面我直接进入正题从表结构设计开始讲因为所有功能的根基都在数据库这一层。2. 数据库表结构设计两个核心表撑起全部借阅逻辑2.1 图书表和读者表字段设计决定功能上限打开资源包里的 SQL 脚本你会发现整个系统的数据层只用到了两张核心表图书信息表和读者信息表。图书表包含书名、作者、出版社、ISBN、库存总量、可借数量等字段读者表包含读者编号、姓名、联系方式、可借额度等字段。实际运行时会发现借阅记录并没有单独建表而是通过更新图书可借数量和读者已借数量来实现的这是一种简化处理但足以支撑基本的借还流程。这种设计的优点在于入门友好——两张表就能讲清楚主键、唯一约束、默认值这些建表基本概念。缺点是如果你想做借阅历史查询或者逾期统计就得自己扩展第三张表。我在拿到这套资源后的第一件事就是在阅读建表脚本时先把每条字段的数据类型和约束过一遍因为后面 JDBC 代码里的 PreparedStatement 参数类型必须和表结构严格对齐。2.2 建表脚本解读与执行顺序打开library.sql文件你会看到标准的 CREATE TABLE 语句。这里有一个实战中容易忽略的点如果数据库里已经存在同名表直接执行脚本会报错所以脚本顶部通常会带上DROP TABLE IF EXISTS语句。我建议你先打开 MySQL 命令行工具执行以下操作-- 创建图书管理系统数据库 CREATE DATABASE IF NOT EXISTS db_library DEFAULT CHARSET utf8mb4; -- 切换到该数据库 USE db_library; -- 如果已存在相关表则删除重建方便反复调试 DROP TABLE IF EXISTS tb_book; DROP TABLE IF EXISTS tb_reader; -- 创建图书信息表 CREATE TABLE tb_book ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 图书ID自增主键, book_name VARCHAR(100) NOT NULL COMMENT 书名, author VARCHAR(50) DEFAULT NULL COMMENT 作者, publisher VARCHAR(80) DEFAULT NULL COMMENT 出版社, isbn VARCHAR(20) UNIQUE COMMENT ISBN编号唯一约束, total_qty INT DEFAULT 1 COMMENT 馆藏总量, available_qty INT DEFAULT 1 COMMENT 当前可借数量 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段建表语句里最需要注意的字段是available_qty。它代表了系统判断一本书能否借出的唯一依据所有业务逻辑里的「是否可借」判断都围绕它展开。UNIQUE约束加在isbn上能防止同一本书被重复录入属于用约束保护数据完整性的典型做法。实际开发中很多人会忽略这类细节结果功能跑通了但数据乱得不行。-- 创建读者信息表 CREATE TABLE tb_reader ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 读者ID, reader_name VARCHAR(50) NOT NULL COMMENT 姓名, phone VARCHAR(20) DEFAULT NULL COMMENT 联系电话, max_borrow INT DEFAULT 5 COMMENT 最大可借数量, borrowed_qty INT DEFAULT 0 COMMENT 已借数量 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;读者表里的max_borrow和borrowed_qty是配套字段。当borrowed_qty达到max_borrow时代码里就会拦截新的借书操作。这种字段搭配方式是这类管理系统中最常用的「额度控制」模式你可以把它理解成一种最简单的状态机实现。2.3 初始化数据的必要性建表完成后脚本里通常还会带几条 INSERT 语句作为初始演示数据。我一般建议把这些数据保留着因为对新手来说看到界面上有数据可比对着理解问题要舒服得多。你也可以手动添加几条中文书名测试数据注意编码必须匹配否则控制台或 Swing 界面会出现中文乱码。建表字符集统一使用 utf8mb4连接参数里也要显式指定编码这一点后面会重点讲。3. 连接层与 DAO 模式JDBC 封装方式决定项目能跑多远3.1 JDBC 连接配置六个参数必须对齐整个系统最关键的配置集中在DBUtil.java或ConnectionUtils.java这类工具类里。这个类负责数据库驱动的加载和连接对象的管理核心代码通常是这样的import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { // 数据库连接参数 private static final String DRIVER com.mysql.cj.jdbc.Driver; private static final String URL jdbc:mysql://localhost:3306/db_library?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4; private static final String USER root; private static final String PASSWORD 123456; // 加载驱动并获取连接 public static Connection getConnection() throws SQLException { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } return DriverManager.getConnection(URL, USER, PASSWORD); } }这段代码里有三个参数需要你根据自己的环境修改USER和PASSWORD是你本机 MySQL 的用户名密码URL中的localhost:3306对应 MySQL 服务地址和端口。serverTimezoneAsia/Shanghai是 MySQL 8 以后必须加的时区参数不加会在建立连接时抛出 SQLException 报错这是新手最容易翻车的点之一。连接参数的写法在不同 MySQL 版本里有差异。如果用 MySQL 5.x驱动类通常是com.mysql.jdbc.Driver如果用 MySQL 8.x必须改成com.mysql.cj.jdbc.Driver并且需要保证 mysql-connector jar 包的版本也匹配。你下载的资源包里一般会带一个 lib 文件夹里面就是连接驱动如果运行时报找不到驱动类先去看 jar 包版本和你要连的 MySQL 版本是否兼容。3.2 DAO 层封装把 SQL 操作隔离到类里DAOData Access Object是这个项目的核心结构。每个数据表对应一个 DAO 类类里封装了增删改查方法。以 BookDao 为例典型的添加图书方法长这样public boolean addBook(Book book) { String sql INSERT INTO tb_book (book_name, author, publisher, isbn, total_qty, available_qty) VALUES (?, ?, ?, ?, ?, ?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, book.getBookName()); ps.setString(2, book.getAuthor()); ps.setString(3, book.getPublisher()); ps.setString(4, book.getIsbn()); ps.setInt(5, book.getTotalQty()); ps.setInt(6, book.getAvailableQty()); return ps.executeUpdate() 0; } catch (SQLException e) { e.printStackTrace(); return false; } }使用 PreparedStatement 而不是 Statement 是这套资源里值得学习的习惯。?占位符配合setString、setInt这样的方法一方面避免了 SQL 拼接时的引号转义问题另一方面防止了 SQL 注入风险。我在看这个项目源码时注意到所有写操作都走了 PreparedStatement这是符合生产习惯的。3.3 事务处理借书操作要保证两步更新原子性这个系统里最需要事务保护的场景是借书。一次借书操作涉及两个动作把图书表的available_qty减 1把读者表的borrowed_qty加 1。如果第一步成功第二步失败数据就错了。资源里的实现方式是public boolean borrowBook(int bookId, int readerId) { Connection conn null; try { conn DBUtil.getConnection(); // 关闭自动提交开启事务 conn.setAutoCommit(false); // 第一步更新图书库存 String sqlBook UPDATE tb_book SET available_qty available_qty - 1 WHERE id ? AND available_qty 0; PreparedStatement psBook conn.prepareStatement(sqlBook); psBook.setInt(1, bookId); int bookRows psBook.executeUpdate(); // 第二步更新读者已借数量 String sqlReader UPDATE tb_reader SET borrowed_qty borrowed_qty 1 WHERE id ? AND borrowed_qty max_borrow; PreparedStatement psReader conn.prepareStatement(sqlReader); psReader.setInt(1, readerId); int readerRows psReader.executeUpdate(); // 两步都成功才提交 if (bookRows 0 readerRows 0) { conn.commit(); return true; } else { conn.rollback(); return false; } } catch (SQLException e) { e.printStackTrace(); try { if (conn ! null) conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } return false; } finally { try { if (conn ! null) conn.setAutoCommit(true); if (conn ! null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }这段代码里AND available_qty 0是一个容易被忽略的细节。它保证了并发场景下不会出现两个人同时借走最后一本书的情况。虽然这个系统本身是单机课设级别但这种写法已经具备基本的并发安全意识。你在改写这个系统时如果决定增加借阅记录表同样要在这段逻辑里补充一条 INSERT 语句并且保持在同一事务内。4. 部署与启动从源码到跑通全流程记录4.1 开发环境准备说明这个项目基于 Java MySQL推荐使用 JDK 8 或以上版本配合 MySQL 5.7/8.0。IDE 可以选择 Eclipse 或 IntelliJ IDEA两者都可以直接导入项目源码。资源包里通常是src源码目录、lib依赖目录、sql脚本目录和项目的配置文件。先看一眼目录结构确认依赖 jar 包是否已经放在lib里。4.2 导入与运行的完整步骤下面是基于 IDEA 的操作流程如果你用 Eclipse逻辑一致只是菜单名称不同# 第一步用命令行创建数据库并导入表结构 mysql -u root -p sql/library.sql # 第二步确认数据表创建成功 mysql -u root -p -e USE db_library; SHOW TABLES;上面的命令运行前提是 MySQL 已经加入系统 PATH 环境变量。如果提示找不到 mysql 命令可以在 MySQL 安装目录的 bin 文件夹下执行或者直接用 Navicat 之类的图形化工具运行 SQL 脚本。我建议新手先用命令行走通一遍这样对数据库层面的工作机制会有更直接的体感。接下来打开 IDEA选择File - New - Project from Existing Sources定位到资源包的根目录。导入完成后需要把lib文件夹下的 MySQL 驱动 jar 包添加为项目依赖。在 IDEA 中选中 jar 包后右键选择Add as Library这一步经常被新手漏掉漏掉的结果就是运行时报ClassNotFoundException。修改DBUtil.java里的数据库连接参数后找到包含main方法的启动类。通常是一个名为Main.java或LoginFrame.java的类运行它之后如果控制台输出连接成功日志或者弹出登录界面说明整个链路已经通了。如果只见报错不看界面优先检查连接 URL 里的库名和账号密码是否完全一致包括空格都不能多。4.3 功能模块与执行入口对照资源包的源码结构一般是按功能分包的我整理了一份常见的文件对照表供你导航文件/包名功能职责入口方式DBUtil.java管理数据库连接被 DAO 层调用BookDao.java图书增删改查被业务层调用ReaderDao.java读者增删改查被业务层调用BookService.java图书业务逻辑供界面层调用MainFrame.java主操作界面双击运行或由 Login 跳转这种分包方式实际上是 MVC 思想的简化版界面层只负责任务分发不直接写 SQL业务层封装规则判断比如借书前检查读者额度DAO 层只做最基础的数据访问。理解了这个结构你在做二次开发时就知道新功能应该放在哪个文件里。4.4 连接失败的快速定位思路运行阶段如果反复报错不要盲目修改代码。先确认 MySQL 服务是否启动Windows 下可以打开服务管理器查看再确认端口号是否 3306如果改过端口URL 要同步改最后确认防火墙是否拦截了本机连接。这三个问题是连接类项目最常见的报错源头逐一排除后再去看代码。5. 避坑手册这五个问题解决掉你的系统就已经稳定了一大半5.1 中文乱码现象是界面显示问号现象插入的中文书名在控制台或 Swing 界面显示为问号或乱码。原因建表库的字符集、连接 URL 的字符集、Java 项目文件自身的编码三处不一致。解决建表时明确指定DEFAULT CHARSET utf8mb4连接 URL 里追加characterEncodingutf8mb4项目文件编码设为 UTF-8。这三处统一后再有新数据写入就不会乱码已有的乱码数据需要删除后重新录入。5.2 Public Key Retrieval is not allowed 报错现象使用 MySQL 8 时连接抛出Public Key Retrieval is not allowed异常。原因MySQL 8 默认使用 caching_sha2_password 加密方式客户端首次连接需要获取服务端公钥。解决在连接 URL 末尾追加allowPublicKeyRetrievaltrueuseSSLfalse完整写法参考第 3 章给出的 JDBC URL。这个问题几乎只在 MySQL 8 环境下出现查资料时会看到很多帖子让改认证方式但那会带来额外风险追加参数是更安全的做法。5.3 Driver 类找不到的 ClassNotFoundException现象运行代码时先报ClassNotFoundException: com.mysql.cj.jdbc.Driver接着报空指针或 SQLException。原因使用的驱动 jar 包版本不对或者 jar 包根本没有被添加到项目依赖里。解决确认lib里的 MySQL Connector/J 版本。连 MySQL 8 必须用 8.x 的驱动连 MySQL 5.7 可以用 5.x 驱动jar 包需要添加到构建路径IDE 里通常是右键选择 Add as Library 或 Build Path。很多新手把 jar 包放进了文件夹却没有添加依赖所以编译能通过但运行必失败。5.4 借书时库存变成负数现象继续借书时图书表的可借数量出现负值。原因借书 SQL 里有available_qty 0的守卫条件但部分功能入口绕过业务逻辑直接调用了 DAO 更新库存。解决检查所有调用路径确保借书操作统一走事务方法同时给数据库表加非负约束比如ALTER TABLE tb_book ADD CONSTRAINT chk_available_qty CHECK (available_qty 0);数据库层面的约束兜底比代码里的判断更可靠。MySQL 8 对 CHECK 约束的支持已经比较完善。5.5 驱动的时区报错现象使用 JDK 8 项目连接 MySQL 8报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized。原因MySQL 服务端的时区设置不符合驱动要求。解决连接 URL 里加serverTimezoneAsia/Shanghai这条参数在第 3 章的代码里已经包含。如果你手里的资源版本没有加这条参数就自己手动补上。这个报错信息里的中文是乱码本质就是时区问题看到time zone关键字直接往这个方向排查即可。6. 进阶改造给系统加上登录安全验证与个人借阅记录查询整套系统跑通以后往哪个方向做进阶改造价值最高我会推荐两个方向一是登录模块的安全加固二是借阅记录的独立存储。前者让你理解安全开发的基础套路后者让系统具备真正的历史数据追溯能力。登录加固的基本思路是把硬编码在代码里的账号密码改成数据库存储加密码哈希验证。我给这套资源做模拟项目X改造时加入了一张管理员表密码字段存储的是加盐后的 SHA-256 哈希值而不是明文。验证逻辑是用户输入密码后先做同样的哈希运算再和库里的哈希值比较。这样做之后即使数据库泄露密码原文也不会直接暴露。你可以参考下面的代码结构去改造public boolean login(String username, String password) throws NoSuchAlgorithmException { // 模拟从数据库查询到的哈希值 String storedHash adminDao.findPasswordHashByUsername(username); if (storedHash null) { return false; } // 对用户输入做同样的哈希运算后比较 MessageDigest md MessageDigest.getInstance(SHA-256); byte[] hashBytes md.digest(password.getBytes(StandardCharsets.UTF_8)); StringBuilder sb new StringBuilder(); for (byte b : hashBytes) { sb.append(String.format(%02x, b)); } return storedHash.equals(sb.toString()); }这里用MessageDigest生成哈希值%02x格式化保证输出固定长度的十六进制字符串。注意口令存储用 SHA-256 只是入门玩法生产环境应该用 BCrypt但作为课设级别的安全演示已经足够说明问题。借阅记录独立存储的改造则涉及建新表和调整借还逻辑CREATE TABLE tb_borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_date DATETIME DEFAULT CURRENT_TIMESTAMP, return_date DATETIME DEFAULT NULL ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;每次借书时插入一条记录还书时更新return_date。有了这张表后你可以多写一个方法根据读者 ID 查询当前未归还的书籍列表。这样读者就能在界面上看到自己借了哪些书、什么时候借的整个系统从管理视角延伸到用户视角属于性价比很高的功能扩展。改造过程中注意插入借阅记录和更新库存仍然要放在同一个事务里执行不能变成两步独立操作。回想我自己最开始做图书管理系统时只把功能跑通就以为完事了后来在一次课程展示里被问到「如果有人借了书但数据库连接断了怎么办」才意识到事务的重要性。从那以后我每次写涉及多表更新的功能都会强制检查一遍是否在事务保护内这个习惯到现在都没变过。希望这套资源的拆解过程也能帮你避开同样的弯路真正吃透 Java MySQL 的核心调用链路。本文还有配套的精品资源点击获取
