JSP Servlet图书管理系统毕业设计实战：从环境搭建到答辩避坑

简介这是一套面向高校计算机专业学生与Java Web初学者的图书管理系统完整项目可直接用于毕业设计、课程大作业或自学练手。系统基于JSP、Servlet、Layui与MySQL开发运行于IDEA、JDK1.8、MySQL5.7及Tomcat9环境界面美观且带公告功能。功能按角色划分用户可查看公告、浏览图书与个人违章图书管理员负责借还图书及借阅、还书报表系统管理员则管理书籍、借阅规则并进行图书信息查询与借阅统计。资源包共1046个文件约40.91MB包含212个Java源文件、156个JSP页面、120个JS脚本、57个CSS样式及3个SQL脚本另附源码、数据库与配套文档结构完整便于二次开发。目前已有93人学习下载适合需要完整赛题方案、模块化代码参考与数据库设计思路的读者可快速理解三层架构与权限控制逻辑。1. 图书管理系统为什么还在用 JSP Servlet一次讲清它的真实定位如果你正在翻毕业设计选题看到「java web图书管理系统jsp servlet界面美观带公告」这类描述第一反应大概是这技术栈是不是太老了Spring Boot 都出到 3.x 了谁还手写 Servlet但现实是每年计算机毕业设计里JSP Servlet 的图书管理系统依然是高频选题原因很直接——它能把 Java Web 的核心链路完整暴露给你请求怎么进来、Session 怎么管、JDBC 怎么连、页面怎么渲染全是你自己写的没有框架帮你兜底。答辩老师问「你这个登录是怎么实现的」你能从doPost一路讲到数据库查询而不是一句「Spring Security 配的」。这篇笔记面向两类人一是要交毕业设计或大作业、需要一套能跑通、能讲清、界面不丑的图书管理系统的同学二是想回头补 Java Web 基础、理解 Model2 思想到底怎么回事的开发者。我会按「环境怎么搭 → 数据库怎么设计 → 核心功能怎么写 → 界面怎么做得不像十年前 → 公告模块怎么加 → 怎么排查翻车」的顺序把一套可复现的方案讲透。不吹架构不堆术语只讲你照着敲能跑起来的东西。2. 环境搭建与项目骨架从零到第一个能跑的 Servlet2.1 JDK、Tomcat、IDE 的版本选择与目录结构这套技术栈的版本兼容性比你想的敏感。我一般用 JDK 8 或 JDK 11 配 Tomcat 8.5 或 9.0这是最稳的组合。JDK 17 配 Tomcat 10 也能跑但 Tomcat 10 把javax.servlet换成了jakarta.servlet网上大部分 JSP Servlet 教程还是javax包名你照着抄会一片红。毕业设计求稳别追新。IDE 用 IntelliJ IDEA 社区版够用Eclipse 也行。项目结构用标准 Web 项目布局BookManage/ ├── src/ │ └── com/book/ │ ├── dao/ # 数据库操作 │ ├── entity/ # 实体类 │ ├── servlet/ # 控制器 │ └── util/ # 工具类 ├── web/ │ ├── css/ │ ├── js/ │ ├── WEB-INF/ │ │ ├── web.xml │ │ └── lib/ # 放 mysql-connector-java.jar │ └── index.jspWEB-INF下的内容浏览器访问不到这是 Servlet 规范的安全设计JSP 放这里只能通过 Servlet 转发访问。lib目录放 MySQL 驱动 jar 包别忘了 Add as Library。2.2 用 Maven 管理依赖还是手动导 jar手动导 jar 不是不行但毕业设计代码要交给老师看Maven 的pom.xml一眼就能看出你用了什么。核心依赖就三个dependencies !-- Servlet APIscope 必须是 provided因为 Tomcat 自带 -- dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency !-- JSP API同样 provided -- dependency groupIdjavax.servlet.jsp/groupId artifactIdjavax.servlet.jsp-api/artifactId version2.3.3/version scopeprovided/scope /dependency !-- MySQL 驱动这个要打包进去 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.28/version /dependency /dependenciesscope写provided是关键否则 Tomcat 启动时类冲突报ClassCastException你都找不到原因。这是血泪经验我见过太多人卡在这里。2.3 第一个 Servlet用注解还是 web.xml 配置Servlet 3.0 以后可以用WebServlet注解不用再写web.xml。两种方式我都写过注解更简洁但web.xml能让你看清 URL 映射的全貌。毕业设计建议用注解代码少答辩时也好讲。package com.book.servlet; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.*; import java.io.IOException; // 映射路径浏览器访问 /login 就会进这个 Servlet WebServlet(/login) public class LoginServlet extends HttpServlet { Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // GET 请求直接转发到登录页 req.getRequestDispatcher(/login.jsp).forward(req, resp); } Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 设置编码必须在获取参数之前 req.setCharacterEncoding(UTF-8); String username req.getParameter(username); String password req.getParameter(password); // 这里先写死后面接数据库 if (admin.equals(username) 123456.equals(password)) { HttpSession session req.getSession(); session.setAttribute(user, username); resp.sendRedirect(req.getContextPath() /book/list); } else { req.setAttribute(msg, 用户名或密码错误); req.getRequestDispatcher(/login.jsp).forward(req, resp); } } }doGet和doPost分开写是规范做法。setCharacterEncoding必须在getParameter之前调用否则中文乱码。sendRedirect和forward的区别要搞清楚前者是浏览器重新发请求地址栏变后者是服务器内部转发地址栏不变。登录成功用重定向防止刷新重复提交。3. 数据库设计与 JDBC 封装图书、用户、公告三张表怎么建3.1 表结构设计与字段类型选择图书管理系统的核心就三张表用户表、图书表、公告表。别一上来就搞十几张表毕业设计够用就行逻辑清晰比表多重要。CREATE DATABASE book_db DEFAULT CHARACTER SET utf8mb4; USE book_db; -- 用户表 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role TINYINT DEFAULT 0 COMMENT 0普通用户 1管理员, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 图书表 CREATE TABLE book ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, author VARCHAR(50), price DECIMAL(10,2), stock INT DEFAULT 0, category VARCHAR(50), cover VARCHAR(200) COMMENT 封面图片路径, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 公告表 CREATE TABLE notice ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, content TEXT, publisher VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP );字符集用utf8mb4而不是utf8因为utf8在 MySQL 里存不了 emoji公告里如果有人发了表情符号就翻车。price用DECIMAL不用FLOAT金额计算不能有精度损失。cover存图片相对路径不存二进制图片文件放服务器目录。3.2 JDBC 工具类一个能复用的连接管理方案每个 Servlet 都写一遍DriverManager.getConnection是灾难。抽一个工具类出来package com.book.util; import java.sql.*; public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/book_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8; private static final String USER root; private static final String PASSWORD your_password; static { try { Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { throw new RuntimeException(MySQL驱动加载失败, e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } // 关闭资源顺序不能错ResultSet - PreparedStatement - Connection public static void close(Connection conn, PreparedStatement ps, ResultSet rs) { try { if (rs ! null) rs.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (ps ! null) ps.close(); } catch (SQLException e) { e.printStackTrace(); } try { if (conn ! null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }URL 里的serverTimezoneAsia/Shanghai不加会报时区错误MySQL 8 的驱动必须指定。useSSLfalse是关掉 SSL 警告本地开发无所谓。关闭顺序必须是 ResultSet → PreparedStatement → Connection反过来会报错。3.3 用 PreparedStatement 写增删改查以图书查询为例package com.book.dao; import com.book.entity.Book; import com.book.util.DBUtil; import java.sql.*; import java.util.ArrayList; import java.util.List; public class BookDao { // 查询所有图书支持按书名模糊搜索 public ListBook findAll(String keyword) { ListBook list new ArrayList(); String sql SELECT * FROM book WHERE name LIKE ? ORDER BY id DESC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % (keyword null ? : keyword) %); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Book b new Book(); b.setId(rs.getInt(id)); b.setName(rs.getString(name)); b.setAuthor(rs.getString(author)); b.setPrice(rs.getBigDecimal(price)); b.setStock(rs.getInt(stock)); b.setCategory(rs.getString(category)); b.setCover(rs.getString(cover)); list.add(b); } } } catch (SQLException e) { e.printStackTrace(); } return list; } // 新增图书 public boolean insert(Book b) { String sql INSERT INTO book(name, author, price, stock, category, cover) VALUES(?,?,?,?,?,?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, b.getName()); ps.setString(2, b.getAuthor()); ps.setBigDecimal(3, b.getPrice()); ps.setInt(4, b.getStock()); ps.setString(5, b.getCategory()); ps.setString(6, b.getCover()); return ps.executeUpdate() 0; } catch (SQLException e) { e.printStackTrace(); return false; } } }用 try-with-resources 自动关资源比手动 close 干净。PreparedStatement的?占位符是防 SQL 注入的核心千万别用字符串拼接。setBigDecimal对应DECIMAL类型别用setDouble。4. 界面美观的实现路径JSP 页面怎么摆脱「十年前」的观感4.1 用 Bootstrap 5 快速搭出干净的列表页和表单页JSP 本身只是模板技术界面丑不丑取决于你用什么 CSS 框架。Bootstrap 5 是最省事的选择CDN 引入不用构建工具。图书列表页% page contentTypetext/html;charsetUTF-8 languagejava % % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % !DOCTYPE html html head meta charsetUTF-8 title图书列表/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body div classcontainer mt-4 div classd-flex justify-content-between align-items-center mb-3 h3图书管理/h3 form classd-flex action${pageContext.request.contextPath}/book/list methodget input classform-control me-2 typesearch namekeyword placeholder搜索书名 button classbtn btn-primary typesubmit搜索/button /form /div table classtable table-hover align-middle thead classtable-light tr th封面/thth书名/thth作者/thth价格/thth库存/thth操作/th /tr /thead tbody c:forEach items${bookList} varb tr tdimg src${pageContext.request.contextPath}/${b.cover} width50 height65 styleobject-fit:cover/td td${b.name}/td td${b.author}/td td${b.price}/td td c:choose c:when test${b.stock 0} span classbadge bg-success${b.stock}/span /c:when c:otherwise span classbadge bg-danger缺货/span /c:otherwise /c:choose /td td a href${pageContext.request.contextPath}/book/edit?id${b.id} classbtn btn-sm btn-outline-primary编辑/a a href${pageContext.request.contextPath}/book/delete?id${b.id} classbtn btn-sm btn-outline-danger onclickreturn confirm(确定删除)删除/a /td /tr /c:forEach /tbody /table /div /body /htmlJSTL 的c:forEach和c:choose是 JSP 里做逻辑判断的标准方式比在页面里写 Java 代码块% %干净得多。${pageContext.request.contextPath}拿项目根路径避免部署路径变化导致 404。封面图用object-fit:cover保证不变形。4.2 登录页和公告栏的视觉细节登录页是老师第一眼看到的页面值得多花十分钟。用 Bootstrap 的卡片组件居中布局加个渐变背景div classd-flex justify-content-center align-items-center vh-100 stylebackground: linear-gradient(135deg, #667eea 0%, #764ba2 100%); div classcard shadow-lg stylewidth: 380px; div classcard-body p-4 h4 classtext-center mb-4图书管理系统/h4 c:if test${not empty msg} div classalert alert-danger py-2${msg}/div /c:if form action${pageContext.request.contextPath}/login methodpost div classmb-3 label classform-label用户名/label input typetext nameusername classform-control required /div div classmb-3 label classform-label密码/label input typepassword namepassword classform-control required /div button typesubmit classbtn btn-primary w-100登 录/button /form /div /div /div公告栏放在首页顶部用 Bootstrap 的 alert 或者 card 都行。关键是公告内容要支持换行显示用white-space: pre-wrap样式否则数据库里存的换行符在页面上会被吞掉。4.3 分页查询别让列表页一次性加载几千条图书多了以后列表页会卡分页是必须的。核心 SQL 用LIMIT和OFFSETpublic ListBook findByPage(int page, int size, String keyword) { ListBook list new ArrayList(); String sql SELECT * FROM book WHERE name LIKE ? ORDER BY id DESC LIMIT ? OFFSET ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % (keyword null ? : keyword) %); ps.setInt(2, size); ps.setInt(3, (page - 1) * size); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { // 映射逻辑同上 } } } catch (SQLException e) { e.printStackTrace(); } return list; }page从 1 开始OFFSET是(page-1)*size。前端传页码后端算偏移量。总页数用SELECT COUNT(*)单独查一次别用List.size()那是当前页的数量不是总数。5. 公告模块与权限控制让系统看起来「完整」的两个关键点5.1 公告的增删改查与首页展示公告模块代码量和图书模块几乎一样但它是让系统显得完整的关键。老师看毕业设计最怕的就是「只有增删改查图书」。加一个公告首页就能有动态内容答辩时也多个功能点讲。公告的 Servlet 和 Dao 照着图书的写就行注意首页展示时只取最新 5 条public ListNotice findLatest(int limit) { ListNotice list new ArrayList(); String sql SELECT * FROM notice ORDER BY create_time DESC LIMIT ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, limit); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Notice n new Notice(); n.setId(rs.getInt(id)); n.setTitle(rs.getString(title)); n.setContent(rs.getString(content)); n.setPublisher(rs.getString(publisher)); n.setCreateTime(rs.getTimestamp(create_time)); list.add(n); } } } catch (SQLException e) { e.printStackTrace(); } return list; }首页 JSP 里用c:forEach渲染标题加链接跳详情页。公告内容在详情页用c:out value${notice.content} escapeXmlfalse/输出escapeXmlfalse允许 HTML 标签生效但要注意 XSS 风险毕业设计里自己发的公告无所谓生产环境必须过滤。5.2 用 Filter 做登录拦截和角色判断没有权限控制的系统是不完整的。写一个 Filter拦截所有/book/*和/notice/*路径检查 Session 里有没有用户WebFilter(urlPatterns {/book/*, /notice/*, /user/*}) public class AuthFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; HttpSession session req.getSession(false); // 放行登录页和登录接口 String uri req.getRequestURI(); if (uri.endsWith(/login) || uri.endsWith(/login.jsp)) { chain.doFilter(request, response); return; } if (session null || session.getAttribute(user) null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } // 管理员才能进用户管理 if (uri.contains(/user/) !1.equals(String.valueOf(session.getAttribute(role)))) { resp.sendError(403, 无权限访问); return; } chain.doFilter(request, response); } }getSession(false)表示没有 Session 就返回 null不新建。chain.doFilter是放行不调用就中断了。角色判断用 Session 里存的 role 值登录成功时一起存进去。5.3 文件上传图书封面的处理封面图片上传用 Servlet 3.0 的MultipartConfig注解WebServlet(/book/upload) MultipartConfig(maxFileSize 2 * 1024 * 1024) // 最大 2MB public class UploadServlet extends HttpServlet { protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { Part part req.getPart(cover); String fileName System.currentTimeMillis() _ part.getSubmittedFileName(); // 存到 web 目录下的 upload 文件夹 String savePath req.getServletContext().getRealPath(/upload); File dir new File(savePath); if (!dir.exists()) dir.mkdirs(); part.write(savePath File.separator fileName); resp.getWriter().write(upload/ fileName); } }getRealPath拿到的是服务器上的绝对路径部署到 Tomcat 后指向webapps/项目名/upload。文件名加时间戳防止重名覆盖。maxFileSize限制大小超了会抛异常前端也要做校验。6. 避坑与排查JSP Servlet 项目最容易翻车的五个地方6.1 中文乱码POST 和 GET 要分开处理现象表单提交中文数据库里存的是???或者乱码。原因POST 请求默认用 ISO-8859-1 解码GET 请求在 Tomcat 8 以后默认 UTF-8 但 URL 编码方式不同。解决POST 在 Servlet 第一行写req.setCharacterEncoding(UTF-8)GET 如果乱码在 Tomcat 的server.xml里给 Connector 加URIEncodingUTF-8。JSP 页面头部% page contentTypetext/html;charsetUTF-8 %也要写对。数据库连接 URL 加characterEncodingutf8。四个地方都对了才不会乱码。6.2 404路径到底该不该带项目名现象页面跳转 404但手动输地址又能访问。原因sendRedirect和forward的路径规则不一样。sendRedirect是浏览器行为需要带项目名forward是服务器行为不带项目名。解决统一用req.getContextPath()拼路径。重定向写resp.sendRedirect(req.getContextPath() /book/list)转发写req.getRequestDispatcher(/book/list.jsp).forward(req, resp)。JSP 里的链接也用${pageContext.request.contextPath}开头。6.3 Session 失效登录后刷新就退出了现象登录成功点几个页面后突然跳回登录页。原因Session 默认 30 分钟过期或者浏览器禁用了 Cookie 导致 JSESSIONID 丢失。解决检查web.xml里的session-config配置毕业设计可以设长一点比如 60 分钟。如果是 Cookie 问题用 URL 重写resp.encodeURL()兜底。另外session.invalidate()别乱调退出登录时才用。6.4 JDBC 连接泄漏Tomcat 跑一会儿就卡死现象系统运行一段时间后响应越来越慢最后报Too many connections。原因Connection 没关闭每次请求都新建连接数据库连接池耗尽。解决所有 JDBC 操作必须放在 try-with-resources 里或者 finally 块里 close。检查每个 Dao 方法ResultSet、PreparedStatement、Connection 三层都要关。用SHOW PROCESSLIST能看到堆积的连接。6.5 JSTL 标签不生效页面直接输出了${bookList}现象JSP 页面把 EL 表达式原样输出c:forEach也不循环。原因缺少 JSTL 的 jar 包或者% taglib %指令写错。解决Maven 加jstl依赖或者手动放jstl.jar和standard.jar到WEB-INF/lib。taglib 的 uri 写http://java.sun.com/jsp/jstl/core前缀用c。如果还是不行检查web.xml的版本2.3 以下不支持 EL。7. 从能跑到能讲答辩前该做的三件事和一个习惯系统跑起来只是第一步毕业设计答辩才是真正的关卡。我见过太多人代码写得不错但老师一问就说不清。这里给你三个具体动作。第一画一张请求流程图。从浏览器输入 URL 开始经过 Filter、Servlet、Dao、数据库再回到 JSP 渲染每个环节标上你用的类名和方法名。这张图贴在论文里答辩时对着讲老师立刻知道你确实是自己写的。不用画得多漂亮Visio 或者 draw.io 都行关键是链路完整。第二准备三个「为什么」的答案。为什么用 JSP 不用 Thymeleaf为什么用 JDBC 不用 MyBatis为什么 Session 存用户信息不用 Token答案不用多高深比如「JSP 是课程要求的技术栈我想把 Model2 的流程走一遍」「JDBC 能让我看清 SQL 执行的全过程MyBatis 封装太深不适合学习阶段」「Session 是服务端存储毕业设计部署在单台 Tomcat 上够用Token 适合分布式场景但这里用不上」。老师要的是你有思考不是技术多先进。第三把数据库脚本和部署步骤写成 README。很多人代码交上去老师想跑一下发现跑不起来印象分直接扣光。README 里写清楚MySQL 版本、建库脚本路径、数据库账号密码改哪里、Tomcat 版本、访问地址。最好录一个两分钟的屏幕录像从启动到登录到增删改查走一遍放在项目根目录。最后说一个习惯每写完一个功能立刻用浏览器走一遍完整流程别攒到最后一起测。JSP Servlet 项目的错误往往是连锁的一个路径写错后面全 404你根本不知道从哪查起。我一般写完一个 Servlet 就重启 Tomcat点一遍相关页面确认没问题再写下一个。这个习惯看起来慢实际上省下的调试时间远超你的想象。这套方案不复杂但每个环节都有细节。你照着走一遍图书管理系统能跑公告能发权限能控界面不难看答辩能讲清。值不值得做如果你要的是理解 Java Web 的完整链路它比任何框架都直接。希望帮到你。本文还有配套的精品资源点击获取