简介这是一套可直接运行的图书管理系统源码面向Java Web初学者、课程设计学生及需要快速搭建信息管理项目的开发者帮助解决图书借阅、归还、查询等业务场景的自动化管理问题。资源包共179个文件约4.48MB以50个jsp页面、33个java源文件与33个class编译文件为核心辅以15个jar依赖、5个tld标签库、3个xml配置及sql脚本、properties配置等覆盖前端展示、后端逻辑与数据库脚本的完整结构。目前已有7177人学习下载热度较高。系统采用JSPJavaTomcatMySQLEclipse技术栈涵盖用户管理、图书管理、借阅管理等多个模块包含BorrowDAO、BookDAO、ReaderDAO等数据访问层实现读者可借此理解MVC分层、数据库表设计与Servlet容器部署流程适合作为课程设计、毕业设计参考或Java Web入门练手项目。1. 从一份能直接跑起来的 JSP 图书管理系统源码说起很多 Java Web 初学者卡在同一个地方语法都学过Servlet 生命周期也能背但真给一个能跑的项目反而不知道从哪下手。这份图书管理系统源码就是冲着这个痛点来的——JSP Java Tomcat MySQL Eclipse 的经典组合导入后配好数据库就能直接运行涵盖用户管理、图书管理、借阅管理三个核心模块。源码里能看到 BorrowDAO、ManagerDAO、BookDAO、ReaderDAO、ReaderTypeDAO 这些分层清晰的 DAO 类以及 Borrow、Manager、Book、Reader 等实体类还有 BorrowForm 这种典型的表单封装类。它适合谁适合正在做课程设计的学生、想找一个完整 JavaWeb 案例练手的转行者以及需要快速搭一个图书借阅原型的小团队。下面我按实际拆包的顺序把这份源码从环境搭建到跑通、再到改功能一步步讲清楚。2. 环境搭建JDK、Tomcat、MySQL、Eclipse 四件套怎么配才不翻车2.1 版本选型为什么这套源码不建议上 JDK 17这份源码用的是javax.servlet包不是jakarta.servlet。Tomcat 10 之后 Servlet API 的包名从javax.*改成了jakarta.*如果你直接拿 Tomcat 10 或 11 去部署JSP 页面里的% page importjavax.servlet.* %会全部报红编译直接失败。所以版本搭配上我一般会这么选组件推荐版本原因JDK8 或 11源码编译级别低JDK 8 最稳Tomcat8.5 或 9.0仍使用 javax.servlet兼容性最好MySQL5.7 或 8.08.0 需要改驱动类和连接串Eclipse2021-09 及以上对 Dynamic Web Project 支持完整JDK 安装完记得设JAVA_HOMEPath 里加上%JAVA_HOME%\bin。验证命令java -version javac -version两条命令输出的版本号要一致不一致说明 Path 里有别的 JDK 抢先了这是新手最常见的翻车点之一。Tomcat 下载解压后先别急着往 Eclipse 里加。单独启动一次bin\startup.bat浏览器访问http://localhost:8080看到 Tomcat 默认页说明端口没被占。如果 8080 被占改conf/server.xml里的 Connector port改成 8081 或 9090 都行。MySQL 安装时字符集选utf8mb4排序规则选utf8mb4_general_ci。安装完成后建库CREATE DATABASE library_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER lib_userlocalhost IDENTIFIED BY Lib123456; GRANT ALL PRIVILEGES ON library_db.* TO lib_userlocalhost; FLUSH PRIVILEGES;这里单独建用户而不是直接用 root是为了后面改连接配置时养成好习惯。密码里带特殊字符时JDBC 连接串里不需要转义但 XML 配置文件里要写成amp;。2.2 Eclipse 导入项目Dynamic Web Project 的坑集中在哪Eclipse 导入这份源码走File → Import → General → Existing Projects into Workspace。导入后如果项目图标上有个红叉大概率是这三件事没做第一Targeted Runtime 没设。右键项目 → Properties → Targeted Runtimes → 勾上你装的 Tomcat 版本。这一步不做Eclipse 不知道用哪个 Servlet 容器编译。第二Build Path 里缺 JDK。右键项目 → Build Path → Configure Build Path → Libraries → 如果 JRE System Library 显示为 unbound双击改成 Workspace default JRE 或你指定的 JDK。第三Web Content 目录结构不对。这份源码的 JSP 页面应该在WebContent或src/main/webapp下WEB-INF/lib里应该有mysql-connector-java-x.x.x.jar。如果 lib 目录是空的去 MySQL 官网下对应版本的驱动包丢进去右键 Build Path → Add to Build Path。数据库连接配置一般在src下的db.properties或某个工具类里。找到类似这样的配置drivercom.mysql.jdbc.Driver urljdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingutf8useSSLfalse usernamelib_user passwordLib123456MySQL 8.0 的驱动类要改成com.mysql.cj.jdbc.DriverURL 里建议加上serverTimezoneAsia/Shanghai否则启动时报时区错误。改完配置右键项目 → Run As → Run on Server选 Tomcat浏览器自动打开http://localhost:8080/项目名/能看到登录页就算部署成功了。3. DAO 层拆解BorrowDAO、BookDAO、ReaderDAO 到底怎么串起来的3.1 实体类与 DAO 的对应关系这份源码的类文件清单其实已经把分层结构说清楚了。实体类有Book、Reader、Manager、Borrow对应的 DAO 是BookDAO、ReaderDAO、ManagerDAO、BorrowDAO另外还有一个ReaderTypeDAO管读者类型BorrowForm是借阅表单的封装类。典型的 DAO 模式实体类只负责承载数据DAO 类负责所有 SQL 操作JSP 页面通过调用 DAO 方法拿数据再渲染。以BookDAO为例常见的方法签名包括public ListBook findAll(); public Book findById(int id); public boolean insert(Book book); public boolean update(Book book); public boolean delete(int id); public ListBook searchByTitle(String keyword);BorrowDAO会多一层业务逻辑比如借书时要同时做两件事往borrow表插一条借阅记录同时把book表的可借数量减一。这两步要么都成功要么都回滚所以BorrowDAO里通常能看到手动控制事务的代码Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 插入借阅记录 String sql1 INSERT INTO borrow(reader_id, book_id, borrow_date, status) VALUES(?,?,?,?); PreparedStatement ps1 conn.prepareStatement(sql1); ps1.setInt(1, readerId); ps1.setInt(2, bookId); ps1.setDate(3, new java.sql.Date(System.currentTimeMillis())); ps1.setString(4, BORROWED); ps1.executeUpdate(); // 更新图书可借数量 String sql2 UPDATE book SET available available - 1 WHERE id ? AND available 0; PreparedStatement ps2 conn.prepareStatement(sql2); ps2.setInt(1, bookId); int affected ps2.executeUpdate(); if (affected 0) { throw new RuntimeException(库存不足); } conn.commit(); } catch (Exception e) { if (conn ! null) conn.rollback(); e.printStackTrace(); } finally { DBUtil.close(conn); }这段代码的关键在于available 0这个条件。如果只写WHERE id ?并发借书时可能出现库存减到负数的情况。加上这个条件后executeUpdate返回 0 就说明库存不够主动抛异常触发回滚。这是这份源码里比较扎实的一个细节很多课程设计级别的项目不会处理。3.2 JSP 页面如何调用 DAO 并展示数据JSP 页面里通常用两种方式拿 DAO 返回的数据一种是在% %脚本块里直接调另一种是用 JSTL 的c:forEach遍历。这份源码大概率是前者因为老项目用脚本块的居多。典型写法% page importcom.library.dao.BookDAO % % page importcom.library.entity.Book % % page importjava.util.List % % BookDAO bookDAO new BookDAO(); ListBook books bookDAO.findAll(); % table trth书名/thth作者/thth可借数量/th/tr % for (Book b : books) { % tr td% b.getTitle() %/td td% b.getAuthor() %/td td% b.getAvailable() %/td /tr % } % /table这里有个性能问题值得注意每次刷新页面都会新建一个BookDAO实例并执行一次全表查询。数据量小的时候无所谓但如果book表有几千条记录页面会明显变慢。改进方向是在 DAO 里加分页查询findAll改成findByPage(int page, int size)SQL 里加LIMIT。这是从课程设计走向实际项目必须迈的一步。另外JSP 里直接new BookDAO()意味着 JSP 和 DAO 强耦合。如果后面想换成 Spring 管理 Bean这些 JSP 都得改。更常见的做法是在 Servlet 里调 DAO把结果request.setAttribute后转发到 JSPJSP 只负责展示。这份源码如果用的是纯 JSP 模式那它的定位就是教学演示不是生产级架构。4. 避坑与排查部署运行阶段最容易卡住的五个地方4.1 现象Tomcat 启动报 ClassNotFoundException: com.mysql.jdbc.Driver原因MySQL 驱动 jar 没放进WEB-INF/lib或者放进去但没加到 Build Path。Eclipse 里 Build Path 加了但部署时没勾选到 Tomcat 的 lib 里也会出现这个问题。解决确认WEB-INF/lib下有mysql-connector-java-5.1.x.jar或mysql-connector-java-8.0.x.jar。右键项目 → Properties → Deployment Assembly → 确认 lib 目录映射到了/WEB-INF/lib。如果用的是 MySQL 8.0驱动类名改成com.mysql.cj.jdbc.Driver。4.2 现象页面中文显示乱码数据库里查出来是问号原因三个环节的字符集没统一——JSP 页面编码、Tomcat 请求编码、MySQL 连接编码。解决JSP 页面头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %JDBC URL 里加useUnicodetruecharacterEncodingutf8MySQL 建库时用utf8mb4。如果还乱检查 Tomcat 的conf/server.xml里 Connector 有没有URIEncodingUTF-8。4.3 现象Eclipse 里 Run on Server 找不到项目原因项目不是 Dynamic Web Project 类型或者 Targeted Runtime 没勾。解决右键项目 → Properties → Project Facets → 确认 Dynamic Web Module 勾上版本选 3.0 或 3.1。然后 Targeted Runtimes 里勾 Tomcat。如果 Project Facets 里改不了说明项目导入时被识别成了普通 Java 项目需要新建一个 Dynamic Web Project 再把源码拷进去。4.4 现象借阅功能报错提示外键约束失败原因borrow表的外键指向reader和book插入借阅记录时reader_id或book_id在对应表里不存在。解决先确认读者和图书数据已经录入。如果是从 SQL 脚本导入的测试数据检查脚本里reader和book的插入语句是否在borrow之前执行。外键约束的顺序不能乱。4.5 现象修改 JSP 后刷新浏览器没变化原因Tomcat 默认不自动重载 JSP 修改或者浏览器缓存了旧页面。解决Eclipse 里双击 Tomcat 服务器确认 Publishing 选的是 Automatically publish when resources change。浏览器用 CtrlF5 强制刷新。如果还不行右键 Tomcat → Clean重新发布。5. 二次开发切入点从改一个查询到加一个完整模块5.1 先跑通一个最小改动给图书列表加分页拿到一份能跑的源码第一步不是大改而是找一个小功能验证自己理解了数据流。分页是个合适的切入点。在BookDAO里加一个方法public ListBook findByPage(int page, int size) { ListBook list new ArrayList(); String sql SELECT * FROM book ORDER BY id LIMIT ? OFFSET ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, size); ps.setInt(2, (page - 1) * size); ResultSet rs ps.executeQuery(); while (rs.next()) { Book b new Book(); b.setId(rs.getInt(id)); b.setTitle(rs.getString(title)); b.setAuthor(rs.getString(author)); b.setAvailable(rs.getInt(available)); list.add(b); } } catch (SQLException e) { e.printStackTrace(); } return list; }然后在 JSP 里接收page参数默认 1调用findByPage(page, 10)。再在页面底部加「上一页 / 下一页」链接链接里带上?page% page1 %。这个改动虽小但把 DAO 查询、JSP 传参、页面渲染整条链路都走了一遍。5.2 加一个「借阅历史」页面需要动哪些文件如果要加一个读者查看自己借阅历史的页面需要新增或修改这些文件文件作用BorrowDAO.java加findByReaderId(int readerId)方法borrow_history.jsp新建页面调 DAO 拿数据并渲染表格reader_menu.jsp在读者菜单里加「借阅历史」链接web.xml如果用 Servlet 转发需要配 url-patternBorrowDAO里的查询要关联book表拿书名SELECT b.id, bk.title, b.borrow_date, b.return_date, b.status FROM borrow b JOIN book bk ON b.book_id bk.id WHERE b.reader_id ? ORDER BY b.borrow_date DESC这个查询用到了 JOIN结果集不是单一实体能承载的常见做法是建一个BorrowDetail值对象或者直接用MapString, Object接收。我一般会建一个简单的 VO 类字段和查询列一一对应这样 JSP 里取值类型明确不容易出错。5.3 从 JSP 脚本块迁移到 Servlet JSTL 的思路如果打算把这个项目改造成更规范的 MVC迁移路径是JSP 里的new DAO()全部去掉改成 Servlet 接收请求、调 DAO、request.setAttribute存数据、forward到 JSP。JSP 里用 JSTL 的c:forEach替代脚本块。web.xml里配 Servlet 映射或者用WebServlet注解。这一步做完项目结构就从「JSP 为中心」变成了「Servlet 为中心」后面接 Spring MVC 会顺很多。改的时候注意WEB-INF/lib里要加jstl.jar和standard.jarJSP 头部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。这两个 jar 的版本要和 Tomcat 版本匹配Tomcat 9 用 JSTL 1.2 没问题Tomcat 8.5 用 1.2 也行。5.4 数据库连接池从 DriverManager 到 Druid 的最小改动这份源码大概率用的是DriverManager.getConnection()每次请求都新建连接。改成连接池只需要动DBUtil一个类private static DataSource dataSource; static { try { Properties props new Properties(); props.load(DBUtil.class.getClassLoader().getResourceAsStream(db.properties)); dataSource DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); }db.properties里加initialSize5、maxActive20、maxWait3000。改完之后DAO 层的代码一行不用动因为getConnection()的签名没变。这就是面向接口编程的好处。Druid 的 jar 包丢进WEB-INF/lib重启 Tomcat 就能生效。从那以后我每次拿到一份能跑的 JavaWeb 源码都强制自己先不改业务代码而是把数据库连接池换掉、把 JSP 里的脚本块清一遍、再加一个分页查询。这三步走完项目的骨架就摸清了后面加功能心里有底。希望这份拆解能帮你少走点弯路。本文还有配套的精品资源点击获取 JSP图书管理系统源码实战：环境搭建、DAO分层与二次开发避坑指南
简介这是一套可直接运行的图书管理系统源码面向Java Web初学者、课程设计学生及需要快速搭建信息管理项目的开发者帮助解决图书借阅、归还、查询等业务场景的自动化管理问题。资源包共179个文件约4.48MB以50个jsp页面、33个java源文件与33个class编译文件为核心辅以15个jar依赖、5个tld标签库、3个xml配置及sql脚本、properties配置等覆盖前端展示、后端逻辑与数据库脚本的完整结构。目前已有7177人学习下载热度较高。系统采用JSPJavaTomcatMySQLEclipse技术栈涵盖用户管理、图书管理、借阅管理等多个模块包含BorrowDAO、BookDAO、ReaderDAO等数据访问层实现读者可借此理解MVC分层、数据库表设计与Servlet容器部署流程适合作为课程设计、毕业设计参考或Java Web入门练手项目。1. 从一份能直接跑起来的 JSP 图书管理系统源码说起很多 Java Web 初学者卡在同一个地方语法都学过Servlet 生命周期也能背但真给一个能跑的项目反而不知道从哪下手。这份图书管理系统源码就是冲着这个痛点来的——JSP Java Tomcat MySQL Eclipse 的经典组合导入后配好数据库就能直接运行涵盖用户管理、图书管理、借阅管理三个核心模块。源码里能看到 BorrowDAO、ManagerDAO、BookDAO、ReaderDAO、ReaderTypeDAO 这些分层清晰的 DAO 类以及 Borrow、Manager、Book、Reader 等实体类还有 BorrowForm 这种典型的表单封装类。它适合谁适合正在做课程设计的学生、想找一个完整 JavaWeb 案例练手的转行者以及需要快速搭一个图书借阅原型的小团队。下面我按实际拆包的顺序把这份源码从环境搭建到跑通、再到改功能一步步讲清楚。2. 环境搭建JDK、Tomcat、MySQL、Eclipse 四件套怎么配才不翻车2.1 版本选型为什么这套源码不建议上 JDK 17这份源码用的是javax.servlet包不是jakarta.servlet。Tomcat 10 之后 Servlet API 的包名从javax.*改成了jakarta.*如果你直接拿 Tomcat 10 或 11 去部署JSP 页面里的% page importjavax.servlet.* %会全部报红编译直接失败。所以版本搭配上我一般会这么选组件推荐版本原因JDK8 或 11源码编译级别低JDK 8 最稳Tomcat8.5 或 9.0仍使用 javax.servlet兼容性最好MySQL5.7 或 8.08.0 需要改驱动类和连接串Eclipse2021-09 及以上对 Dynamic Web Project 支持完整JDK 安装完记得设JAVA_HOMEPath 里加上%JAVA_HOME%\bin。验证命令java -version javac -version两条命令输出的版本号要一致不一致说明 Path 里有别的 JDK 抢先了这是新手最常见的翻车点之一。Tomcat 下载解压后先别急着往 Eclipse 里加。单独启动一次bin\startup.bat浏览器访问http://localhost:8080看到 Tomcat 默认页说明端口没被占。如果 8080 被占改conf/server.xml里的 Connector port改成 8081 或 9090 都行。MySQL 安装时字符集选utf8mb4排序规则选utf8mb4_general_ci。安装完成后建库CREATE DATABASE library_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE USER lib_userlocalhost IDENTIFIED BY Lib123456; GRANT ALL PRIVILEGES ON library_db.* TO lib_userlocalhost; FLUSH PRIVILEGES;这里单独建用户而不是直接用 root是为了后面改连接配置时养成好习惯。密码里带特殊字符时JDBC 连接串里不需要转义但 XML 配置文件里要写成amp;。2.2 Eclipse 导入项目Dynamic Web Project 的坑集中在哪Eclipse 导入这份源码走File → Import → General → Existing Projects into Workspace。导入后如果项目图标上有个红叉大概率是这三件事没做第一Targeted Runtime 没设。右键项目 → Properties → Targeted Runtimes → 勾上你装的 Tomcat 版本。这一步不做Eclipse 不知道用哪个 Servlet 容器编译。第二Build Path 里缺 JDK。右键项目 → Build Path → Configure Build Path → Libraries → 如果 JRE System Library 显示为 unbound双击改成 Workspace default JRE 或你指定的 JDK。第三Web Content 目录结构不对。这份源码的 JSP 页面应该在WebContent或src/main/webapp下WEB-INF/lib里应该有mysql-connector-java-x.x.x.jar。如果 lib 目录是空的去 MySQL 官网下对应版本的驱动包丢进去右键 Build Path → Add to Build Path。数据库连接配置一般在src下的db.properties或某个工具类里。找到类似这样的配置drivercom.mysql.jdbc.Driver urljdbc:mysql://localhost:3306/library_db?useUnicodetruecharacterEncodingutf8useSSLfalse usernamelib_user passwordLib123456MySQL 8.0 的驱动类要改成com.mysql.cj.jdbc.DriverURL 里建议加上serverTimezoneAsia/Shanghai否则启动时报时区错误。改完配置右键项目 → Run As → Run on Server选 Tomcat浏览器自动打开http://localhost:8080/项目名/能看到登录页就算部署成功了。3. DAO 层拆解BorrowDAO、BookDAO、ReaderDAO 到底怎么串起来的3.1 实体类与 DAO 的对应关系这份源码的类文件清单其实已经把分层结构说清楚了。实体类有Book、Reader、Manager、Borrow对应的 DAO 是BookDAO、ReaderDAO、ManagerDAO、BorrowDAO另外还有一个ReaderTypeDAO管读者类型BorrowForm是借阅表单的封装类。典型的 DAO 模式实体类只负责承载数据DAO 类负责所有 SQL 操作JSP 页面通过调用 DAO 方法拿数据再渲染。以BookDAO为例常见的方法签名包括public ListBook findAll(); public Book findById(int id); public boolean insert(Book book); public boolean update(Book book); public boolean delete(int id); public ListBook searchByTitle(String keyword);BorrowDAO会多一层业务逻辑比如借书时要同时做两件事往borrow表插一条借阅记录同时把book表的可借数量减一。这两步要么都成功要么都回滚所以BorrowDAO里通常能看到手动控制事务的代码Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 插入借阅记录 String sql1 INSERT INTO borrow(reader_id, book_id, borrow_date, status) VALUES(?,?,?,?); PreparedStatement ps1 conn.prepareStatement(sql1); ps1.setInt(1, readerId); ps1.setInt(2, bookId); ps1.setDate(3, new java.sql.Date(System.currentTimeMillis())); ps1.setString(4, BORROWED); ps1.executeUpdate(); // 更新图书可借数量 String sql2 UPDATE book SET available available - 1 WHERE id ? AND available 0; PreparedStatement ps2 conn.prepareStatement(sql2); ps2.setInt(1, bookId); int affected ps2.executeUpdate(); if (affected 0) { throw new RuntimeException(库存不足); } conn.commit(); } catch (Exception e) { if (conn ! null) conn.rollback(); e.printStackTrace(); } finally { DBUtil.close(conn); }这段代码的关键在于available 0这个条件。如果只写WHERE id ?并发借书时可能出现库存减到负数的情况。加上这个条件后executeUpdate返回 0 就说明库存不够主动抛异常触发回滚。这是这份源码里比较扎实的一个细节很多课程设计级别的项目不会处理。3.2 JSP 页面如何调用 DAO 并展示数据JSP 页面里通常用两种方式拿 DAO 返回的数据一种是在% %脚本块里直接调另一种是用 JSTL 的c:forEach遍历。这份源码大概率是前者因为老项目用脚本块的居多。典型写法% page importcom.library.dao.BookDAO % % page importcom.library.entity.Book % % page importjava.util.List % % BookDAO bookDAO new BookDAO(); ListBook books bookDAO.findAll(); % table trth书名/thth作者/thth可借数量/th/tr % for (Book b : books) { % tr td% b.getTitle() %/td td% b.getAuthor() %/td td% b.getAvailable() %/td /tr % } % /table这里有个性能问题值得注意每次刷新页面都会新建一个BookDAO实例并执行一次全表查询。数据量小的时候无所谓但如果book表有几千条记录页面会明显变慢。改进方向是在 DAO 里加分页查询findAll改成findByPage(int page, int size)SQL 里加LIMIT。这是从课程设计走向实际项目必须迈的一步。另外JSP 里直接new BookDAO()意味着 JSP 和 DAO 强耦合。如果后面想换成 Spring 管理 Bean这些 JSP 都得改。更常见的做法是在 Servlet 里调 DAO把结果request.setAttribute后转发到 JSPJSP 只负责展示。这份源码如果用的是纯 JSP 模式那它的定位就是教学演示不是生产级架构。4. 避坑与排查部署运行阶段最容易卡住的五个地方4.1 现象Tomcat 启动报 ClassNotFoundException: com.mysql.jdbc.Driver原因MySQL 驱动 jar 没放进WEB-INF/lib或者放进去但没加到 Build Path。Eclipse 里 Build Path 加了但部署时没勾选到 Tomcat 的 lib 里也会出现这个问题。解决确认WEB-INF/lib下有mysql-connector-java-5.1.x.jar或mysql-connector-java-8.0.x.jar。右键项目 → Properties → Deployment Assembly → 确认 lib 目录映射到了/WEB-INF/lib。如果用的是 MySQL 8.0驱动类名改成com.mysql.cj.jdbc.Driver。4.2 现象页面中文显示乱码数据库里查出来是问号原因三个环节的字符集没统一——JSP 页面编码、Tomcat 请求编码、MySQL 连接编码。解决JSP 页面头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %JDBC URL 里加useUnicodetruecharacterEncodingutf8MySQL 建库时用utf8mb4。如果还乱检查 Tomcat 的conf/server.xml里 Connector 有没有URIEncodingUTF-8。4.3 现象Eclipse 里 Run on Server 找不到项目原因项目不是 Dynamic Web Project 类型或者 Targeted Runtime 没勾。解决右键项目 → Properties → Project Facets → 确认 Dynamic Web Module 勾上版本选 3.0 或 3.1。然后 Targeted Runtimes 里勾 Tomcat。如果 Project Facets 里改不了说明项目导入时被识别成了普通 Java 项目需要新建一个 Dynamic Web Project 再把源码拷进去。4.4 现象借阅功能报错提示外键约束失败原因borrow表的外键指向reader和book插入借阅记录时reader_id或book_id在对应表里不存在。解决先确认读者和图书数据已经录入。如果是从 SQL 脚本导入的测试数据检查脚本里reader和book的插入语句是否在borrow之前执行。外键约束的顺序不能乱。4.5 现象修改 JSP 后刷新浏览器没变化原因Tomcat 默认不自动重载 JSP 修改或者浏览器缓存了旧页面。解决Eclipse 里双击 Tomcat 服务器确认 Publishing 选的是 Automatically publish when resources change。浏览器用 CtrlF5 强制刷新。如果还不行右键 Tomcat → Clean重新发布。5. 二次开发切入点从改一个查询到加一个完整模块5.1 先跑通一个最小改动给图书列表加分页拿到一份能跑的源码第一步不是大改而是找一个小功能验证自己理解了数据流。分页是个合适的切入点。在BookDAO里加一个方法public ListBook findByPage(int page, int size) { ListBook list new ArrayList(); String sql SELECT * FROM book ORDER BY id LIMIT ? OFFSET ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, size); ps.setInt(2, (page - 1) * size); ResultSet rs ps.executeQuery(); while (rs.next()) { Book b new Book(); b.setId(rs.getInt(id)); b.setTitle(rs.getString(title)); b.setAuthor(rs.getString(author)); b.setAvailable(rs.getInt(available)); list.add(b); } } catch (SQLException e) { e.printStackTrace(); } return list; }然后在 JSP 里接收page参数默认 1调用findByPage(page, 10)。再在页面底部加「上一页 / 下一页」链接链接里带上?page% page1 %。这个改动虽小但把 DAO 查询、JSP 传参、页面渲染整条链路都走了一遍。5.2 加一个「借阅历史」页面需要动哪些文件如果要加一个读者查看自己借阅历史的页面需要新增或修改这些文件文件作用BorrowDAO.java加findByReaderId(int readerId)方法borrow_history.jsp新建页面调 DAO 拿数据并渲染表格reader_menu.jsp在读者菜单里加「借阅历史」链接web.xml如果用 Servlet 转发需要配 url-patternBorrowDAO里的查询要关联book表拿书名SELECT b.id, bk.title, b.borrow_date, b.return_date, b.status FROM borrow b JOIN book bk ON b.book_id bk.id WHERE b.reader_id ? ORDER BY b.borrow_date DESC这个查询用到了 JOIN结果集不是单一实体能承载的常见做法是建一个BorrowDetail值对象或者直接用MapString, Object接收。我一般会建一个简单的 VO 类字段和查询列一一对应这样 JSP 里取值类型明确不容易出错。5.3 从 JSP 脚本块迁移到 Servlet JSTL 的思路如果打算把这个项目改造成更规范的 MVC迁移路径是JSP 里的new DAO()全部去掉改成 Servlet 接收请求、调 DAO、request.setAttribute存数据、forward到 JSP。JSP 里用 JSTL 的c:forEach替代脚本块。web.xml里配 Servlet 映射或者用WebServlet注解。这一步做完项目结构就从「JSP 为中心」变成了「Servlet 为中心」后面接 Spring MVC 会顺很多。改的时候注意WEB-INF/lib里要加jstl.jar和standard.jarJSP 头部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。这两个 jar 的版本要和 Tomcat 版本匹配Tomcat 9 用 JSTL 1.2 没问题Tomcat 8.5 用 1.2 也行。5.4 数据库连接池从 DriverManager 到 Druid 的最小改动这份源码大概率用的是DriverManager.getConnection()每次请求都新建连接。改成连接池只需要动DBUtil一个类private static DataSource dataSource; static { try { Properties props new Properties(); props.load(DBUtil.class.getClassLoader().getResourceAsStream(db.properties)); dataSource DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); }db.properties里加initialSize5、maxActive20、maxWait3000。改完之后DAO 层的代码一行不用动因为getConnection()的签名没变。这就是面向接口编程的好处。Druid 的 jar 包丢进WEB-INF/lib重启 Tomcat 就能生效。从那以后我每次拿到一份能跑的 JavaWeb 源码都强制自己先不改业务代码而是把数据库连接池换掉、把 JSP 里的脚本块清一遍、再加一个分页查询。这三步走完项目的骨架就摸清了后面加功能心里有底。希望这份拆解能帮你少走点弯路。本文还有配套的精品资源点击获取