企业官网建设流程全解析

简介：这是一份基于JSP与MySQL的图书馆借阅管理系统毕业设计文档，面向计算机相关专业学生及需要快速搭建图书管理信息化方案的开发者。文档完整覆盖系统需求分析、B/S架构设计、功能模块划分、数据库设计、系统实现与测试全过程。管理员模块包含用户管理、图书类型管理、图书信息管理、图书借阅/续借/归还管理、缴纳罚金管理、留言板管理等；用户端则提供借阅、续借、归还、罚金及收藏管理等操作，角色划分清晰，业务流程完整。包体为单个docx文档，大小3.67MB，内容含摘要、目录、系统概述、详细设计与实现等章节，可直接参考论文结构或答辩说明。已有54人学习，对正在撰写相关课题论文或设计图书馆管理系统的读者具有直接参考价值，可作为功能设计、技术选型和文档撰写的模板。

1. 图书馆借阅管理系统：JSP + MySQL 的一套完整毕业设计，先搞懂架构再动手

很多同学从网盘里下载到“图书馆借阅管理系统”这套基于 JSP 和 MySQL 的毕业设计，第一反应是直接打开代码找登录逻辑，结果要么数据库连不上，要么 Tomcat 直接报错。这其实不是代码问题，而是没搞明白 JSP 项目的运行链路。这套系统的核心价值不在于代码量多少，而在于它把 B/S 架构的完整流程串通了：浏览器发请求、Servlet 接参数、MySQL 存数据，再配合图书借阅、续借、归还、罚金和留言板这些贴近真实业务的功能模块，刚好覆盖了毕业设计里“需求分析—系统设计—实现—测试”的全部环节。适合需要复现这个项目、或者想在此基础上改造成自己毕设的人。

2. 技术选型与架构拆解：B/S、JSP、MySQL 是怎么把借阅流程串起来的

2.1 B/S 结构的实际分工：浏览器、服务器、数据库各干各的

这套系统选的是 B/S（Browser/Server）架构，和传统的 C/S 相比，最大的区别是用户电脑上不用装任何客户端，只需要一个浏览器。管理员在办公室电脑上打开 Chrome 就能进后台，用户在宿舍也能通过网页查询图书、提交借阅申请，所有逻辑都集中在服务器端，出了问题只改服务器上的代码，不用挨个更新客户端。

B/S 结构一般分成三层：视图层、控制逻辑层、数据层。视图层就是你看到的 JSP 页面，负责把数据展示成表格、表单；控制逻辑层由 Servlet 或者 JSP 里嵌的 Java 代码承担，负责接收前端传过来的参数，调用业务方法；数据层就是 MySQL，负责读写数据。用户在前端点“借阅”按钮，请求会先到控制层，控制层验证参数后再操作数据库，最终把结果返回到页面。这个链路清晰了，后面排查问题就能知道去哪一层找原因。

2.2 JSP 与 Servlet：动态页面和业务逻辑的边界

JSP 本质上是一个 Servlet 的模板，第一次被访问时会编译成 Servlet 再执行。很多教程喜欢在 JSP 页面里直接写<% ... %>塞 Java 代码，但那样后期维护特别痛苦。这套系统里更好的做法是：页面只负责显示，借阅、续借、归还这些操作放到 Servlet 或 JavaBean 里处理。

下面这段是图书列表页面里常见的 JSP 片段，用 JSTL 标签遍历集合，避免在页面里写大段 Java：

<c:forEach items="${bookList}" var="book"> <tr> <td>${book.bookNo}</td> <td>${book.bookName}</td> <td>${book.author}</td> <td>${book.typeName}</td> <td> <a href="${pageContext.request.contextPath}/borrowServlet?id=${book.id}">借阅</a> </td> </tr> </c:forEach>

这段代码里${book.bookNo}是从后台 List 里取对象的属性值，运行时通过 getter 方法拿到。pageContext.request.contextPath是获取项目根路径，避免硬编码路径导致部署后链接失效。点击“借阅”会跳转到 borrowServlet，并把当前图书的 id 传过去。

