简介基于JavaWeb的图书馆管理系统项目源码采用Servlet、JSP与JDBC经典技术组合按MVC分层模式实现用户注册登录、图书增删改查、借阅归还、超期管理等功能模块系统内置管理员与普通用户双角色适合作JavaWeb课程设计、毕业设计及入门实战参考。压缩包内共199个文件含64个Java源码、51个JSP页面、32个class编译文件另有SQL脚本、properties配置、工程文件与说明文档整体仅766KB可直接导入开发工具运行调试。其中Java源码覆盖DAO、实体与控制层关键类JSP页面对应登录、借阅、管理等视图SQL脚本用于初始化数据表构成完整可运行项目。通过该项目可掌握数据库表设计books、users、borrow_records、密码哈希存储、输入验证防SQL注入、AJAX异步交互等知识并理解Servlet业务控制、JSP视图展示与JDBC数据访问的分层协作。已有五千余人学习浏览是一份从系统设计、编码实现到部署运行全流程的图书馆管理参考案例。1. 你的第一个 JavaWeb 完整项目不是靠“源码”跑通的“基于 javaweb 图书馆管理系统项目源码”是课程设计和毕业设计里最常出现的一类标题同名资源在网上一搜一大把但多数人下载之后卡在同一个地方跑不起来。这篇笔记想讲的不是某个压缩包里的代码怎么抄而是这类项目背后的完整落地路径——从技术选型到建表从 IDEA 配置到部署排错再到怎么把它改造成能写进简历的作品。适合正在做 JavaWeb 课设、刚学完 Servlet 想找个完整案例对照或者拿到源码却不知道怎么下手的读者。先说结论这套系统的技术栈一点都不时髦但它把 JavaWeb 开发里最容易翻车的环节全走了一遍值得认真做一次。2. 从源码反推选型JSPServletTomcatMySQL 为什么是这套系统的标配2.1 为什么图书馆管理系统扎堆在这套技术栈你随便搜几个同名源码包会发现技术栈高度一致JSP Servlet JDBC Tomcat MySQL偶尔加一个 Bootstrap 做前端。这不是巧合。图书馆管理系统的业务模型非常简单——图书、读者、借阅记录、管理员四张表就能装下非常适合做 JavaWeb 课程的完整案例。学校教到 Servlet 和 JSP 阶段还没有来得及讲 Spring这时能拿出来的完整项目就是这种形态。很多人拿到源码第一反应是“这技术栈太老了不如换成 Spring Boot”。这个想法对了一半。如果你是想快速做一个能演示的课设直接用 Spring Boot 重新写确实更快但如果你正在上 JavaWeb 课考核点就是 Servlet 生命周期、Session、Filter、JDBC 这些用 Spring Boot 反而把关键知识点挡住了。我一般会建议先把这个老项目跑通理解每一层在干什么再谈迁移。这套组合能成立还因为它的部署路径最短Tomcat 解压即用MySQL 装好导入 SQLIDEA 配置一个运行环境就能启动不需要 Maven 拉几百个依赖不涉及 Redis、消息队列这些外部组件。对学生来说这意味着出问题的环节少排错路径清晰。对老师来说这意味着代码结构一眼能看出是不是自己写的。2.2 版本搭配与三个必调参数这类源码的坑往往不在代码而在版本搭配。我见过最普遍的问题是拿 JDK 17 Tomcat 10 去跑老源码结果 JSP 文件全部编译失败因为 Tomcat 10 把 Jakarta EE 的包名从javax.*换成了jakarta.*老代码里import javax.servlet.*直接找不到类。这不是代码写错了是环境不匹配。常见的可靠搭配是组件推荐版本说明JDK8 或 11大多数老源码基于 JDK 8 编写11 也可以Tomcat8.5 或 9.08.5 最保险9.0 也行避开 10MySQL5.7 或 8.08.0 要注意驱动版本和时区参数数据库驱动mysql-connector-java 5.1.495.7 库/ 8.0.338.0 库驱动版本和 MySQL 版本不匹配会直接连接失败JSP/Servlet随 Tomcat 版本决定不在代码里手动引入避免冲突有三个参数在运行时最容易出问题拿到源码先检查这三个地方。第一是 JDBC 连接串。MySQL 8.0 必须加useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue否则会报 SSL 连接错误或时区错误。老源码里的连接串往往只有useUnicodetruecharacterEncodingutf8在 5.7 上能用换到 8.0 就报错。第二是 Tomcat 端口。很多源码带的server.xml是 8080但本机可能已经有别的进程占用了 8080启动时一闪而过。第三个是 JSP 页面的编码声明。老项目里有的页面是ISO-8859-1中文全乱码统一改成UTF-8并保证数据库连接串也带characterEncodingutf8。2.3 从源码里能学到的四块内容不要把这套源码当成一个“可以交差的产物”它值得拆开看的地方正好对应 JavaWeb 课程的四个核心考点。第一块是三层结构。Dao 层写 JDBCService 层写业务判断Servlet 层接收请求调用 ServiceJSP 渲染结果。对照自己写的代码很多人会把 SQL 直接写在 Servlet 里这个源码能帮你建立分层的肌肉记忆。第二块是 Filter 与 Session 的配合。图书馆管理系统必然有“未登录不能访问后台”的需求实现方式通常是 Filter 拦截请求、检查 Session 里有没有 user 对象没有就重定向到登录页。这是面试里常问的“如何做登录拦截”源码里有现成答案。第三块是 JDBC 的标准流程DriverManager拿连接、PreparedStatement执行 SQL、处理ResultSet、finally 里关资源。第四块是 JSP 的page指令、include指令和作用域对象request、session、application一个完整的页面集合比零散示例更能说明它们各自的存活范围。2.4 动手前先验证环境两条命令在把源码导入 IDEA 之前先用命令行确认环境和源码假设一致。这一步能省掉后面大半的排错时间。java -version # 输出应类似java version 1.8.0_202 或 openjdk version 11.0.20 # 如果输出版本号是 17 甚至更高后面跑老 JSP 项目大概率要降级 mysql --version # 输出应类似mysql Ver 8.0.33 for Linux on x86_64 # 确认数据库版本后决定用哪个版本的连接驱动确认完版本后再检查一下环境变量JAVA_HOME是否指向实际安装路径。Windows 上常见的问题是JAVA_HOME配了但Path里又有一个更高版本的 java.exe命令行里java -version和 IDEA 里的 JDK 不一致后面会出现“IDEA 编译用的 JDK 和 Tomcat 运行用的 JDK 不一致”这种隐蔽问题。这个检查只需要一分钟但能挡住后面至少一小时的血泪排错。3. 把表结构拆开四张表建模与借书还书的核心逻辑3.1 四张表的建表 SQL 与字段说明图书馆管理系统的数据库设计是整份源码里最值得抄的部分。功能就那些——管理员登录、图书增删改查、读者管理、借书还书——合理的设计用四张表就能表达。下面是精简后的建表 SQL字段名和主流源码基本一致。-- 管理员表登录和权限判断的基础 CREATE TABLE admin ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 图书表藏书信息用于检索与状态判断 CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, book_name VARCHAR(100) NOT NULL, author VARCHAR(50), publisher VARCHAR(100), isbn VARCHAR(20) UNIQUE, total_count INT DEFAULT 1, remain_count INT DEFAULT 1, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 读者表借阅行为的主体字段根据课设要求可增删 CREATE TABLE reader ( id INT PRIMARY KEY AUTO_INCREMENT, reader_name VARCHAR(50) NOT NULL, phone VARCHAR(20), max_borrow_count INT DEFAULT 5, current_borrow_count INT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 借阅记录表一次借书或还书对应一行记录 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, return_time DATETIME NULL, status TINYINT DEFAULT 0 COMMENT 0借出 1已还 2逾期, CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book(id), CONSTRAINT fk_borrow_reader FOREIGN KEY (reader_id) REFERENCES reader(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段 SQL 有两个设计点值得留意。第一book表用total_count和remain_count两个字段表达“总藏书量”和“当前可借量”而不是在借阅时去 count 记录表。这种冗余字段在课设里是允许的因为图书馆场景下查剩余量比维护一致性更频繁牺牲一点冗余换查询简单。第二borrow_record里的status字段用TINYINT而不是字符串值是 0、1、2对应借出、已还、逾期。用数字做状态在代码里要写注释否则看着status2不知道什么意思。大部分源码会在这里踩坑——有的用return_time IS NULL判断是否借出有的用字符串未还/已还都能跑但一旦要加“逾期”概念就要改表结构。用数字状态位是最省事的扩展方案。3.2 登录态拦截一个 Filter 搞定权限图书馆管理系统里最通用的代码是登录拦截。几乎所有页面都需要判断“当前有没有登录用户”没有就跳回登录页。如果每个 Servlet 里都写一遍判断代码会非常脏。正确做法是写一个 Filter 统一拦截。WebFilter(/*) public class LoginFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; // 登录页和登录接口本身放行避免死循环跳转 String uri request.getRequestURI(); if (uri.endsWith(/login.jsp) || uri.endsWith(/login) || uri.endsWith(/css/) || uri.endsWith(/js/)) { chain.doFilter(request, response); return; } // 核心逻辑Session 里没有 user 对象就重定向到登录页 Object user request.getSession().getAttribute(user); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }这段代码有两个关键点。第一是WebFilter(/*)这个注解Servlet 3.0 之后可以用注解代替 web.xml 里的filter配置但很多老源码还在用 web.xml你在 IDEA 里如果看到注解不生效检查一下 web.xml 里是不是也注册了同一个 Filter重复注册会导致拦截两次。第二是放行规则的写法uri.endsWith(/login)这种写法非常脆弱如果项目路径带前缀就会失效。我一般会改成用request.getServletPath()拿不带上下文路径的部分再做判断这样部署时改个应用名不用动代码。这个 Filter 同时也是理解“Filter 在 Servlet 之前的执行时机”的活教材。Filter 的doFilter方法在请求到达 Servlet 之前执行chain.doFilter之后的代码在 Servlet 处理完成后执行。如果在这段代码里加个System.currentTimeMillis()打印你就能直观看到请求链路的时间分布这比读十遍书上的图都管用。3.3 借书还书的 SQL 边界事务比逻辑更关键借书和还书是这份源码里最容易出错的地方也是课设答辩时老师最爱追问的点。先看借书的逻辑把一本书的remain_count减一往borrow_record插入一条记录把读者的current_borrow_count加一。这三个操作必须同时成功或同时失败否则就会出现“书扣了但记录没写”的数据不一致。老源码里很多直接在 Servlet 里连写三条 SQL没有事务演示时没问题数据一多就出脏数据。正确的做法是让 Service 层用 JDBC 事务包住这三条 SQL// 借书事务三个写操作必须在同一个事务里 Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交改手动控制事务边界 // 1. 扣减图书库存带条件更新防止超借 String sqlBook UPDATE book SET remain_count remain_count - 1 WHERE id ? AND remain_count 0; // 2. 插入借阅记录状态为 0借出 String sqlRecord INSERT INTO borrow_record(book_id, reader_id, status) VALUES(?, ?, 0); // 3. 读者已借数量加一 String sqlReader UPDATE reader SET current_borrow_count current_borrow_count 1 WHERE id ?; // 依次执行三条 PreparedStatement // 全部成功才提交 conn.commit(); } catch (SQLException e) { if (conn ! null) { conn.rollback(); // 任何一条失败回滚整个事务 } throw e; } finally { if (conn ! null) { conn.setAutoCommit(true); conn.close(); } }这段代码最值得说的地方是第一句 UPDATE 里的AND remain_count 0。这个条件叫“乐观约束”它保证即使两个请求同时来借同一本书数据库层面也不会把库存扣成负数。如果你的源码里没有这个条件在多人同时操作时会有超借的隐患这也是你在答辩时能主动展示的一个亮点。另外注意setAutoCommit(false)之后finally里要把setAutoCommit(true)恢复否则连接池回收的连接可能带着错误的事务状态导致下一个人拿到连接后操作全部失效。这个问题极其隐蔽不报错但数据就是不对。3.4 页面层用 JSPELJSTL别把 Java 代码堆在页面里拿到源码后打开它的 JSP 页面你会看到两种风格。规范一点的用% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %引入 JSTL页面里用c:forEach遍历数据另一种是把% ListBook books ... %直接写进页面。后者虽然能跑但维护起来非常痛苦而且答辩时老师会直接指出页面里不该写 Java 代码。一个推荐照抄的列表页写法是这样的% page contentTypetext/html;charsetUTF-8 languagejava % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % html body table border1 tr th书名/thth作者/thth剩余数量/thth操作/th /tr c:forEach items${bookList} varbook tr td${book.bookName}/td td${book.author}/td td${book.remainCount}/td tda hrefborrow?bookId${book.id}借阅/a/td /tr /c:forEach /table /body /html这段 JSP 里唯一的动态内容是 EL 表达式${bookList}和${book.bookName}。如果你在源码里看到类似% request.getAttribute(bookList) %的写法建议统一替换成这种形式。这里有个容易错的小细节JSP 页面拿到的bookList必须是 Servlet 里request.setAttribute(bookList, list)设置的而且属性名要对上否则页面会显示空白。很多新手在这里翻车以为 JSP 写错了其实是 Servlet 转发时忘了设置属性。另一个细节是 JSTL 的 taglib 版本老源码用的http://java.sun.com/jsp/jstl/core在 Tomcat 9 上依然有效但如果页面里出现jakarta.tags.core这种新命名空间说明这个项目是按 Jakarta EE 写的和 Tomcat 8.5 不兼容这就是前面说到的版本匹配问题在实际页面上的体现。4. 用 IDEA 把源码跑起来JavaWeb 配置的完整路径4.1 导入前先检查三样东西拿到源码压缩包先别急着往 IDEA 里拖。解压后先检查有没有这三个特征有没有.idea文件夹、有没有pom.xml、有没有web.xml。.idea文件夹说明这份源码是用 IntelliJ IDEA 建的直接Open可以保留原项目的运行配置没有.idea说明你可能需要重新配置整个工程结构。pom.xml存在说明是 Maven 项目不存在说明是传统的 Web 项目这两种工程在 IDEA 里的导入方式完全不一样前者直接Open as Maven Project后者需要新建一个空项目再把源码放进去然后手动配置依赖。第三样是web.xml。如果你拿到的源码在WEB-INF目录下没有web.xml但在代码里用了WebServlet注解那它也能跑如果既没有web.xml也没有注解那这个源码基本是残缺的因为 Servlet 根本没法被映射到 URL。检查完这三样你对这份源码的“体质”就有数了后面在 IDEA 里的每一步操作都有的放矢。检查完这三点我还建议你确认一下源码里的数据库文件。常见源码包会带一个.sql文件放在db或sql目录下。有的源码甚至会在启动时自动建表如果你看到某个 Java 类里有CREATE TABLE IF NOT EXISTS说明这套源码不走手动导入 SQL 的流程。两种流程都要能处理因为最坏的情况是源码里既没有 SQL 文件也没有自动建表代码那你还得自己从实体类反推建表语句。4.2 配置 Tomcat 和 Artifact 的详细步骤IDEA 运行 JavaWeb 项目配置是整个环节里最劝退的地方很多人的源码下到 99%最后 1% 死在这里。下面按 IDEA 2023 版本的常见操作路径写老版本的菜单位置略有差异但不影响理解。第一步打开File - Project Structure - Project确认Project SDK选的是 JDK 8 或 11Language level对应设为8。如果源码是用 Maven 管理的还要在Project Structure - Libraries里确认 Maven 依赖能被正确识别传统 Web 项目则需要手动把 Tomcat 的servlet-api.jar加进 Libraries否则 Filter 和 Servlet 类全部报红。第二步点击工具栏上方的Add Configuration - 加号 - Tomcat Server - Local在Application Server里选你本机的 Tomcat 目录。如果下拉框里没有 Tomcat点Configure手动指定 Tomcat 的根目录。第三步切到Deployment页签点加号选Artifact这里会弹出一个war exploded选项。选war exploded而不是war因为war是打包后部署每次改代码都要重新打包war exploded让 IDEA 直接把编译好的目录映射给 Tomcat改完代码热更新速度快得多。如果没有可选的 Artifact你要先回到Project Structure - Artifacts新建一个Web Application: Exploded在下方Available Elements里把项目的WEB-INF和lib加进去这样 Tomcat 部署时才能找到 JSP 和依赖 jar。最后一步是设置Application context。它表示你的项目访问路径比如填成/library启动后浏览器地址就是http://localhost:8080/library/login.jsp。这里和代码里的一个隐蔽点关联如果 Servlet 代码里写了response.sendRedirect(/login.jsp)注意/开头会直接从根路径走不会带上/library前缀导致跳转 404。这是 JavaWeb 老项目的经典毛病看到 404 先看浏览器地址栏再查代码别一上来就怀疑 Tomcat 没配好。4.3 从报错日志快速定位启动故障Tomcat 启动失败时红色的报错往往是一大段但关键信息就在前几行。最常见的启动故障有三类日志特征非常明显。第一类是Exception in thread main java.lang.ClassNotFoundException: com.mysql.jdbc.Driver说明 JDBC 驱动 jar 没有打进 Artifact。解决方法是打开Project Structure - Artifacts在右边Available Elements里右键你的驱动包选择Put into WEB-INF/lib然后重启。第二类是Port 8080 was already in use可能在运行其他 Tomcat 实例或者其他程序占用了端口直接改 Tomcat 配置里的端口为 8081 是最快的解决办法。第三类是Cannot resolve symbol javax.servlet这通常是编译期报错而不是启动报错说明servlet-api.jar没加入项目依赖Tomcat 已经提供了这个 jar你只需要在Project Structure - Libraries里加上 Tomcat 的lib/servlet-api.jar。这里有一个方便的判断原则编译期报错看Project Structure里的依赖运行期报错看部署到 Tomcat 后的WEB-INF/lib。很多源码导入后IDEA 左侧文件树里能看到了Tomcat 也能启动但一访问就 404此时去Tomcat/webapps/你的项目名/WEB-INF/lib看一眼如果这个目录不存在或者里面没有连接驱动的 jar那问题就出在 Artifact 配置上。这一条能解决 JavaWeb 项目 80% 以上的运行故障。4.4 第一次启动成功后的验证路径启动成功的标志不是 Tomcat 日志里出现Server startup而是浏览器能实际访问到页面。我建议按顺序验证三个地址先访问http://localhost:8080/你的应用名/login.jsp确认页面能渲染出登录表单然后随便输一个不存在的用户名确认能停留在登录页并给出错误提示最后用一个正确的管理员账号登录确认能跳转到后台首页且 URL 里带着;JSESSIONID或者 Cookie 里能看到JSESSIONID的值。JSESSIONID 的出现意味着 Session 机制在正常工作这是整个登录拦截功能的地基。如果登录后刷新一下页面就跳到登录页说明 Session 没有持久化通常是 Tomcat 的会话配置问题检查web.xml里有没有session-config没有就补一个session-timeout30/session-timeout。5. 部署避坑JavaWeb 项目跑不起来的六个常见原因5.1 现象JSP 页面全部 500日志里有Unable to compile class for JSP原因通常是 JDK 版本过高和 Tomcat 版本不匹配的连锁反应。JSP 本质上会在运行时被编译成 Servlet老项目用的 JSTL 依赖在过高版本的 JDK 上无法兼容。解决方法是把 IDEA 里的 Project SDK 和 Tomcat 使用的 JDK 都降到 8 或 11不要只在 IDEA 里改编译级别还要在Project Structure里确认模块的Language level也改成 8。如果还报错检查WEB-INF/lib里是否放入了和 Tomcat 自带的servlet-api.jar冲突的 jar 包把多余的删掉。5.2 现象数据库连接报错Unknown database xxx原因是无脑执行了源码里的建库语句但建库前的CREATE DATABASE语句没执行或者执行了但字符集不对。解决方法是先确认 MySQL 里有没有这个库SHOW DATABASES;查看没有就用CREATE DATABASE 库名 DEFAULT CHARACTER SET utf8mb4;创建然后再执行源码里的建表 SQL。注意 utf8mb4 和 utf8 的差别如果库建成了 utf8而表里设计有 emoji 或特殊字符后面写入会报Incorrect string value重建库改成 utf8mb4 最省心。5.3 现象访问页面后乱码中文全部变成问号原因是请求、响应、数据库三个环节的编码没有统一。先看 JSP 页面第一行的contentType是不是charsetUTF-8再检查web.xml里有没有配置编码过滤器。老项目最容易漏掉的是数据库连接串里的characterEncodingutf8三个环节里任何一环缺了中文就出问题。解决方法是三步齐改页面声明 UTF-8、数据库连接串加参数、数据库表字符集设为 utf8mb4。另外如果表单提交的数据是 GET 请求Tomcat 8 之后默认的 URL 编码是 UTF-8不用额外处理但如果你在 Tomcat 的server.xml里改过URIEncoding一定要确保改成了UTF-8改成别的编码会让 GET 参数里的中文直接变成乱码。5.4 现象日志显示Connections could not be acquired或Access denied for user原因分两类。Access denied是用户名密码不对源码里的DBUtil里写死了root/123456之类和你本机的 MySQL 密码不一致。解决方法是把DBUtil.java或者druid.properties、c3p0-config.xml取决于源码用哪种连接池里的用户名密码改成你自己的一致。另一类Connections could not be acquired是驱动版本和 MySQL 版本不匹配最常见的是 MySQL 8.0 的库用 5.1.x 的驱动连不上。解决方法是把驱动 jar 替换成 8.0.33并同步修改连接串为com.mysql.cj.jdbc.Driver。5.5 现象改完 Java 代码Tomcat 重启后效果没变原因是 IDEA 的 Artifact 没有更新或者部署方式是war而不是war exploded。改代码后 IDEA 会编译但编译后的 class 文件没有进到 Tomcat 的部署目录。解决方法是先Build - Rebuild Project然后停掉 Tomcat在Deployment页签里Redeploy再启动。或者干脆把 Artifact 类型改成war exploded这样每次编译完文件会自动同步。还有一个隐蔽原因是 Tomcat 本身开了多个实例你以为重启的是这个但 IDEA 里跑的是另一个配置文件里的实例检查Application server配置里选中的 Tomcat 路径。5.6 现象登录成功后访问任意后台页面都跳回登录页原因是 Session 里的 key 和代码判断的 key 不一致。源码里登录成功时可能存的是session.setAttribute(user, user)但某个 Servlet 里判断的是session.getAttribute(admin) null两边名字对不上。解决方法是全局搜setAttribute和getAttribute把 key 统一。这种问题在你修改源码、往里面加“管理员/读者”两种角色时特别容易出现因为你可能只改了一个页面的判断逻辑漏了另外三个。建议先做一个静态全局搜索把所有出现user、admin、reader这几个 key 的地方列出来再逐个核对。5.7 排查这类问题的方法论遇到上述任何一个问题不要急着改代码。先看日志DB 问题看驱动类名和连接串JSP 问题看第一行报错404 看 URL 带没带上下文路径。这些判断 10 秒内就能做出来比翻代码快得多。如果日志里什么也没有页面白屏点浏览器 F12 看 Network 标签里那个请求的响应状态500 就是后端异常404 就是路径问题200 但页面空说明 JSP 里 EL 表达式取到的属性是 null去检查 Servlet 里request.setAttribute的 key 和 JSP 里${}是否一致。按这个思路排查JavaWeb 项目的常见问题都能在十分钟内定位。6. 把这份源码改造成能写进简历的作品源码跑通只是起点要让这套图书馆管理系统在课设答辩或简历里站得住脚我建议你做三件“能说出口”的改造。第一件是给借书还书流程加事务和并发约束。先把第 3 章里那三段 SQL 用事务包起来再给book表的remain_count字段加上CHECK (remain_count 0)约束或者用UPDATE ... WHERE remain_count 0这种条件更新。答辩时老师说“两个用户同时借同一本书怎么办”你能说出“数据库层面用行锁配合条件更新”这句话就比大多数同学的答案高一个档次。第二件是把角色从单一管理员拆成管理员、图书管理员、读者三种。老源码里通常只有一个登录入口所有登录用户都拥有全部权限。你可以加一个role字段到用户表在 Filter 里检查role属性对不同的角色限制访问路径。这个改动需要你在LoginFilter里加一个路径和角色的映射表比如/admin/*开头必须 role1/reader/*开头必须 role2。这个小改造在代码量上不大但它把你可能没掌握的角色权限设计变成了简历上的一句项目亮点。第三件是把你对这套系统的理解写进项目说明。我见过太多人简历上写着“图书管理系统”但问数据库表关系答不出问事务边界答不出问为什么用 JSP 而不用前后端分离也答不出。这套系统虽然简单但把它吃透之后你能讲清楚三层结构、Session 管理、事务一致性、数据库表设计这四个面试高频点这比换一个听起来更高级的“微服务图书系统”更有说服力。我的习惯是在源码根目录建一个README.md第一段写清楚环境版本JDK 8、Tomcat 8.5、MySQL 5.7第二段画一个资源流转的说明第三段写清楚每个 Servlet 的 URL 映射和它调用的 Service 方法。这样做的好处是过半年你再打开这个项目不需要重新读一遍代码就能快速想起来整个结构面试前翻一遍自己的笔记比临时抱佛脚看两小时理论强得多。希望这份思路能帮你把“拿到源码”变成“做通一个项目”少走一点弯路。本文还有配套的精品资源点击获取 
长河君 · 2026/9/30 5:36:22 · 阅读 1.2k JavaWeb图书馆管理系统：从源码到部署的完整实战指南
简介基于JavaWeb的图书馆管理系统项目源码采用Servlet、JSP与JDBC经典技术组合按MVC分层模式实现用户注册登录、图书增删改查、借阅归还、超期管理等功能模块系统内置管理员与普通用户双角色适合作JavaWeb课程设计、毕业设计及入门实战参考。压缩包内共199个文件含64个Java源码、51个JSP页面、32个class编译文件另有SQL脚本、properties配置、工程文件与说明文档整体仅766KB可直接导入开发工具运行调试。其中Java源码覆盖DAO、实体与控制层关键类JSP页面对应登录、借阅、管理等视图SQL脚本用于初始化数据表构成完整可运行项目。通过该项目可掌握数据库表设计books、users、borrow_records、密码哈希存储、输入验证防SQL注入、AJAX异步交互等知识并理解Servlet业务控制、JSP视图展示与JDBC数据访问的分层协作。已有五千余人学习浏览是一份从系统设计、编码实现到部署运行全流程的图书馆管理参考案例。1. 你的第一个 JavaWeb 完整项目不是靠“源码”跑通的“基于 javaweb 图书馆管理系统项目源码”是课程设计和毕业设计里最常出现的一类标题同名资源在网上一搜一大把但多数人下载之后卡在同一个地方跑不起来。这篇笔记想讲的不是某个压缩包里的代码怎么抄而是这类项目背后的完整落地路径——从技术选型到建表从 IDEA 配置到部署排错再到怎么把它改造成能写进简历的作品。适合正在做 JavaWeb 课设、刚学完 Servlet 想找个完整案例对照或者拿到源码却不知道怎么下手的读者。先说结论这套系统的技术栈一点都不时髦但它把 JavaWeb 开发里最容易翻车的环节全走了一遍值得认真做一次。2. 从源码反推选型JSPServletTomcatMySQL 为什么是这套系统的标配2.1 为什么图书馆管理系统扎堆在这套技术栈你随便搜几个同名源码包会发现技术栈高度一致JSP Servlet JDBC Tomcat MySQL偶尔加一个 Bootstrap 做前端。这不是巧合。图书馆管理系统的业务模型非常简单——图书、读者、借阅记录、管理员四张表就能装下非常适合做 JavaWeb 课程的完整案例。学校教到 Servlet 和 JSP 阶段还没有来得及讲 Spring这时能拿出来的完整项目就是这种形态。很多人拿到源码第一反应是“这技术栈太老了不如换成 Spring Boot”。这个想法对了一半。如果你是想快速做一个能演示的课设直接用 Spring Boot 重新写确实更快但如果你正在上 JavaWeb 课考核点就是 Servlet 生命周期、Session、Filter、JDBC 这些用 Spring Boot 反而把关键知识点挡住了。我一般会建议先把这个老项目跑通理解每一层在干什么再谈迁移。这套组合能成立还因为它的部署路径最短Tomcat 解压即用MySQL 装好导入 SQLIDEA 配置一个运行环境就能启动不需要 Maven 拉几百个依赖不涉及 Redis、消息队列这些外部组件。对学生来说这意味着出问题的环节少排错路径清晰。对老师来说这意味着代码结构一眼能看出是不是自己写的。2.2 版本搭配与三个必调参数这类源码的坑往往不在代码而在版本搭配。我见过最普遍的问题是拿 JDK 17 Tomcat 10 去跑老源码结果 JSP 文件全部编译失败因为 Tomcat 10 把 Jakarta EE 的包名从javax.*换成了jakarta.*老代码里import javax.servlet.*直接找不到类。这不是代码写错了是环境不匹配。常见的可靠搭配是组件推荐版本说明JDK8 或 11大多数老源码基于 JDK 8 编写11 也可以Tomcat8.5 或 9.08.5 最保险9.0 也行避开 10MySQL5.7 或 8.08.0 要注意驱动版本和时区参数数据库驱动mysql-connector-java 5.1.495.7 库/ 8.0.338.0 库驱动版本和 MySQL 版本不匹配会直接连接失败JSP/Servlet随 Tomcat 版本决定不在代码里手动引入避免冲突有三个参数在运行时最容易出问题拿到源码先检查这三个地方。第一是 JDBC 连接串。MySQL 8.0 必须加useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue否则会报 SSL 连接错误或时区错误。老源码里的连接串往往只有useUnicodetruecharacterEncodingutf8在 5.7 上能用换到 8.0 就报错。第二是 Tomcat 端口。很多源码带的server.xml是 8080但本机可能已经有别的进程占用了 8080启动时一闪而过。第三个是 JSP 页面的编码声明。老项目里有的页面是ISO-8859-1中文全乱码统一改成UTF-8并保证数据库连接串也带characterEncodingutf8。2.3 从源码里能学到的四块内容不要把这套源码当成一个“可以交差的产物”它值得拆开看的地方正好对应 JavaWeb 课程的四个核心考点。第一块是三层结构。Dao 层写 JDBCService 层写业务判断Servlet 层接收请求调用 ServiceJSP 渲染结果。对照自己写的代码很多人会把 SQL 直接写在 Servlet 里这个源码能帮你建立分层的肌肉记忆。第二块是 Filter 与 Session 的配合。图书馆管理系统必然有“未登录不能访问后台”的需求实现方式通常是 Filter 拦截请求、检查 Session 里有没有 user 对象没有就重定向到登录页。这是面试里常问的“如何做登录拦截”源码里有现成答案。第三块是 JDBC 的标准流程DriverManager拿连接、PreparedStatement执行 SQL、处理ResultSet、finally 里关资源。第四块是 JSP 的page指令、include指令和作用域对象request、session、application一个完整的页面集合比零散示例更能说明它们各自的存活范围。2.4 动手前先验证环境两条命令在把源码导入 IDEA 之前先用命令行确认环境和源码假设一致。这一步能省掉后面大半的排错时间。java -version # 输出应类似java version 1.8.0_202 或 openjdk version 11.0.20 # 如果输出版本号是 17 甚至更高后面跑老 JSP 项目大概率要降级 mysql --version # 输出应类似mysql Ver 8.0.33 for Linux on x86_64 # 确认数据库版本后决定用哪个版本的连接驱动确认完版本后再检查一下环境变量JAVA_HOME是否指向实际安装路径。Windows 上常见的问题是JAVA_HOME配了但Path里又有一个更高版本的 java.exe命令行里java -version和 IDEA 里的 JDK 不一致后面会出现“IDEA 编译用的 JDK 和 Tomcat 运行用的 JDK 不一致”这种隐蔽问题。这个检查只需要一分钟但能挡住后面至少一小时的血泪排错。3. 把表结构拆开四张表建模与借书还书的核心逻辑3.1 四张表的建表 SQL 与字段说明图书馆管理系统的数据库设计是整份源码里最值得抄的部分。功能就那些——管理员登录、图书增删改查、读者管理、借书还书——合理的设计用四张表就能表达。下面是精简后的建表 SQL字段名和主流源码基本一致。-- 管理员表登录和权限判断的基础 CREATE TABLE admin ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 图书表藏书信息用于检索与状态判断 CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, book_name VARCHAR(100) NOT NULL, author VARCHAR(50), publisher VARCHAR(100), isbn VARCHAR(20) UNIQUE, total_count INT DEFAULT 1, remain_count INT DEFAULT 1, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 读者表借阅行为的主体字段根据课设要求可增删 CREATE TABLE reader ( id INT PRIMARY KEY AUTO_INCREMENT, reader_name VARCHAR(50) NOT NULL, phone VARCHAR(20), max_borrow_count INT DEFAULT 5, current_borrow_count INT DEFAULT 0 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 借阅记录表一次借书或还书对应一行记录 CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, return_time DATETIME NULL, status TINYINT DEFAULT 0 COMMENT 0借出 1已还 2逾期, CONSTRAINT fk_borrow_book FOREIGN KEY (book_id) REFERENCES book(id), CONSTRAINT fk_borrow_reader FOREIGN KEY (reader_id) REFERENCES reader(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段 SQL 有两个设计点值得留意。第一book表用total_count和remain_count两个字段表达“总藏书量”和“当前可借量”而不是在借阅时去 count 记录表。这种冗余字段在课设里是允许的因为图书馆场景下查剩余量比维护一致性更频繁牺牲一点冗余换查询简单。第二borrow_record里的status字段用TINYINT而不是字符串值是 0、1、2对应借出、已还、逾期。用数字做状态在代码里要写注释否则看着status2不知道什么意思。大部分源码会在这里踩坑——有的用return_time IS NULL判断是否借出有的用字符串未还/已还都能跑但一旦要加“逾期”概念就要改表结构。用数字状态位是最省事的扩展方案。3.2 登录态拦截一个 Filter 搞定权限图书馆管理系统里最通用的代码是登录拦截。几乎所有页面都需要判断“当前有没有登录用户”没有就跳回登录页。如果每个 Servlet 里都写一遍判断代码会非常脏。正确做法是写一个 Filter 统一拦截。WebFilter(/*) public class LoginFilter implements Filter { Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; // 登录页和登录接口本身放行避免死循环跳转 String uri request.getRequestURI(); if (uri.endsWith(/login.jsp) || uri.endsWith(/login) || uri.endsWith(/css/) || uri.endsWith(/js/)) { chain.doFilter(request, response); return; } // 核心逻辑Session 里没有 user 对象就重定向到登录页 Object user request.getSession().getAttribute(user); if (user null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }这段代码有两个关键点。第一是WebFilter(/*)这个注解Servlet 3.0 之后可以用注解代替 web.xml 里的filter配置但很多老源码还在用 web.xml你在 IDEA 里如果看到注解不生效检查一下 web.xml 里是不是也注册了同一个 Filter重复注册会导致拦截两次。第二是放行规则的写法uri.endsWith(/login)这种写法非常脆弱如果项目路径带前缀就会失效。我一般会改成用request.getServletPath()拿不带上下文路径的部分再做判断这样部署时改个应用名不用动代码。这个 Filter 同时也是理解“Filter 在 Servlet 之前的执行时机”的活教材。Filter 的doFilter方法在请求到达 Servlet 之前执行chain.doFilter之后的代码在 Servlet 处理完成后执行。如果在这段代码里加个System.currentTimeMillis()打印你就能直观看到请求链路的时间分布这比读十遍书上的图都管用。3.3 借书还书的 SQL 边界事务比逻辑更关键借书和还书是这份源码里最容易出错的地方也是课设答辩时老师最爱追问的点。先看借书的逻辑把一本书的remain_count减一往borrow_record插入一条记录把读者的current_borrow_count加一。这三个操作必须同时成功或同时失败否则就会出现“书扣了但记录没写”的数据不一致。老源码里很多直接在 Servlet 里连写三条 SQL没有事务演示时没问题数据一多就出脏数据。正确的做法是让 Service 层用 JDBC 事务包住这三条 SQL// 借书事务三个写操作必须在同一个事务里 Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); // 关闭自动提交改手动控制事务边界 // 1. 扣减图书库存带条件更新防止超借 String sqlBook UPDATE book SET remain_count remain_count - 1 WHERE id ? AND remain_count 0; // 2. 插入借阅记录状态为 0借出 String sqlRecord INSERT INTO borrow_record(book_id, reader_id, status) VALUES(?, ?, 0); // 3. 读者已借数量加一 String sqlReader UPDATE reader SET current_borrow_count current_borrow_count 1 WHERE id ?; // 依次执行三条 PreparedStatement // 全部成功才提交 conn.commit(); } catch (SQLException e) { if (conn ! null) { conn.rollback(); // 任何一条失败回滚整个事务 } throw e; } finally { if (conn ! null) { conn.setAutoCommit(true); conn.close(); } }这段代码最值得说的地方是第一句 UPDATE 里的AND remain_count 0。这个条件叫“乐观约束”它保证即使两个请求同时来借同一本书数据库层面也不会把库存扣成负数。如果你的源码里没有这个条件在多人同时操作时会有超借的隐患这也是你在答辩时能主动展示的一个亮点。另外注意setAutoCommit(false)之后finally里要把setAutoCommit(true)恢复否则连接池回收的连接可能带着错误的事务状态导致下一个人拿到连接后操作全部失效。这个问题极其隐蔽不报错但数据就是不对。3.4 页面层用 JSPELJSTL别把 Java 代码堆在页面里拿到源码后打开它的 JSP 页面你会看到两种风格。规范一点的用% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %引入 JSTL页面里用c:forEach遍历数据另一种是把% ListBook books ... %直接写进页面。后者虽然能跑但维护起来非常痛苦而且答辩时老师会直接指出页面里不该写 Java 代码。一个推荐照抄的列表页写法是这样的% page contentTypetext/html;charsetUTF-8 languagejava % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % html body table border1 tr th书名/thth作者/thth剩余数量/thth操作/th /tr c:forEach items${bookList} varbook tr td${book.bookName}/td td${book.author}/td td${book.remainCount}/td tda hrefborrow?bookId${book.id}借阅/a/td /tr /c:forEach /table /body /html这段 JSP 里唯一的动态内容是 EL 表达式${bookList}和${book.bookName}。如果你在源码里看到类似% request.getAttribute(bookList) %的写法建议统一替换成这种形式。这里有个容易错的小细节JSP 页面拿到的bookList必须是 Servlet 里request.setAttribute(bookList, list)设置的而且属性名要对上否则页面会显示空白。很多新手在这里翻车以为 JSP 写错了其实是 Servlet 转发时忘了设置属性。另一个细节是 JSTL 的 taglib 版本老源码用的http://java.sun.com/jsp/jstl/core在 Tomcat 9 上依然有效但如果页面里出现jakarta.tags.core这种新命名空间说明这个项目是按 Jakarta EE 写的和 Tomcat 8.5 不兼容这就是前面说到的版本匹配问题在实际页面上的体现。4. 用 IDEA 把源码跑起来JavaWeb 配置的完整路径4.1 导入前先检查三样东西拿到源码压缩包先别急着往 IDEA 里拖。解压后先检查有没有这三个特征有没有.idea文件夹、有没有pom.xml、有没有web.xml。.idea文件夹说明这份源码是用 IntelliJ IDEA 建的直接Open可以保留原项目的运行配置没有.idea说明你可能需要重新配置整个工程结构。pom.xml存在说明是 Maven 项目不存在说明是传统的 Web 项目这两种工程在 IDEA 里的导入方式完全不一样前者直接Open as Maven Project后者需要新建一个空项目再把源码放进去然后手动配置依赖。第三样是web.xml。如果你拿到的源码在WEB-INF目录下没有web.xml但在代码里用了WebServlet注解那它也能跑如果既没有web.xml也没有注解那这个源码基本是残缺的因为 Servlet 根本没法被映射到 URL。检查完这三样你对这份源码的“体质”就有数了后面在 IDEA 里的每一步操作都有的放矢。检查完这三点我还建议你确认一下源码里的数据库文件。常见源码包会带一个.sql文件放在db或sql目录下。有的源码甚至会在启动时自动建表如果你看到某个 Java 类里有CREATE TABLE IF NOT EXISTS说明这套源码不走手动导入 SQL 的流程。两种流程都要能处理因为最坏的情况是源码里既没有 SQL 文件也没有自动建表代码那你还得自己从实体类反推建表语句。4.2 配置 Tomcat 和 Artifact 的详细步骤IDEA 运行 JavaWeb 项目配置是整个环节里最劝退的地方很多人的源码下到 99%最后 1% 死在这里。下面按 IDEA 2023 版本的常见操作路径写老版本的菜单位置略有差异但不影响理解。第一步打开File - Project Structure - Project确认Project SDK选的是 JDK 8 或 11Language level对应设为8。如果源码是用 Maven 管理的还要在Project Structure - Libraries里确认 Maven 依赖能被正确识别传统 Web 项目则需要手动把 Tomcat 的servlet-api.jar加进 Libraries否则 Filter 和 Servlet 类全部报红。第二步点击工具栏上方的Add Configuration - 加号 - Tomcat Server - Local在Application Server里选你本机的 Tomcat 目录。如果下拉框里没有 Tomcat点Configure手动指定 Tomcat 的根目录。第三步切到Deployment页签点加号选Artifact这里会弹出一个war exploded选项。选war exploded而不是war因为war是打包后部署每次改代码都要重新打包war exploded让 IDEA 直接把编译好的目录映射给 Tomcat改完代码热更新速度快得多。如果没有可选的 Artifact你要先回到Project Structure - Artifacts新建一个Web Application: Exploded在下方Available Elements里把项目的WEB-INF和lib加进去这样 Tomcat 部署时才能找到 JSP 和依赖 jar。最后一步是设置Application context。它表示你的项目访问路径比如填成/library启动后浏览器地址就是http://localhost:8080/library/login.jsp。这里和代码里的一个隐蔽点关联如果 Servlet 代码里写了response.sendRedirect(/login.jsp)注意/开头会直接从根路径走不会带上/library前缀导致跳转 404。这是 JavaWeb 老项目的经典毛病看到 404 先看浏览器地址栏再查代码别一上来就怀疑 Tomcat 没配好。4.3 从报错日志快速定位启动故障Tomcat 启动失败时红色的报错往往是一大段但关键信息就在前几行。最常见的启动故障有三类日志特征非常明显。第一类是Exception in thread main java.lang.ClassNotFoundException: com.mysql.jdbc.Driver说明 JDBC 驱动 jar 没有打进 Artifact。解决方法是打开Project Structure - Artifacts在右边Available Elements里右键你的驱动包选择Put into WEB-INF/lib然后重启。第二类是Port 8080 was already in use可能在运行其他 Tomcat 实例或者其他程序占用了端口直接改 Tomcat 配置里的端口为 8081 是最快的解决办法。第三类是Cannot resolve symbol javax.servlet这通常是编译期报错而不是启动报错说明servlet-api.jar没加入项目依赖Tomcat 已经提供了这个 jar你只需要在Project Structure - Libraries里加上 Tomcat 的lib/servlet-api.jar。这里有一个方便的判断原则编译期报错看Project Structure里的依赖运行期报错看部署到 Tomcat 后的WEB-INF/lib。很多源码导入后IDEA 左侧文件树里能看到了Tomcat 也能启动但一访问就 404此时去Tomcat/webapps/你的项目名/WEB-INF/lib看一眼如果这个目录不存在或者里面没有连接驱动的 jar那问题就出在 Artifact 配置上。这一条能解决 JavaWeb 项目 80% 以上的运行故障。4.4 第一次启动成功后的验证路径启动成功的标志不是 Tomcat 日志里出现Server startup而是浏览器能实际访问到页面。我建议按顺序验证三个地址先访问http://localhost:8080/你的应用名/login.jsp确认页面能渲染出登录表单然后随便输一个不存在的用户名确认能停留在登录页并给出错误提示最后用一个正确的管理员账号登录确认能跳转到后台首页且 URL 里带着;JSESSIONID或者 Cookie 里能看到JSESSIONID的值。JSESSIONID 的出现意味着 Session 机制在正常工作这是整个登录拦截功能的地基。如果登录后刷新一下页面就跳到登录页说明 Session 没有持久化通常是 Tomcat 的会话配置问题检查web.xml里有没有session-config没有就补一个session-timeout30/session-timeout。5. 部署避坑JavaWeb 项目跑不起来的六个常见原因5.1 现象JSP 页面全部 500日志里有Unable to compile class for JSP原因通常是 JDK 版本过高和 Tomcat 版本不匹配的连锁反应。JSP 本质上会在运行时被编译成 Servlet老项目用的 JSTL 依赖在过高版本的 JDK 上无法兼容。解决方法是把 IDEA 里的 Project SDK 和 Tomcat 使用的 JDK 都降到 8 或 11不要只在 IDEA 里改编译级别还要在Project Structure里确认模块的Language level也改成 8。如果还报错检查WEB-INF/lib里是否放入了和 Tomcat 自带的servlet-api.jar冲突的 jar 包把多余的删掉。5.2 现象数据库连接报错Unknown database xxx原因是无脑执行了源码里的建库语句但建库前的CREATE DATABASE语句没执行或者执行了但字符集不对。解决方法是先确认 MySQL 里有没有这个库SHOW DATABASES;查看没有就用CREATE DATABASE 库名 DEFAULT CHARACTER SET utf8mb4;创建然后再执行源码里的建表 SQL。注意 utf8mb4 和 utf8 的差别如果库建成了 utf8而表里设计有 emoji 或特殊字符后面写入会报Incorrect string value重建库改成 utf8mb4 最省心。5.3 现象访问页面后乱码中文全部变成问号原因是请求、响应、数据库三个环节的编码没有统一。先看 JSP 页面第一行的contentType是不是charsetUTF-8再检查web.xml里有没有配置编码过滤器。老项目最容易漏掉的是数据库连接串里的characterEncodingutf8三个环节里任何一环缺了中文就出问题。解决方法是三步齐改页面声明 UTF-8、数据库连接串加参数、数据库表字符集设为 utf8mb4。另外如果表单提交的数据是 GET 请求Tomcat 8 之后默认的 URL 编码是 UTF-8不用额外处理但如果你在 Tomcat 的server.xml里改过URIEncoding一定要确保改成了UTF-8改成别的编码会让 GET 参数里的中文直接变成乱码。5.4 现象日志显示Connections could not be acquired或Access denied for user原因分两类。Access denied是用户名密码不对源码里的DBUtil里写死了root/123456之类和你本机的 MySQL 密码不一致。解决方法是把DBUtil.java或者druid.properties、c3p0-config.xml取决于源码用哪种连接池里的用户名密码改成你自己的一致。另一类Connections could not be acquired是驱动版本和 MySQL 版本不匹配最常见的是 MySQL 8.0 的库用 5.1.x 的驱动连不上。解决方法是把驱动 jar 替换成 8.0.33并同步修改连接串为com.mysql.cj.jdbc.Driver。5.5 现象改完 Java 代码Tomcat 重启后效果没变原因是 IDEA 的 Artifact 没有更新或者部署方式是war而不是war exploded。改代码后 IDEA 会编译但编译后的 class 文件没有进到 Tomcat 的部署目录。解决方法是先Build - Rebuild Project然后停掉 Tomcat在Deployment页签里Redeploy再启动。或者干脆把 Artifact 类型改成war exploded这样每次编译完文件会自动同步。还有一个隐蔽原因是 Tomcat 本身开了多个实例你以为重启的是这个但 IDEA 里跑的是另一个配置文件里的实例检查Application server配置里选中的 Tomcat 路径。5.6 现象登录成功后访问任意后台页面都跳回登录页原因是 Session 里的 key 和代码判断的 key 不一致。源码里登录成功时可能存的是session.setAttribute(user, user)但某个 Servlet 里判断的是session.getAttribute(admin) null两边名字对不上。解决方法是全局搜setAttribute和getAttribute把 key 统一。这种问题在你修改源码、往里面加“管理员/读者”两种角色时特别容易出现因为你可能只改了一个页面的判断逻辑漏了另外三个。建议先做一个静态全局搜索把所有出现user、admin、reader这几个 key 的地方列出来再逐个核对。5.7 排查这类问题的方法论遇到上述任何一个问题不要急着改代码。先看日志DB 问题看驱动类名和连接串JSP 问题看第一行报错404 看 URL 带没带上下文路径。这些判断 10 秒内就能做出来比翻代码快得多。如果日志里什么也没有页面白屏点浏览器 F12 看 Network 标签里那个请求的响应状态500 就是后端异常404 就是路径问题200 但页面空说明 JSP 里 EL 表达式取到的属性是 null去检查 Servlet 里request.setAttribute的 key 和 JSP 里${}是否一致。按这个思路排查JavaWeb 项目的常见问题都能在十分钟内定位。6. 把这份源码改造成能写进简历的作品源码跑通只是起点要让这套图书馆管理系统在课设答辩或简历里站得住脚我建议你做三件“能说出口”的改造。第一件是给借书还书流程加事务和并发约束。先把第 3 章里那三段 SQL 用事务包起来再给book表的remain_count字段加上CHECK (remain_count 0)约束或者用UPDATE ... WHERE remain_count 0这种条件更新。答辩时老师说“两个用户同时借同一本书怎么办”你能说出“数据库层面用行锁配合条件更新”这句话就比大多数同学的答案高一个档次。第二件是把角色从单一管理员拆成管理员、图书管理员、读者三种。老源码里通常只有一个登录入口所有登录用户都拥有全部权限。你可以加一个role字段到用户表在 Filter 里检查role属性对不同的角色限制访问路径。这个改动需要你在LoginFilter里加一个路径和角色的映射表比如/admin/*开头必须 role1/reader/*开头必须 role2。这个小改造在代码量上不大但它把你可能没掌握的角色权限设计变成了简历上的一句项目亮点。第三件是把你对这套系统的理解写进项目说明。我见过太多人简历上写着“图书管理系统”但问数据库表关系答不出问事务边界答不出问为什么用 JSP 而不用前后端分离也答不出。这套系统虽然简单但把它吃透之后你能讲清楚三层结构、Session 管理、事务一致性、数据库表设计这四个面试高频点这比换一个听起来更高级的“微服务图书系统”更有说服力。我的习惯是在源码根目录建一个README.md第一段写清楚环境版本JDK 8、Tomcat 8.5、MySQL 5.7第二段画一个资源流转的说明第三段写清楚每个 Servlet 的 URL 映射和它调用的 Service 方法。这样做的好处是过半年你再打开这个项目不需要重新读一遍代码就能快速想起来整个结构面试前翻一遍自己的笔记比临时抱佛脚看两小时理论强得多。希望这份思路能帮你把“拿到源码”变成“做通一个项目”少走一点弯路。本文还有配套的精品资源点击获取