简介面向Java Web课程设计、毕业设计与图书馆信息化入门实践的一套完整源码包围绕图书信息、读者账户、借阅归还与权限管理展开采用Servlet/JSP/JavaBean与MySQL实现典型的MVC分层。压缩包共209个文件约1.91MB以51个JSP页面、32个Java源文件与32个class文件为主体另含MySQL数据表文件、9个依赖jar、SQL脚本及properties、tld、xml等配置覆盖视图、业务逻辑、数据库与部署环节。已有359人学习适合需要对照完整项目理解请求流转、数据库表关联、登录会话与JSTL/EL用法的读者。源码保留DAO、实体类与表单对象等分层结构可据此梳理图书、读者、借阅模块的CRUD实现并借助附带数据库文件快速还原运行环境用于课程作业改造或二次开发参考。1. 别急着双击从 zip 到可登录后台先判断这份 JavaWeb 图书馆系统源码能不能跑把 zip 解压之后看到一堆.jsp、.java、web.xml和sql文件很多人第一反应是找main方法结果当然找不到。这不是一个双击就能启动的桌面程序而是一套典型的 JavaWeb 图书馆管理系统源码MySQL 版本靠 Servlet 容器跑起来。它适合课程设计、毕业设计原型、JavaWeb 全链路练手也适合想补“登录、CRUD、借还书、分页、权限过滤”这条线的人。判断它能不能用先看三件事WEB-INF/lib下有没有数据库驱动src里有没有 JDBC 工具类或db.properties根目录有没有.sql建库脚本。三样齐了基本具备本地复现条件缺驱动可以补缺 SQL 文件就得从实体类反推表结构成本立刻上去。下面按“拆骨架、搭环境、跑业务、排坑、二次验收”的顺序走尽量让你少在 404 和中文乱码上耗时间。2. 拆包看骨架JSPServletJDBC 分层、web.xml 与数据库连接的落点2.1 目录结构不是玄学WEB-INF、lib、src、sql 各自管什么老式 JavaWeb 项目最常见的结构是 Eclipse Dynamic Web Project 或 IDEA Web 项目src放 Java 源码WebContent或web放 JSP、CSS、JSWEB-INF放web.xml和libsql放建库脚本。别小看目录名导入 IDE 后 404 多半是 Web 根目录指错了。先把压缩包解压到纯英文路径路径里不要带空格和中文后面 Tomcat 部署会少一个玄学问题。LibrarySystem/ ├── src/ │ ├── com/library/bean/ # 实体类Book、User、Borrow │ ├── com/library/dao/ # DAOJDBC 增删改查 │ ├── com/library/servlet/ # Servlet接收请求、调 DAO、转发 JSP │ └── com/library/util/ # DBUtil、分页工具、编码过滤器 ├── WebContent/ │ ├── WEB-INF/ │ │ ├── web.xml # Servlet 映射、欢迎页、过滤器 │ │ └── lib/ # mysql-connector-java-*.jar │ ├── admin/ # 后台 JSP │ ├── login.jsp │ └── index.jsp └── sql/library.sql # 建库、建表、初始数据这份结构不是强制标准但能帮你快速定位业务入口在servletSQL 在dao连接参数在util或db.properties。如果lib下没有驱动 jar不要急着从不明来源下载优先用本机 Maven 仓库或 MySQL 官方驱动包版本与 MySQL 服务端匹配即可。常见做法是 MySQL 5.7 配 5.1.x 驱动MySQL 8.0 配 8.0.x 驱动驱动类名分别是com.mysql.jdbc.Driver和com.mysql.cj.jdbc.Driver写错就是ClassNotFoundException。2.2 从 login.jsp 到 UserServlet一次请求怎么穿过三层别一上来改业务先跟着登录请求走一遍。login.jsp表单提交到LoginServletServlet 取username、password调UserDao.findByUsernameAndPassword()DAO 用PreparedStatement查user表查到就写session重定向到后台首页查不到就转发回登录页带错误提示。这条链路跑通说明容器、数据库、驱动、Session 都是活的。// LoginServlet 的核心逻辑省略异常处理 protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); // 先设请求编码再取参数 String username req.getParameter(username); String password req.getParameter(password); UserDao userDao new UserDao(); User user userDao.login(username, password); // 内部用 PreparedStatement if (user ! null) { req.getSession().setAttribute(loginUser, user); resp.sendRedirect(req.getContextPath() /admin/index.jsp); } else { req.setAttribute(msg, 用户名或密码错误); req.getRequestDispatcher(/login.jsp).forward(req, resp); } }逻辑说明先setCharacterEncoding再取参数顺序反了中文用户名可能已经乱码登录成功用sendRedirect避免刷新重复提交失败用forward保留请求属性。参数说明req.getContextPath()拿到项目上下文部署名改了也不用手改跳转路径session里存的 key 要和后台 JSP 里取的 key 一致常见是loginUser或user不一致就是“登录成功但后台一直跳登录页”。2.3 数据库连接与事务边界JDBC 工具类要改哪几个参数连接参数一般集中在DBUtil或db.properties。你要改的只有四项URL、用户名、密码、驱动类。URL 里最容易翻车的是时区和编码MySQL 8.0 常见写法要带serverTimezoneAsia/Shanghai老项目如果没带插入datetime可能报时区错误useUnicodetruecharacterEncodingUTF-8用于避免存取中文乱码。不要直接把生产库密码写进代码课程设计也养成放配置文件、加注释的习惯。# db.properties 常见写法按本机实际情况改 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/library?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码// DBUtil 读取配置并获取连接省略 close 封装 static { try (InputStream in DBUtil.class.getClassLoader() .getResourceAsStream(db.properties)) { Properties props new Properties(); props.load(in); Class.forName(props.getProperty(jdbc.driver)); url props.getProperty(jdbc.url); username props.getProperty(jdbc.username); password props.getProperty(jdbc.password); } catch (Exception e) { throw new ExceptionInInitializerError(数据库配置加载失败: e.getMessage()); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, username, password); }逻辑说明静态块只加载一次驱动和配置getResourceAsStream从类路径找db.properties放在src根下即可。参数说明Class.forName在 JDBC 4.0 之后理论上可省略但老项目显式写更稳useSSLfalse只为本地调试减少证书干扰别照搬到线上。事务边界要放在 Service 或 Servlet 的一次业务操作里借书时“插借阅记录 扣库存”必须同一个ConnectionsetAutoCommit(false)后统一commit异常rollback。如果每个 DAO 方法各自拿连接事务是假的库存扣了记录没插后面只能人肉对账。3. 把环境搭起来JDK、Tomcat、MySQL 与 IDE 的版本取舍和导入步骤3.1 版本组合与坑位JDK8/Tomcat8.5/MySQL5.7 还是 8.0这类 JSPServlet 项目我一般先按 JDK8 Tomcat8.5 MySQL5.7 试因为老web.xml、老 JSP 标签、老驱动在这套组合下兼容性最好。不是绝对但能少踩javax.servlet包名、Unsupported major.minor version、JSP 编译级别不一致的坑。如果你本机只有 MySQL8.0也能跑注意驱动换 8.0.x、URL 加时区、driver写com.mysql.cj.jdbc.Driver。JDK 高于 8 时先看项目编译级别别让 IDE 用 17 编译、Tomcat 用 8 跑。组件保守组合说明JDK8老 JSP/Servlet 项目兼容性最好Tomcat8.5支持 Servlet 3.1web.xml写法通用MySQL5.7 或 8.08.0 要换驱动、加时区IDEIDEA/Eclipse能配 Artifact 或 Deployment Assembly 即可提示不要同时装多个 Tomcat 还都开 8080启动日志里Address already in use先查端口不要先怀疑代码。3.2 建库、导 SQL、改 db.properties三步让项目连上本地库先建库再导表。用命令行或客户端都行命令行更直观登录 MySQLsource指向解压后的sql文件。导入后use library; show tables;确认表存在。常见表有user、book、borrow、category字段名以 SQL 文件为准不要凭实体类猜。然后改db.properties的库名、用户名、密码库名要和 SQL 文件里的CREATE DATABASE或USE一致。# 登录 MySQL 后执行路径换成你解压后的 sql 文件 mysql -u root -p CREATE DATABASE IF NOT EXISTS library DEFAULT CHARACTER SET utf8mb4; USE library; SOURCE D:/work/LibrarySystem/sql/library.sql; SHOW TABLES;逻辑说明先显式建库并指定字符集避免 SQL 文件里没写库名时导到别的库SOURCE是 MySQL 客户端命令不是 SQL 语句路径用正斜杠或双反斜杠。参数说明utf8mb4比utf8更稳能存 emoji 和生僻字如果 SQL 文件里已有CREATE DATABASE重复执行可能报库已存在先看文件头再决定是否手动建。导完一定要抽查book表有没有初始数据空表登录进去看不到书不一定是查询写错。3.3 IDEA/Eclipse 导入与 Artifact 部署context path 和端口别撞车IDEA 导入时选“从现有源码导入”把src标成 Sources RootWebContent或web标成 Web Resource DirectoryWEB-INF/lib里的 jar 加进模块依赖。然后配 Tomcat ServerDeployment 里加 ArtifactApplication context 建议设成/library别用/否则 JSP 里写死的/admin/...路径可能对不上。Eclipse 则是 Dynamic Web Project 的 Deployment Assembly把src编译输出和WebContent映射到/。!-- web.xml 里至少确认 welcome-file 和 servlet 映射 -- welcome-file-list welcome-filelogin.jsp/welcome-file /welcome-file-list servlet servlet-nameLoginServlet/servlet-name servlet-classcom.library.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping逻辑说明welcome-file决定访问http://localhost:8080/library/时先打开哪个页面url-pattern决定表单action写/login还是/loginServlet。参数说明如果项目用注解WebServlet(/login)web.xml里重复映射会冲突二者留一种JSP 里的action${pageContext.request.contextPath}/login比写死/library/login更耐改。部署后先访问欢迎页能出登录框再谈登录逻辑出不来先看 Tomcat 日志里项目有没有启动成功。4. 核心业务跑通图书 CRUD、借阅归还、分页搜索与权限拦截4.1 图书表与借阅表怎么关联外键、状态字段和库存扣减图书馆系统的核心不是“能增删改查图书”而是“借出去还能还回来库存和记录对得上”。常见设计是book表存stock或totalborrow表存book_id、user_id、borrow_time、return_time、status。借书时先查库存是否大于 0再插借阅记录、扣库存还书时更新借阅状态、回加库存。外键看项目 SQL 有没有建没建也要在代码里保证book_id存在否则借阅记录就是孤儿数据。-- 借书前的库存检查与扣减实际要放在同一事务里 SELECT id, stock FROM book WHERE id ? FOR UPDATE; UPDATE book SET stock stock - 1 WHERE id ? AND stock 0; INSERT INTO borrow(user_id, book_id, borrow_time, status) VALUES (?, ?, NOW(), BORROWED);逻辑说明FOR UPDATE在事务里锁住当前图书行防止两个人同时借最后一本stock 0是第二次防线更新影响行数为 0 就说明库存没了直接回滚。参数说明status用枚举字符串或数字都行关键是全项目统一JSP 显示时别一个地方写1一个地方写BORROWED。如果项目没有stock字段而是用total - 已借数实时算SQL 会复杂一些但事务边界同样不能少。4.2 分页查询的 SQL 与 Servlet 参数page、pageSize 和总数图书列表不分页数据一多就卡演示也难看。分页公式很固定page从 1 开始pageSize默认 10offset (page - 1) * pageSize。先COUNT(*)拿总数算总页数再LIMIT offset, pageSize拿当前页。Servlet 里对page做空值和越界保护别让用户手改 URL 传page-1把 SQL 搞崩。// BookServlet 列表方法的核心参数处理 int page 1; int pageSize 10; String pageStr req.getParameter(page); if (pageStr ! null pageStr.matches(\\d)) { page Integer.parseInt(pageStr); } int total bookDao.count(keyword); int totalPages (total pageSize - 1) / pageSize; if (page 1) page 1; if (page totalPages totalPages 0) page totalPages; ListBook books bookDao.findPage(keyword, (page - 1) * pageSize, pageSize); req.setAttribute(books, books); req.setAttribute(page, page); req.setAttribute(totalPages, totalPages); req.getRequestDispatcher(/admin/bookList.jsp).forward(req, resp);逻辑说明matches(\\d)过滤负数和非数字totalPages用向上取整避免 11 条数据只显示 1 页越界回正防止空页。参数说明keyword要同时传给count和findPage否则总数和列表对不上LIMIT的两个参数在 MySQL 里是offset, size别写成page, pageSize。JSP 里翻页链接要带keyword不然搜完点下一页搜索条件丢了。4.3 借书还书为什么要放事务里伪代码与回滚点借还书是典型的多表操作最怕“借阅记录插了、库存没扣”或者“库存扣了、记录没插”。把两次写操作放进同一个Connection关自动提交成功一起提交失败一起回滚。下面用伪代码表达重点是连接传递和异常回滚不要在每个 DAO 里各自getConnection()。Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); int updated bookDao.decreaseStock(conn, bookId); // stock - 1 if (updated 0) { throw new RuntimeException(库存不足); } borrowDao.insert(conn, userId, bookId); // 插借阅记录 conn.commit(); } catch (Exception e) { if (conn ! null) conn.rollback(); throw new ServletException(借书失败, e); } finally { DBUtil.close(conn); // 记得恢复 autoCommit 再关 }逻辑说明decreaseStock返回影响行数0 表示库存不足或书不存在直接抛异常触发回滚insert和decreaseStock必须接收同一个conn。参数说明finally里关闭连接前最好setAutoCommit(true)如果项目用了连接池不恢复会影响下一个借连接的人。还书同理更新borrow.status和book.stock 1要在一个事务里别只改状态不还库存。4.4 登录与权限过滤Filter 拦 /admin/* 的最小实现后台页面不能靠“登录后不显示链接”来保护直接输 URL 也能进。加一个Filter拦/admin/*从session取登录用户没有就重定向到登录页。过滤器在web.xml里配或者用WebFilter注解。注意放行登录页、静态资源和登录 Servlet别把登录请求也拦了否则永远登不进去。WebFilter(/admin/*) public class AdminFilter implements Filter { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; Object user req.getSession().getAttribute(loginUser); if (user null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }逻辑说明WebFilter(/admin/*)只拦后台路径登录页和前台不受影响取不到用户就重定向return防止继续往下走。参数说明loginUser要和登录 Servlet 里存的 key 完全一致如果项目还有管理员和普通用户角色在 Filter 里再加角色判断别只判断有没有登录。过滤器生效前提是web.xml的metadata-complete没设为true否则注解不扫描。5. 避坑与排查中文乱码、驱动报错、404/500、日期与金额的 5 个血泪现场5.1 中文乱码request、response、JDBC URL、JSP 四处都要对齐现象登录页输入中文书名能查到但新增图书后列表里显示问号或者表单提交的中文参数到 Servlet 变成乱码。原因通常不是一处而是请求编码、响应编码、数据库连接编码、JSP 页面编码四个地方各说各话。解决顺序是先看request.setCharacterEncoding(UTF-8)有没有在取参数前执行再看 JSP 顶部pageEncodingUTF-8然后看 JDBC URL 有没有characterEncodingUTF-8最后看库和表是不是utf8mb4。% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %// 过滤器里统一设编码比每个 Servlet 手写更稳 req.setCharacterEncoding(UTF-8); resp.setContentType(text/html;charsetUTF-8);逻辑说明JSP 的pageEncoding管源文件编译编码contentType管响应头过滤器统一处理能避免漏改某个 Servlet。参数说明Tomcat8 之后 GET 请求默认按 UTF-8 解老 Tomcat7 可能还要在server.xml的 Connector 上加URIEncodingUTF-8。如果只有 POST 乱、GET 不乱优先查请求体编码如果数据库里已经是问号改代码也救不回来只能重新录入。5.2 ClassNotFound/驱动版本mysql-connector 放哪、Driver 写什么现象启动或第一次连库时报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver或者No suitable driver found。原因无非三种驱动 jar 没放进WEB-INF/lib放进了但没加到部署产物驱动版本和类名不匹配。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver还写老类名就可能找不到。解决确认 jar 在WEB-INF/libIDEA 的 Artifact 里能看到db.properties的jdbc.driver改成对应类名URL 加serverTimezone。检查顺序 1. WEB-INF/lib 下有没有 mysql-connector-java-*.jar 2. IDEA - Project Structure - Artifacts - WEB-INF/lib 是否包含该 jar 3. db.properties 的 driver 与 jar 版本是否匹配 4. 重启 Tomcat不要只点重新部署逻辑说明很多“明明放了 jar 还报错”是 Artifact 没包含lib编译能过、运行找不到。参数说明不要同时放 5.1 和 8.0 两个驱动类路径冲突时谁先加载看运气useSSLfalse只建议本地用线上按实际证书配置。改完配置一定重启容器热部署对WEB-INF/lib不一定生效。5.3 404 与 500context path、web.xml、异常栈先看哪一行现象访问http://localhost:8080/library/login.jsp报 404或者登录后 500页面只给一句“服务器内部错误”。原因404 多半是 context path 不对、Web 根目录没映射、JSP 放错位置500 要看 Tomcat 日志里第一行Caused by常见是空指针、SQL 语法错、列名不对。解决先访问http://localhost:8080/看 Tomcat 首页再访问项目根看欢迎页500 去logs/localhost.*.log找异常栈从最底层Caused by往上读。# Linux/macOS 下快速看日志尾部 tail -n 100 tomcat/logs/localhost.$(date %Y-%m-%d).log逻辑说明404 是路径问题500 是代码或 SQL 问题别混在一起猜日志里java.sql.SQLSyntaxErrorException通常直接告诉你哪个表或列不存在。参数说明context path在 IDEA 的 Deployment 里改改完浏览器地址也要跟着改JSP 放在WEB-INF下不能被浏览器直接访问这是正常的要通过 Servlet 转发。5.4 日期与库存借阅时间、归还状态、并发扣减的坑现象借书后borrow_time显示成前一天或0000-00-00还书后库存加了两次两个人同时借最后一本库存变成 -1。原因日期字段用java.util.Date和java.sql.Date混用、时区不一致还书逻辑没判断当前状态重复点击重复加库存扣库存没加stock 0条件或没锁行。解决数据库用DATETIMEJava 用LocalDateTime或java.sql.TimestampJDBC URL 统一时区还书先UPDATE borrow SET statusRETURNED WHERE id? AND statusBORROWED影响行数为 1 才加库存借书用事务加FOR UPDATE或stock 0条件更新。-- 还书先改状态成功才加库存 UPDATE borrow SET status RETURNED, return_time NOW() WHERE id ? AND status BORROWED; -- 影响行数为 1 再执行 UPDATE book SET stock stock 1 WHERE id ?;逻辑说明状态条件保证重复还书不会重复加库存两条 SQL 仍要放同一事务。参数说明NOW()用数据库时间比 Java 端new Date()更少时区争议如果项目字段是return_date不是return_time以 SQL 文件为准别照抄。5.5 SQL 注入与 XSS课程设计里最容易被忽略的两处现象搜索框输入 OR 11能把所有书查出来图书简介里写一段script列表页弹窗。原因DAO 用字符串拼接 SQLJSP 用${book.desc}直接输出没转义。解决所有带参数的 SQL 用PreparedStatement不要拼where name like % keyword %JSP 输出用c:out value${book.desc}/或fn:escapeXml。课程设计也要养成习惯后面加评论、公告功能时更明显。// 错误写法拼接 SQL String sql select * from book where name like % keyword %; // 正确写法占位符 String sql select * from book where name like ?; ps.setString(1, % keyword %);逻辑说明PreparedStatement会把参数当数据而不是 SQL 片段%由 Java 拼在参数值里不破坏 SQL 结构。参数说明LIKE的%不要拼进 SQL 字符串如果项目用 MyBatis#{}是预编译${}是拼接搜索框别用${}。XSS 方面后台录入的简介、公告都要在输出时转义别只在保存时替换几个字符。6. 二次开发与验收把课程设计改成能演示的图书馆系统6.1 加一个借阅历史查询从 SQL 到 JSP 的最小改动想加“我的借阅历史”不用动大架构。先写 SQL 联表查borrow关联book按user_id和借阅时间倒序DAO 加一个findByUserIdServlet 从 session 取用户 id塞进 requestJSP 用c:forEach渲染。改动点控制在三处别顺手重构登录演示前重构是大忌。SELECT b.id, bk.name AS book_name, b.borrow_time, b.return_time, b.status FROM borrow b JOIN book bk ON b.book_id bk.id WHERE b.user_id ? ORDER BY b.borrow_time DESC;逻辑说明联表拿书名前端不用再根据book_id查一次ORDER BY让最近借的在前。参数说明user_id从 session 取不要从 URL 传否则改个参数就能看别人的借阅记录。JSP 里状态用c:choose转成“借阅中/已归还”比直接显示BORROWED更像演示。6.2 验收清单10 分钟走完登录、检索、借还、权限验收项操作通过标准登录正确/错误密码各一次正确进后台错误有提示图书检索搜书名关键字、翻页结果和总数一致翻页不丢条件借书借一本有库存的书借阅记录新增库存减 1还书重复点还书只加一次库存状态正确权限退出后直接访问/admin/index.jsp跳回登录页乱码新增中文书名并搜索列表显示正常这张表我一般演示前走一遍比临时点页面稳。尤其“重复还书”和“退出后直接访问后台”两个点最容易在答辩时被问到。6.3 我踩过的部署习惯每次改配置先备份、先看日志从那以后我每次改db.properties、web.xml或驱动版本都先复制一份.bak再重启 Tomcat 看日志第一屏。因为 JavaWeb 项目的故障经常不是代码写错而是部署产物没更新、端口被占、驱动没进lib。先看日志能省掉一半“重启试试”的时间。希望帮到你。本文还有配套的精品资源点击获取