对应的借阅处理 Servlet 里，一般会先判断用户是否登录，再查这本书的库存和当前借阅记录，最后插入一条借阅记录。这里最容易被忽略的是事务控制——插入借阅记录和扣减库存必须同时成功，否则就会出现“书被借走了但库存还是老样子”的数据不一致问题。常见做法是在 doPost 里调用一个 service 方法，方法上面加@Transactional注解，或者手动conn.setAutoCommit(false)，失败就rollback。

2.3 MySQL 数据库设计：先看借阅状态怎么流转

项目正文里提到了用户、图书馆信息、图书类型、图书信息、借阅、续借、归还、罚金、留言板这些实体，对应的表结构大致可以拆成这几张核心表：用户表、图书表、图书类型表、借阅记录表、罚金记录表、留言表、收藏表。

借阅记录表是整条业务链路的关键，它至少要包含这些字段：记录 id、用户 id、图书 id、借阅时间、应还时间、实际归还时间、续借次数、状态。状态字段建议用 tinyint，0 表示借出中，1 表示已归还，2 表示已续借，后期加“逾期未还”也方便扩展。不要直接用字符串“借出中”存，否则写 SQL 统计逾期记录的时候会非常难受。

下面是我一般会用的建表 SQL，省略了外键约束，改成在应用层维护关联，因为毕业设计里用外键很容易在删除数据时踩到级联坑：

