JavaWeb图书馆管理系统源码解析：Servlet+JSP+MySQL实战与二次开发

简介这份资源是面向Java Web初学者与课程设计者的图书馆管理系统完整源码包基于Servlet、JSP与JavaBean技术栈配合MySQL数据库实现图书信息、读者账户与借阅记录的管理适合用于毕业设计参考、框架入门练习或二次开发。压缩包共209个文件约1.91MB以51个jsp页面、32个java源文件与32个class编译文件为主体另含gif、jpg等界面素材myd、frm、myi等MySQL数据文件以及jar依赖、properties配置、tld标签库与sql建库脚本覆盖从视图到持久层的完整结构。内容预览可见BookDAO、ReaderDAO、BorrowDAO等数据访问类与Book、Reader、Borrow等实体类体现MVC分层与数据库CRUD的典型写法。已有361人学习下载可帮助读者理解请求转发与重定向、session认证授权、JSTL与EL表达式等要点并借助现成表结构与部署配置快速跑通项目、对照排查问题。1. 接手一套 JavaWeb 图书馆管理系统它到底能解决什么问题毕业设计选题、课程设计验收、小型院校的图书借阅台账这三类场景里最常被翻出来的就是一套能跑通的 JavaWeb 图书馆管理系统。这份源码包给的是一个 MySQL 版本的完整工程覆盖图书信息维护、读者档案、借阅归还、逾期处理这条主线前端是 JSP 页面后端是 Servlet 加 JavaBean数据库落在 MySQL 上。它不适合拿来做高并发架构研究但对需要在一周内把「登录进去、加一本书、借出去、还回来、看到记录」这条链路跑通的人来说价值很直接结构清晰、依赖少、改起来不用先啃三天框架文档。下面按「能干什么 → 怎么跑起来 → 核心代码长什么样 → 怎么改」的顺序拆。2. 技术栈与目录结构一套典型 Servlet JSP MySQL 三层工程2.1 技术选型拆解为什么是这套老组合这套工程的技术栈是 JavaWeb 的经典三件套Servlet 负责请求分发和业务调度JSP 负责页面渲染JavaBean 承担数据载体MySQL 做持久化JDBC 直连数据库。没有 Spring、没有 MyBatis、没有前端构建工具部署形态是标准的 WAR 包丢进 Tomcat。这种选型在今天看确实「老」但它有三个现实优势。第一依赖极少不需要配 Maven 私服、不需要处理依赖冲突把 mysql-connector 的 jar 放进WEB-INF/lib就能跑。第二调试路径短请求从浏览器到 Servlet 再到 JDBC中间没有代理、没有拦截器链出问题一眼能看到堆栈。第三改造成本低想加一个字段改 JSP、改 Servlet、改 DAO、改表结构四步走完不用理解任何框架约定。常见做法是把工程按 MVC 粗分servlet包做控制器dao包封装 SQLbean或entity包放实体类util包放数据库连接工具。JSP 放在WEB-INF之外的目录下通过 Servlet 转发访问避免用户直接敲 JSP 地址绕过权限校验。2.2 目录结构每个包负责什么解压后典型的目录形态如下不同版本命名略有差异但分层逻辑一致LibrarySystem/ ├── src/ │ └── com/library/ │ ├── bean/ # 实体类Book、Reader、BorrowRecord、Admin │ ├── dao/ # 数据访问BookDao、ReaderDao、BorrowDao │ ├── servlet/ # 控制器BookServlet、LoginServlet、BorrowServlet │ └── util/ # DBUtil 数据库连接、编码过滤器 ├── WebContent/ 或 web/ │ ├── WEB-INF/ │ │ ├── web.xml # Servlet 映射、过滤器配置 │ │ └── lib/ # mysql-connector-java-x.x.x.jar │ ├── css/ js/ images/ │ ├── login.jsp │ ├── book_list.jsp │ ├── borrow_list.jsp │ └── reader_list.jsp └── sql/ └── library.sql # 建库建表脚本bean包里的类基本是纯 POJO字段和表字段一一对应提供 getter/setter。dao包是 SQL 的集中地一个实体对应一个 DAO方法名通常是findAll、findById、insert、update、delete。servlet包按业务域拆分每个 Servlet 通过action参数区分具体操作比如BookServlet?actionlist和BookServlet?actionadd。util包里的DBUtil是全项目最该先看懂的一个类所有数据库操作都从它拿连接。提示如果解压后看到的是 Eclipse 工程结构.project、.classpath说明原作者用的是 Eclipse如果是 IDEA 结构.idea、*.iml导入时选「Import Project」而不是「Open」否则依赖识别会出问题。2.3 数据库设计四张核心表撑起业务建表脚本一般在sql/library.sql里核心是四张表。图书表存 ISBN、书名、作者、出版社、库存数量读者表存借书证号、姓名、联系方式、可借上限借阅记录表存图书 ID、读者 ID、借出时间、应还时间、归还时间、状态管理员表存登录账号和密码。关键设计点在借阅记录表它用book_id和reader_id两个外键把图书和读者关联起来status字段区分「借出中」和「已归还」return_date为空表示未还。库存扣减不是靠触发器而是在借书 Servlet 里先查库存再更新这个做法在单机低并发下没问题但并发借同一本书时会超卖后面避坑章节会细说。CREATE TABLE borrow_record ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, reader_id INT NOT NULL, borrow_date DATETIME NOT NULL, due_date DATETIME NOT NULL, return_date DATETIME DEFAULT NULL, status TINYINT DEFAULT 0 COMMENT 0借出中 1已归还, INDEX idx_reader (reader_id), INDEX idx_book (book_id) );这段建表语句里due_date是应还日期通常在借出时按「借出时间 可借天数」算出来写死而不是每次查询时动态计算这样逾期判断只需要比较当前时间和due_date。两个索引分别建在reader_id和book_id上因为「查某个读者的借阅历史」和「查某本书的借阅记录」是两个最高频的查询。status用 TINYINT 而不是字符串省空间也方便加索引。3. 本地跑通从建库到登录成功的完整步骤3.1 环境准备与依赖清单跑这套工程需要三样东西JDK建议 8高版本 JDK 对老 JSP 语法兼容性有坑、Tomcat7 或 8.5 比较稳、MySQL5.7 或 8.0。开发工具用 Eclipse 或 IDEA 都行但要注意工程的编译级别和 Tomcat 的运行 JDK 保持一致。依赖只有一个MySQL 的 JDBC 驱动 jar。如果WEB-INF/lib下已经有mysql-connector-java-5.x.jar直接用如果没有需要自己下载对应版本放进去。MySQL 8.0 必须用 8.x 的驱动5.x 驱动连 8.0 会报Unknown system variable或时区错误。这一步是新手翻车率最高的地方驱动版本和数据库版本必须对齐。3.2 建库导数据与连接配置先建库再导表。用命令行或客户端执行建表脚本mysql -u root -p -e CREATE DATABASE library DEFAULT CHARACTER SET utf8mb4; mysql -u root -p library sql/library.sql第一条命令建库并指定字符集为utf8mb4避免中文书名存进去变问号第二条把脚本里的建表和初始数据导入。如果脚本里已经包含CREATE DATABASE和USE语句第一条可以省略直接执行第二条即可。接着改数据库连接配置。找到DBUtil类里面通常硬编码了四个常量private static final String URL jdbc:mysql://localhost:3306/library?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai; private static final String USER root; private static final String PASSWORD 你的密码; private static final String DRIVER com.mysql.cj.jdbc.Driver;URL里的useUnicode和characterEncoding保证中文不乱码serverTimezone是 MySQL 8 驱动必须带的参数不带会抛时区异常。DRIVER在 MySQL 5.x 驱动下是com.mysql.jdbc.Driver8.x 是com.mysql.cj.jdbc.Driver写错会报ClassNotFoundException。密码改成自己本机的这一步没有玄学就是照着自己环境填。3.3 部署到 Tomcat 并验证登录把工程打成 WAR 或者直接把整个目录拷到 Tomcat 的webapps下启动 Tomcat。访问http://localhost:8080/工程名/login.jsp用脚本里预置的管理员账号登录常见是 admin/123456具体看admin表的初始数据。登录成功后应该能看到图书列表页。如果页面能打开但列表为空先查数据库里book表有没有数据如果登录一直失败看控制台有没有 SQL 异常多半是连接配置或驱动问题。验证链路建议按「登录 → 图书列表 → 新增一本书 → 借阅 → 归还 → 查借阅记录」走一遍这条链路通了说明四个模块的 Servlet、DAO、JSP 都正常。注意Tomcat 启动时如果报ClassNotFoundException: com.mysql.cj.jdbc.Driver不是代码问题是 jar 没放进WEB-INF/lib或者放进去后没重新部署。改完 lib 目录必须重启 Tomcat热部署不会重新加载 jar。4. 核心模块拆解一个借书请求从进入到落库的完整链路4.1 登录鉴权Session 是怎么把用户挡在门外的登录流程是这套系统所有页面的入口。LoginServlet收到账号密码后调AdminDao.findByUsername查库比对密码成功则把用户对象塞进HttpSession失败则转发回登录页带错误提示。protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { String username req.getParameter(username); String password req.getParameter(password); Admin admin adminDao.findByUsername(username); if (admin ! null admin.getPassword().equals(password)) { req.getSession().setAttribute(admin, admin); // 登录态写入 Session resp.sendRedirect(BookServlet?actionlist); // 重定向避免表单重复提交 } else { req.setAttribute(msg, 账号或密码错误); req.getRequestDispatcher(login.jsp).forward(req, resp); } }req.getParameter拿表单字段findByUsername返回 null 表示账号不存在密码用equals明文比对这套工程没做加密后面改造章节会说怎么补。登录成功用sendRedirect而不是forward是为了让浏览器地址栏变成业务页地址刷新时不会重复提交登录表单。Session 里存的 key 是admin其他页面通过一个简单的过滤器或者每个 Servlet 开头判断session.getAttribute(admin) null来决定是否踢回登录页。4.2 图书管理一个 Servlet 用 action 参数分发多种操作图书模块的增删改查都挂在BookServlet上靠action参数分流。这种写法在框架普及前很常见好处是一个业务域只注册一个 Servlet 映射坏处是方法会越写越长。protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { String action req.getParameter(action); if (list.equals(action)) { req.setAttribute(books, bookDao.findAll()); req.getRequestDispatcher(book_list.jsp).forward(req, resp); } else if (delete.equals(action)) { int id Integer.parseInt(req.getParameter(id)); bookDao.delete(id); resp.sendRedirect(BookServlet?actionlist); // 删完回列表 } else if (edit.equals(action)) { int id Integer.parseInt(req.getParameter(id)); req.setAttribute(book, bookDao.findById(id)); req.getRequestDispatcher(book_edit.jsp).forward(req, resp); } }actionlist查全量图书塞进 request 再转发到列表页JSP 里用 JSTL 的c:forEach遍历渲染。actiondelete拿到 id 直接删删完重定向回列表避免用户刷新时重复删除。actionedit先按 id 查出单条记录转发到编辑页回填表单。这里Integer.parseInt没有做空值和格式校验如果 URL 里 id 传了非数字会直接抛NumberFormatException属于这套工程的典型粗糙点二次开发时值得补一层参数校验。4.3 借阅与归还库存扣减和状态流转的关键代码借书是整个系统业务逻辑最重的地方要同时做三件事检查库存、写借阅记录、扣库存。归还则要更新记录状态、回补库存。// 借书核心逻辑BorrowServlet 中 int bookId Integer.parseInt(req.getParameter(bookId)); int readerId Integer.parseInt(req.getParameter(readerId)); Book book bookDao.findById(bookId); if (book.getStock() 0) { req.setAttribute(msg, 库存不足无法借阅); req.getRequestDispatcher(book_list.jsp).forward(req, resp); return; } BorrowRecord record new BorrowRecord(); record.setBookId(bookId); record.setReaderId(readerId); record.setBorrowDate(new Date()); record.setDueDate(DateUtil.addDays(new Date(), 30)); // 默认借期 30 天 record.setStatus(0); borrowDao.insert(record); bookDao.updateStock(bookId, book.getStock() - 1); // 库存减一 resp.sendRedirect(BorrowServlet?actionmyListreaderId readerId);stock是图书表里的库存字段借之前先查小于等于 0 就拦下。due_date用工具类在借出时间上加 30 天这个 30 是硬编码改造时可以提到配置文件里。写记录和扣库存是两次独立的数据库操作中间没有事务包裹如果insert成功但updateStock失败就会出现「有借阅记录但库存没减」的脏数据。归还逻辑对称把status改成 1、填return_date、库存加一。这套写法在单机演示场景够用但生产环境必须加事务后面会讲怎么改。4.4 JSP 渲染层列表页怎么把后端数据铺出来JSP 页面负责把 Servlet 塞进 request 的集合渲染成表格。以图书列表为例核心是 JSTL 的循环标签% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % table trth书名/thth作者/thth库存/thth操作/th/tr c:forEach items${books} varbook tr td${book.bookName}/td td${book.author}/td td${book.stock}/td td a hrefBookServlet?actioneditid${book.id}编辑/a a hrefBookServlet?actiondeleteid${book.id} onclickreturn confirm(确认删除)删除/a /td /tr /c:forEach /table${books}对应 Servlet 里req.setAttribute(books, ...)的 keyvarbook是循环变量${book.bookName}调的是实体类的 getter。删除链接上的onclick做二次确认防止误点。这套渲染方式没有前端框架页面刷新靠整页重载交互体验一般但胜在直观改字段只需要在表格里加一列。5. 避坑与排查这套老工程最容易翻车的五个地方5.1 中文乱码从表单到数据库要过三道关现象是新增的图书书名在列表页显示成问号或乱码。原因通常有三层JSP 页面没声明pageEncodingUTF-8、请求体没设编码、数据库连接串没带字符集参数。解决要三处一起改JSP 头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %在web.xml里配一个CharacterEncodingFilter或者在每个 Servlet 的doPost开头调req.setCharacterEncoding(UTF-8)JDBC URL 带上useUnicodetruecharacterEncodingutf8。三处缺一处都可能乱码这是血泪经验别只改一处就以为好了。5.2 驱动版本不匹配ClassNotFoundException 和时区异常现象是启动后第一次访问数据库就抛ClassNotFoundException或The server time zone value is unrecognized。前者是 jar 没进WEB-INF/lib或驱动类名写错5.x 是com.mysql.jdbc.Driver8.x 是com.mysql.cj.jdbc.Driver后者是 MySQL 8 驱动要求 URL 带serverTimezone参数。解决确认 jar 版本和数据库大版本一致URL 补上serverTimezoneAsia/Shanghai改完重启 Tomcat。5.3 库存超卖并发借书时库存变负数现象是两个人同时借最后一本书两条借阅记录都写成功了库存变成 -1。原因是「查库存」和「扣库存」是两条独立 SQL中间没有锁也没有事务。解决有两个层次简单做法是把扣库存改成带条件的更新UPDATE book SET stock stock - 1 WHERE id ? AND stock 0根据影响行数判断是否成功彻底做法是给借书方法加Transactional或者手动setAutoCommit(false)包住写记录和扣库存两步。演示环境用第一种就够改造时建议上第二种。5.4 直接访问 JSP 绕过登录现象是不登录直接在地址栏敲book_list.jsp也能看到数据。原因是权限校验只写在 Servlet 里JSP 本身没有拦截。解决是把所有业务 JSP 挪进WEB-INF目录下WEB-INF下的资源浏览器无法直接访问只能通过 Servlet 转发或者在web.xml里配一个过滤器统一拦截所有请求检查 Session。前者改动小后者更规范。5.5 删除图书时外键约束报错现象是删除一本有借阅历史的图书时抛 SQL 异常。原因是borrow_record表有book_id外键指向图书表直接删主表记录会被约束拦住。解决有三种改成逻辑删除加is_deleted字段删除只改标记删除前先检查有没有未归还记录有就提示不能删把外键的删除行为改成ON DELETE CASCADE不推荐会连带删掉历史记录。实际项目里我一般选第一种历史数据留着对账有用。6. 二次开发改造从能跑到能用的三个具体切入点拿到这套源码多数人的目标不是原样跑通而是在它基础上加功能或者改造成能交付的版本。下面三个切入点按投入产出比排序都是我自己改这类工程时优先动的。第一个切入点是密码加密。现在管理员密码是明文存库、明文比对改起来不复杂登录时用MessageDigest做 MD5 或者引入 BCrypt 工具存库前加密比对时加密后比较。改动集中在LoginServlet和AdminDao两处初始化数据里的密码也要同步换成密文。这一步做完工程至少不会因为「密码明文」被一眼判不合格。第二个切入点是事务和连接管理。现在的DBUtil大概率是每次操作getConnection再close借书这种多步操作没有事务。改造思路是把DBUtil改成 ThreadLocal 持有连接提供beginTransaction、commit、rollback三个方法在借书和归还的 Servlet 里手动控制。下面是一个最小改造示例public class DBUtil { private static final ThreadLocalConnection HOLDER new ThreadLocal(); public static Connection getConnection() throws SQLException { Connection conn HOLDER.get(); if (conn null || conn.isClosed()) { conn DriverManager.getConnection(URL, USER, PASSWORD); HOLDER.set(conn); } return conn; } public static void begin() throws SQLException { getConnection().setAutoCommit(false); } public static void commit() throws SQLException { getConnection().commit(); getConnection().setAutoCommit(true); } public static void rollback() { try { getConnection().rollback(); } catch (SQLException ignored) {} } public static void close() { try { Connection conn HOLDER.get(); if (conn ! null) { conn.close(); HOLDER.remove(); } } catch (SQLException ignored) {} } }ThreadLocal保证同一个请求线程拿到的连接是同一个begin关掉自动提交业务里两步写操作都成功后调commit任何一步抛异常就在catch里调rollback最后在finally里close。这样借书记录和库存扣减要么都成功要么都回滚超卖问题从根上解决。注意close里必须HOLDER.remove()否则线程池复用线程时会拿到已关闭的连接。第三个切入点是分页。图书列表现在大概率是全量查出来渲染书多了页面会卡。改造分两步DAO 层加findByPage(int page, int size)SQL 用LIMIT ?, ?Servlet 接收页码参数算出总页数塞进 requestJSP 底部加翻页链接。LIMIT的偏移量是(page - 1) * size这个公式别写反写反了第一页会跳过数据。改造点改动文件预估工作量收益密码加密LoginServlet、AdminDao、初始化 SQL半天消除明文存储风险事务管理DBUtil、BorrowServlet一天解决超卖和脏数据列表分页BookDao、BookServlet、book_list.jsp半天大数据量下页面可用改完每个点都要回归验证密码加密后老账号还能不能登、事务改造后借书失败时库存有没有回滚、分页后最后一页数据对不对。我一般会准备一份测试数据专门造「库存为 1 时并发借两次」和「借书过程中手动抛异常」两个场景跑一遍确认回滚生效。从那以后我每次接手这类老 JavaWeb 工程都先把DBUtil和登录逻辑过一遍再动业务代码因为这两处出问题会污染所有后续调试。希望帮到你。本文还有配套的精品资源点击获取