CREATE TABLE `borrow_record` ( `id` int(11) NOT NULL AUTO_INCREMENT, `user_id` int(11) NOT NULL, `book_id` int(11) NOT NULL, `borrow_time` datetime DEFAULT NULL, `due_time` datetime DEFAULT NULL, `return_time` datetime DEFAULT NULL, `renew_count` tinyint(4) DEFAULT '0', `status` tinyint(4) DEFAULT '0', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

这里的due_time是应还时间，通常等于借阅时间加借阅天数；return_time是实际归还时间；status默认 0。后面统计逾期时，直接比较due_time和return_time，如果return_time为空且当前时间大于due_time，就说明这本书已经逾期了。罚金表可以单独建，也可以在归还时根据逾期天数动态计算后写入一条记录，两种方式各有利弊，毕设里用后者更直观。

3. 功能模块落地：管理员和用户的用例怎么映射到具体页面和操作

3.1 管理员端功能清单：十三个模块的权限边界

从摘要里可以看到，管理员功能被拆得很细：主页、个人中心、用户管理、图书馆信息管理、图书类型管理、图书信息管理、图书借阅管理、图书续借管理、图书归还管理、缴纳罚金管理、留言板管理、系统管理、留言管理。这些其实能归纳成三类：基础数据管理、借阅业务管理、交互管理。

基础数据管理负责维护用户、图书馆、图书类型、图书信息的增删改查。借阅业务管理处理借阅、续借、归还和罚金。交互管理则包括留言板和公告。这里容易踩坑的地方是对“图书馆信息管理”的理解——它管理的是图书馆本身的基本信息，比如名称、地址、开放时间，而不是某一本图书的信息，很多同学会把这两个模块混淆，导致菜单都做出来了但业务数据对不上。

3.2 用户端操作流程：借阅、续借、归还、罚金的闭环

用户端的核心操作是“借阅—续借—归还—缴罚金”四步。借阅时用户从图书列表中选择一本书，点击借阅，系统先判断这本书是否可借，然后生成一条借阅记录，状态为借出中。续借操作通常继承了原借阅记录，逻辑是更新due_time往后推 N 天，并把renew_count加一。很多系统会限制续借次数，所以需要在代码里校验renew_count < 2，否则无限续借就失去意义了。

归还操作有两种触发方式：管理员在后台登记归还，或者用户提交归还申请。不论哪种，归还后都要更新return_time和status。如果return_time大于due_time，就计算逾期天数，再乘以单日罚金得出金额，写入罚金记录。用户缴纳罚金后，系统把该笔罚金记录的状态改成已缴，整个闭环才算结束。这里最核心的是日期计算，JSP 页面传来的日期往往是字符串，直接用Date比较容易出问题，建议在 Java 层统一用java.time.LocalDateTime处理，或者干脆在数据库里用DATEDIFF算。

3.3 数据库表之间的关联：从查询索引到状态统计

写这部分是因为很多人在建表之后不会查数据。比如管理员首页要展示“今日借阅人数”“逾期未还数量”“本月罚金总额”，这些统计靠一条 SQL 就能完成，不用在 Java 里循环算。我常用的统计 SQL 是这样的：

SELECT COUNT(DISTINCT user_id) AS borrow_users, SUM(CASE WHEN status = 0 AND due_time < NOW() THEN 1 ELSE 0 END) AS overdue_count, SUM(CASE WHEN return_time > due_time THEN DATEDIFF(return_time, due_time) * 0.5 ELSE 0 END) AS fine_amount FROM borrow_record WHERE borrow_time BETWEEN #{startOfMonth} AND #{endOfMonth};

这条 SQL 里DISTINCT是为了防止同一用户借多本书被重复统计；status = 0 AND due_time < NOW()就是典型的逾期未还判断；罚金用DATEDIFF算天数再乘 0.5，就是每天五毛的意思。如果你接到的项目里有类似的统计需求，直接参考这个写法改表名和字段名就行。还有一点要注意：SUM在没有匹配行时会返回 NULL，所以最好用IFNULL包一层，否则 Java 那边拿到的可能是 null，页面就会显示空白。

3.4 收藏功能的实现细节

用户模块里有一个“我的收藏管理”，这个功能看起来不起眼，但很能体现对关联表的理解。收藏表至少需要有用户 id、图书 id、收藏时间三个字段。当用户点击收藏时，先判断这条记录是否已经存在，避免重复收藏。删除收藏的时候同样要定位到“用户 id + 图书 id”这一对唯一组合，不能只按图书 id 删，否则会把其他人的收藏也删掉。

收藏功能的页面展示通常也是一个表格，点击书名可以跳转回图书详情。这里注意跳转链接要带上图书 id，用getParameter取出来后再查一次库，方便在详情页判断“这本书我是否已经收藏过”，如果有就直接显示“已收藏”按钮并禁用，这个细节很影响用户体验。

4. 本机跑通这个毕设：从环境准备到借出一本书

4.1 环境版本搭配与安装顺序

JSP 项目跑起来需要的环境比 Spring Boot 多一些，因为它要依赖独立的 Tomcat 容器。我一般推荐 JDK 1.8 + Tomcat 8.5 + MySQL 5.7 的组合，这套组合在课程设计里最稳，JDK 版本太高反而容易遇到 JSP 编译兼容问题。MySQL 8.0 也可以用，但驱动要换成com.mysql.cj.jdbc.Driver，URL 里还要加上serverTimezone=Asia/Shanghai，否则连接会报时区错误。

安装顺序别装反：先装 JDK 和 MySQL，再装 Tomcat。因为 Tomcat 启动时要找JAVA_HOME环境变量。MySQL 安装时建议把端口保持默认 3306，字符集选 utf8mb4，不然后面导入 SQL 容易出乱码。装完后在命令行里用java -version和mysql -u root -p分别验证一下，两个都能输出版本号再往下走。

4.2 导入源码与初始化数据库

拿到源码包之后，先看看目录结构。一个规范的 JSP 项目应该有 src 目录存放 Java 源码、web 目录存放 JSP 页面和配置文件、lib 目录存放 jar 包。用 IDE 导入时选 Eclipse 或 IDEA 的“导入现有项目”都行，注意不要直接双击 JSP 文件，那只会看到源码，跑不起来。

数据库初始化分两步。第一步是创建数据库，建议用命令行或者 Navicat 新建一个library库，字符集选utf8mb4。第二步是把项目里的library.sql导入进去。如果没有现成的 SQL 文件，也可以手动执行建表语句，把上一章里的borrow_record表建出来，再补上用户表和图书表的基础字段。导入后用一条查询验证：

SELECT COUNT(*) FROM user;

如果返回 0 说明表建好了，等着插入测试数据。很多项目自带管理员账号，初始密码可能写在 SQL 里或者init语句里，找一下admin相关的 INSERT 语句就行。如果找不到，直接手动插入一条，密码字段一般是 MD5 哈希后的字符串，你可以先用明文登录，进后台再改。

连接数据库的配置文件一般叫db.properties或者jdbc.properties，在 src 目录下。打开后改成你自己的数据库名、用户名、密码：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/library?useUnicode=true&characterEncoding=utf8 jdbc.username=root jdbc.password=123456

配置里useUnicode=true&characterEncoding=utf8是防止中文乱码的关键，少了它，页面显示书名和人名都是问号。如果你用的是 MySQL 8.0，驱动要改成com.mysql.cj.jdbc.Driver，URL 里再加serverTimezone=Asia/Shanghai。

4.3 启动 Tomcat 并验证登录、借阅、归还

把项目部署到 Tomcat 的方式有两种：一是把整个项目文件夹复制到 Tomcat 的webapps目录下，二是用 IDE 配置 Tomcat 运行时启动。毕设答辩一般用第二种更方便，因为它能看到控制台日志。IDEA 里配置 Tomcat 时，Deployment 面板把项目的web目录作为 Web Resource Directory，Application context 填/library。

启动后访问http://localhost:8080/library，如果能跳转到首页，说明环境基本没问题。先用管理员账号登录后台，到图书信息管理里添加一本书，再到前台首页登录用户账号，找到这本书点击借阅。借阅成功后，去后台的借阅管理里应该能看到这条记录，状态是借出中。接着点归还，记录状态的return_time被写上，这时如果系统里设置了罚金参数，而且你是故意逾期归还的，罚金记录也会同步生成。

整套流程走通后，再把用户注册、留言板、收藏这几个次要功能分别点一遍，确认没有跳出 500 错误页。这里尤其要注意 JSP 页面里的表单提交路径，很多项目喜欢用action="login"这种相对路径，如果页面在二级目录下，就会提交到错误地址，建议把 action 写成${pageContext.request.contextPath}/login这种带项目名的绝对路径。

5. 避坑与常见问题排查：五个让 JSP 毕设当场翻车的点

5.1 数据库连接报中文乱码

现象：页面上图书名称、用户姓名都显示成???或者乱码，但数据在数据库里看却是正常的。

原因：数据库连接 URL 里没有设置字符集，MySQL 服务端的character_set_client默认不是 utf8，导致插入的数据变成了乱码。

解决：在db.properties的 URL 末尾追加?useUnicode=true&characterEncoding=utf8，同时确认建库时选的是 utf8mb4。改完配置后重启 Tomcat，删除之前乱码的数据重新插入。如果还是乱码，检查 JSP 页面头部有没有<%@ page contentType="text/html; charset=UTF-8" %>，以及 HTML 的<meta charset="UTF-8">，三者都对齐才稳。

5.2 Tomcat 端口被占用

现象：点击启动后控制台报Port 8080 required by Tomcat v8.5 Server at localhost is already in use，或者浏览器一直打不开页面。

原因：之前有一次没正常关闭 Tomcat，或者别的软件（比如 Oracle、一些网页服务器）占了 8080。

解决：最省事的是换端口，在 Tomcat 的conf/server.xml里把<Connector port="8080"改成 8081，重启后访问http://localhost:8081/library。也可以结束占用进程，Windows 下用netstat -ano | findstr 8080找到占用 PID，再用taskkill /PID 进程号 /F杀掉。注意改端口后，项目里如果有硬编码了 8080 的链接，也要一起改，最好都用相对路径。

5.3 页面报 500 错误，控制台指到某个类找不到

现象：同一个页面，第一次访问正常，带参数访问就报 500，日志里出现ClassNotFoundException或者NoSuchMethodError。

原因：JSP 编译成 Servlet 后找不到对应的 Java 类，多半是项目里 lib 包的 jar 没同步到 Tomcat 的 WEB-INF/lib 目录，或者你改了类名但网站引用还是旧类名。

解决：在 IDE 里执行Build > Rebuild Project，然后看输出目录WEB-INF/classes下有没有对应的.class文件。如果是第三方 jar 缺失，直接把 jar 复制到这个目录下重启。还有一种情况是项目引用了两个不同版本的 jar，比如有两个 mysql 驱动包，删掉旧的那个。

5.4 借阅日期和罚金计算对不上

现象：逾期归还后罚金算出来是 0，或者多算了几天。

原因：借阅时间取的是数据库服务器时间，归还时间是取 Java 本地时间，两边时区不一致。更常见的是借阅天数写死了 30 天，但日历上有大月小月，用Date直接加天数会出现一天误差。

解决：统一用本地时间，Java 一侧用LocalDateTime.now().plusDays(30)计算应还时间，或者干脆在 SQL 里写DATE_ADD(NOW(), INTERVAL 30 DAY)。罚金计算建议用 SQL：

SELECT DATEDIFF(NOW(), due_time) * 0.5 AS fine_amount FROM borrow_record WHERE id = 1 AND return_time IS NULL AND due_time < NOW();

如果返回 NULL，检查这条记录是不是已经设置了return_time，因为逾期罚金只在未归还状态下才计算。

5.5 登录后跳转回登录页，页面一直循环

现象：输入正确的账号密码后，页面刷新一下又回到登录页，但是看一下地址栏，发现 session 已经带了。

原因：登录成功后的跳转链路有问题，常见是登录 Servlet 没有把用户对象放进 session，或者 JSP 页面里每个页面都强制检查 session，但检查用的session.getAttribute("user")和登录时放的 key 不一致。

解决：在登录方法的doPost里加一行session.setAttribute("currentUser", user)，然后所有需要登录的页面统一用这个 key 判断，不要一会儿写user，一会儿写admin。写一个过滤器最省事：

HttpSession session = request.getSession(); if (session.getAttribute("currentUser") == null) { response.sendRedirect(request.getContextPath() + "/login.jsp"); return; }

放行规则要放行 login.jsp、登录 Servlet 和静态资源，不然登录页本身也会被拦截变成死循环。

6. 让系统更像真实产品：三个不增加工作量的小改造

6.1 登录与 Session 校验的统一过滤

毕设项目里很多页面都做了“登录后才能访问”的判断，但每个页面复制粘贴很容易漏掉。与其逐页改，不如写一个 Filter。从 Servlet 3.0 开始可以直接在类上标注@WebFilter("/admin/*")，把管理员后台的路径都包住，校验不到currentUser就重定向到登录页。改造后不需要改原来的 JSP，只要注意放行/admin/login.jsp和静态资源路径，就能少很多越权漏洞。

6.2 图书列表的 SQL 防注入写法

图书查询功能里，如果用户在前台搜索框里输入图书名，后台直接把字符串拼进 SQL，就有注入风险。比如String sql = "select * from book where name='" + keyword + "'"这种写法，输入' or '1'='1就能查出所有书。改成预处理的方式其实很简单：

String sql = "select * from book where name like ?"; PreparedStatement ps = conn.prepareStatement(sql); ps.setString(1, "%" + keyword + "%"); ResultSet rs = ps.executeQuery();

参数通过占位符传递，数据库会自动转义，这是最划算的安全加固。顺手把新增、修改、删除的 SQL 也统一改成 PreparedStatement，毕设答辩时被问到“怎么防止 SQL 注入”，这段代码就是加分项。

6.3 罚金的自动计算用数据库函数

罚金的计算逻辑在借阅归还、管理员手动修改、批量处理三个地方都可能用到，靠 Java 方法重复实现容易改漏。可以把这个逻辑收敛到 SQL 层，定义一个函数：

CREATE FUNCTION calc_fine(due_time DATETIME, return_time DATETIME) RETURNS DOUBLE BEGIN IF return_time IS NULL OR return_time <= due_time THEN RETURN 0; ELSE RETURN DATEDIFF(return_time, due_time) * 0.5; END IF; END;

之后无论在哪段代码里，只要调用SELECT calc_fine(due_time, return_time)就能得到罚金，不会再出现两处计算规则不一致的问题。这点对答辩时展示系统设计能力很有帮助，也是我做了几个 JSP 项目后养成的一个习惯：凡是多处使用的业务规则，全部下沉到数据库或公共方法里，绝不散落在 JSP 页面上。

我还记得有一次帮学弟调这个项目，他纠结了一个下午，问题就是登录跳转路径里多了一个/，导致每次登录成功后都被过滤器拦回。从那以后，我每次改 JSP 项目都会强制走一遍“先看拦截器配置、再测登录、再测借阅归还”的顺序，能规避掉七八成奇怪的 Bug。希望这篇笔记能帮你把这套图书馆借阅管理系统顺利跑起来，省下那些和时间纠缠的时间。

本文还有配套的精品资源，点击获取