企业官网建设流程全解析

简介：这是一套基于 JavaWeb 技术栈的图书管理系统完整源码包，适合正在学习 Servlet、JSP、JDBC 及三层架构的初学者，也可作为高校软件技术课程设计或毕业设计的参考项目。压缩包共包含 595 个文件，约 12.48MB，其中 97 个 Java 源文件是核心业务逻辑，47 个 JSP 文件负责页面展示，90 个 JS、38 个 CSS 支撑前端交互与样式，另有 SQL 数据库脚本、XML 配置文件及常用前端库文件，结构覆盖从数据库到页面的完整链路。资源包附带数据库初始化脚本，开发者可将项目导入 MyEclipse、IDEA 等环境后直接运行，结合源码与 SQL 脚本能快速掌握图书新增、查询、借阅、归还等典型功能的实现方式。目前已有 570 人学习或下载过该资源，对于需要快速搭建 JavaWeb 项目骨架并理解前后端联调的读者来说，是一份可直接上手的实战素材。

1. 基于javaweb的图书管理系统：这个zip包值不值得打开，打开后能拿到什么

你手里这个名为“基于javaweb的图书管理系统源码+数据库.zip”的压缩包，打开后大概率是一个 Servlet + JSP + MySQL 的传统 JavaWeb 项目：页面用 JSP 写，控制层用 Servlet 接请求，数据库脚本单独放在 sql 文件夹里。这类交付物在课程设计、毕业设计和 javaweb 项目完整案例 mysql 的检索结果里出现频率极高。它能解决一个很具体的问题：让你在几天内把一个带登录、图书增删改查、借还书功能的完整系统跑起来，并且看懂每个请求从页面到数据库的完整链路。适合有 Java 基础但没完整做过 Web 项目的人，也适合需要快速交付 demo 的初级开发。先别急着双击导入 IDEA，先搞清楚包里是什么、能不能跑、要付出多少配置成本——这套老技术栈的坑，不少就藏在“能跑”之前。

2. javaweb 图书管理系统的技术栈与架构：Servlet+JSP 这套老组合为什么还在批量出现

标题里的 javaweb 不是一个框架名，而是整个 Java Web 开发体系的口语简称。图书管理系统能成为这门课的常客，是因为需求足够简单：管理员维护图书和读者，读者借书还书，每个动作对应一次数据库增删改查。把这种系统拆开讲，刚好能把 HTTP 请求、Servlet 生命周期、JSP 渲染、JDBC 连接池这些 javaweb 的核心概念一次讲完。你先建立这个认知：这不是一个现代工程，而是一套“看得见底层”的教学级实现。

2.1 三层架构在图书管理系统里怎么分工

传统 JavaWeb 图书管理系统的代码通常按三层架构组织，而不是像培训班项目库那样混成一团。表现层是 JSP 页面，负责接收输入和展示结果；控制层是 Servlet，负责从 request 里取参数、调用业务方法、决定跳转到哪个页面；数据访问层是 DAO 类，负责写 SQL 和拿结果集；中间的 Service 层可以没有，但常见的完整案例会补上，目的是在 Servlet 和 DAO 之间加一层业务规则校验，比如借书前检查库存是否大于零。

以登录举例，一次完整请求是这样的：浏览器打开 login.jsp，填写用户名密码后表单提交到/login这个 url-pattern；web.xml 里配置的 LoginServlet 接管请求，在 doPost 里调用 UserService.login(username, password)；UserService 再调 UserDAO.findUserByUsernameAndPassword，DAO 通过 JDBC 拼接 SQL 查 t_user 表；查到记录就返回 User 对象，Servlet 把它放进 session，然后重定向到 index.jsp；查不到就返回错误提示到 login.jsp。

这套链路里，JSP 不碰数据库，Servlet 不写业务细节，DAO 不处理页面跳转。图书管理系统的业务量刚好卡在需要三层但不会过重的边界上。再多一层抽象，比如加一个 Controller 基类和泛型 DAO，新手就开始看不懂了；再少一层，所有代码堆在一个 Servlet 里，就回到 Model1 时代，后期改一个字段要动三处。你拿到的源码如果分层清晰，二次开发会很舒服；如果文件名像doLogin.jsp这种，那说明作者为了省事把逻辑写进了页面，这类代码的维护成本会高得多。

2.2 技术选型对照：JSP+Servlet 对比 Spring Boot，选哪个

很多人拿到这种源码的第一反应是问：为什么不直接用 Spring Boot？不是作者不想，而是这类题目本身就是按 javaweb 大纲出的。对比一下两个技术栈，你就能判断手里的源码到底该不该花时间：

如果你是为了交作业或学原理，JSP+Servlet 反而是更划算的选择。Spring Boot 的自动配置会替你挡掉很多东西，你看到的是一个已经跑起来的黑匣子；而这种老源码把 web.xml、Filter、Listener、JDBC 连接全部暴露在你面前，改一个字符就能看到行为变化，这种反馈是学习阶段最需要的。但要注意，这套技术栈在真实企业项目里已经很少从零搭建了，所以它的价值定位是“能改的参考实现”，不是“能部署的工程”。抱着这个预期去读代码，你就不会对没有 Maven、没有 Redis、没有权限框架这件事感到失望。

2.3 打开 zip 包前的侦察：先认清交付物再碰 IDEA

我拿到这类源码的第一件事，不是解压导入，而是在命令行里看目录结构。这一步能帮你判断三件事：工程类型是 Eclipse 还是 IDEA 还是 Maven；数据库脚本放在哪；有没有 readme 说明环境要求。

# 解压后在源码根目录执行，Windows CMD 用 dir /s 替代 find . -maxdepth 2 -type f | sort

逻辑说明：-maxdepth 2限制深度，避免 WEB-INF/lib 下几十个 jar 刷屏；sort让文件名按字典序排列，方便一眼看到根目录有哪些关键文件。

参数说明：如果看到pom.xml，说明这是 Maven 工程，导入方式选 Maven Project；如果看到.classpath和.project，这是 Eclipse 工程，导入 IDEA 时需要选 Eclipse 项目格式；如果看到.idea文件夹，那它本身就是 IDEA 工程，直接 Open 即可。接着找*.sql文件，它决定你第 4 章的导入参数；再找 readme.txt 或 说明文档，里面通常写了作者本机的 JDK 和 MySQL 版本。这些信息比代码本身更值钱，因为配置不匹配是一切麻烦的根源。还有一条血泪经验：不要双击index.jsp用浏览器直接打开，JSP 必须由 Tomcat 编译执行，file:// 协议打开只会看到一堆标签源码，这是 javaweb 新手最常见的开篇翻车。

3. 用 IDEA 运行 javaweb 项目配置：从源码到能点开登录页的全流程

这章解决的是热搜词里被问得最多的那件事：idea 运行 javaweb 项目配置。很多源码本身没毛病，翻车全在导入环节：版本不匹配、Artifact 没配置、数据库连接串写死。按下面顺序走一遍，多数项目能正常亮出登录页。

3.1 环境匹配清单：JDK、Tomcat、MySQL 版本先对齐

传统 javaweb 图书管理系统对环境的宽容度很低，不是随便装最新版就能跑。我的建议版本组合如下：

这里最容易踩的深坑是 Tomcat 版本。Tomcat 10 是一个分水岭，它把javax.servlet包名改成了jakarta.servlet，而课程设计源码里所有 Servlet 和 Filter 的 import 都写死了javax.servlet。你拿 Tomcat 10 去跑，控制台会刷出一片 ClassNotFoundException，这不是你的问题，是版本血统不匹配。解决办法不是改代码，而是降回 Tomcat 8.5 或 9.0。判断方式很简单：解压 Tomcat 后看 lib 目录里有没有jakarta.servlet-api.jar，有就是高版本，换掉。

3.2 导入源码：Maven 工程和非 Maven 工程两种打开方式

先确认工程类型，再选择导入方式。如果根目录有 pom.xml，IDEA 里点 File > Open，选择这个 pom.xml 让它以 Maven 工程加载；如果没有 pom.xml，只有传统的 src 和 WebRoot 结构，File > Open 直接选源码根目录，IDEA 会识别为一个普通项目，然后你需要手动给它添加 Web 能力和 Tomcat 依赖。

# 在项目根目录检查依赖管理文件 ls -la | grep -E "pom.xml|build.xml|.idea|.project|.classpath"

逻辑说明：grep -E用正则一次过滤多个目标文件名。输出里能同时看到哪些构建体系存在，避免你凭感觉猜。

参数说明：如果没有任何构建文件，说明这是一个手工维护的 IDEA/Eclipse 工程，你需要在 Project Structure 里手动把 WEB-INF/lib 下的 jar 包加为依赖，并确认 src 目录被标记为 Sources Root。这一步漏掉的话，写好的 DAO 类会全部标红，因为找不到java.sql.Connection之外的驱动类。

<dependencies> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <dependency> <groupId>c3p0</groupId> <artifactId>c3p0</artifactId> <version>0.9.1.2</version> </dependency> </dependencies>

逻辑说明：这是传统 javaweb 工程最常见的三件套。第一行 servlet-api 的 scope 必须是 provided，因为它由 Tomcat 提供，如果打成 war 包再带一份，会出现类加载冲突；第二行是 MySQL 驱动，版本要和数据库一致；第三行是连接池，很多源码用 c3p0 或 dbcp，具体看 DAO 工具类里 import 哪个包。

参数说明：provided这个关键字是 Maven 的依赖范围，意思是编译和测试时可用，打包时排除。如果你看到 pom.xml 里把 servlet-api 打成默认的compile，运行时会报重复类或 NoSuchMethodError，改成 provided 重导一下 Maven 即可。非 Maven 工程则要检查 WEB-INF/lib 目录下是否已经有 mysql-connector 和 c3p0 的 jar，没有就补进去。

3.3 配置 Tomcat 启动：war exploded、上下文路径、JVM 编码

Tomcat 配好是运行 javaweb 项目的核心动作。IDEA 里按三步走：第一步，Project Structure > Artifacts，确认存在 Web Application Exploded 类型的 Artifact，工程干净的情况下点左上角 + 号新建；第二步，Run > Edit Configurations > 左上角 + > Tomcat Server > Local，在 Deployment 页签加这个 Artifact；第三步，把 Application context 写成项目名，比如/book，这决定你访问登录页的完整 URL 是http://localhost:8080/book/login。

-Dfile.encoding=UTF-8 -Duser.language=zh

逻辑说明：这两行是 JVM 启动参数，填在 Tomcat 配置的 VM options 里。第一行强制文件编码为 UTF-8，避免源文件里的中文注释在编译后变成乱码；第二行让 Tomcat 内部错误信息显示为中文，排查问题不用猜英文术语。

参数说明：不是所有源码都需要第二行，但加上没有副作用。调试中文乱码时，这两行加与不加的效果立竿见影。还要注意一个概念：Deployment 里选war exploded而不是war。Exploded 是展开目录，修改 JSP 或静态资源后刷新浏览器立刻生效，不需要每次都重新打包；war 则在每次改动后要 rebuild，开发节奏慢得多，这也是很多新手“改了代码不生效”的原因之一。

<servlet> <servlet-name>LoginServlet</servlet-name> <servlet-class>com.book.servlet.LoginServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>LoginServlet</servlet-name> <url-pattern>/login</url-pattern> </servlet-mapping>

逻辑说明：这是 web.xml 里的核心配置，它把路径/login映射到LoginServlet类。你访问/book/login时，Tomcat 先根据/book定位到当前应用，再根据/login找到对应 Servlet。如果启动正常但 404，多半是 url-pattern 和前端表单提交的 action 不一致。

参数说明：servlet-name只是一个内部标识，必须与<servlet-mapping>里的名字完全一致，大小写敏感。url-pattern 必须以/开头，且不能直接写/*，否则会拦截 JSP 页面导致循环跳转。这句话值得记下来，因为我在帮人排查时发现，一半的“页面无法访问”问题出在这里。

3.4 修改数据库连接配置：jdbc.properties 里的必调参数

源码里的数据库配置通常集中在一个 properties 文件里，路径一般是src/jdbc.properties或resources/db.properties。打开后你会看到类似下面这样的五到六行，这是整个 javaweb 项目里最需要动手改的部分：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/book_db?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true jdbc.username=root jdbc.password=123456 jdbc.maxPoolSize=10

逻辑说明：url 后面的参数不是写给人看的装饰品，每一段都对应一个真实问题。useUnicode=true&characterEncoding=UTF-8让 Java 与 MySQL 通信时使用 UTF-8 编码，少了它写入中文会变成问号；useSSL=false关闭加密通道，避免 MySQL 8 默认开启 SSL 后老驱动反复告警；serverTimezone=Asia/Shanghai解决 MySQL 8 与 JDBC 驱动之间的时区差，不加会报The server time zone value的异常；allowPublicKeyRetrieval=true是 MySQL 8 连接时偶尔需要的许可参数。

参数说明：password 是头号翻车点。源码作者上传时往往会留一个默认密码，比如 123456 或 root，而你本机 MySQL 的密码大概率不同。改完密码后，先不要启动 Tomcat，用命令行验证一次连接：mysql -uroot -p能进去，说明账号密码没问题，再回过来检查 url 里的数据库名book_db是否和你要导入的 SQL 脚本建库名一致。这一步能省掉后面一半的查错时间。

ComboPooledDataSource ds = new ComboPooledDataSource(); ds.setJdbcUrl("jdbc:mysql://localhost:3306/book_db?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai"); ds.setUser("root"); ds.setPassword("123456"); ds.setInitialPoolSize(3); ds.setMaxPoolSize(10);

逻辑说明：这是 c3p0 连接池的 Java 配置写法，通常在 DBUtil 或 JdbcUtil 类里被初始化。连接池的作用是复用 Connection 对象，而不是每次都向数据库申请一个新连接。图书管理系统的并发量不高，但连接池能让你在高并发模拟测试时不至于瞬间打满 MySQL 的连接数。

参数说明：initialPoolSize是启动时预创建的连接数，设 3 即可；maxPoolSize是池子上限，设 10 够用，不用跟风调 50。数值太大反而会拖慢启动速度，并且每个空闲连接都会占用 MySQL 端内存。如果你拿到的源码用的是 Druid 或 dbcp，改对应属性名，含义相同。

4. 图书管理系统数据库设计与初始化脚本：建库、导数据、把连接串改对

解决了代码运行，接下来是数据库侧。图书管理系统是典型的数据库增删改查案例，表数量不多，但表结构的设计质量直接决定你后期加功能是否顺利。先看设计，再执行脚本，最后改连接参数，顺序不能反，因为建库脚本里的表名和字段名必须与 DAO 类里的 SQL 语句完全一致。

4.1 核心表结构：图书表、读者表、借阅表怎么设计

一个标准的图书管理系统通常有三张核心表，命名常见的是 t_book、t_user、t_borrow，不同源码会加前缀或缩写，但字段职责一致：

从设计角度看，t_book 和 t_user 是主数据表，t_borrow 是关系表。t_borrow 通过 book_id 和 user_id 外键关联另外两张表，这体现了一对多的关系：一个读者可以有多条借阅记录，一本书也可以被多次借出。这里有一个容易被忽略的设计点：status 字段用 TINYINT 而不是 VARCHAR 或 DATETIME。因为它只表达两个状态，0 表示在借，1 表示已还，用数字比用字符串省空间且查询更快。return_time 在未还时是 NULL，这个 NULL 恰好能当判断条件用。

关于角色区分，t_user 表里的 role 字段是这套系统的权限开关。管理员登录后能看到“增加图书”“删除用户”菜单，普通读者只能浏览和借还，前端根据 role 值决定渲染哪些功能入口。虽然这种权限控制只是页面隐藏，没有后端拦截，但作为课程设计已经够用。你如果要做二次开发，后续可以在 Servlet 里加一个 Filter 做权限校验，这是后话。

4.2 执行 SQL 脚本的正确姿势：字符集与导入方式

拿到源码里的 .sql 文件后，不要双击用记事本打开看两眼就关掉，先用文本编辑器确认它的编码格式。Windows 记事本另存为时会默认选 ANSI，如果作者用 UTF-8 存但脚本里没指定字符集，导入后中文全部乱码。我的做法是直接用命令行导入，并在导入时强制指定字符集：

CREATE DATABASE IF NOT EXISTS book_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE book_db; CREATE TABLE t_book ( id INT PRIMARY KEY AUTO_INCREMENT, book_name VARCHAR(100) NOT NULL, author VARCHAR(50), publisher VARCHAR(80), price DECIMAL(10,2), stock INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(30) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT DEFAULT 1 COMMENT '0管理员 1读者', real_name VARCHAR(30), phone VARCHAR(20) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; CREATE TABLE t_borrow ( id INT PRIMARY KEY AUTO_INCREMENT, book_id INT NOT NULL, user_id INT NOT NULL, borrow_time DATETIME DEFAULT CURRENT_TIMESTAMP, return_time DATETIME DEFAULT NULL, status TINYINT DEFAULT 0 COMMENT '0在借 1已还', FOREIGN KEY (book_id) REFERENCES t_book(id), FOREIGN KEY (user_id) REFERENCES t_user(id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

逻辑说明：DEFAULT CHARACTER SET utf8mb4是让整个库支持完整的中文和 emoji；utf8mb4_general_ci是排序规则，ci 表示大小写不敏感。AUTO_INCREMENT让主键自增，COMMENT给字段加上说明，DBA 和后来接手的人都会感激你。t_borrow 的外键约束保证了借阅记录不会指向不存在的图书或用户，这是数据完整性的底线。

参数说明：DECIMAL(10,2)表示价格最多 8 位整数加 2 位小数，图书定价够用；DEFAULT CURRENT_TIMESTAMP在插入记录时自动取当前时间，不需要代码里额外 set 这个字段。库存字段DEFAULT 0避免插入时漏传导致 NULL，NULL 一旦进入业务判断就会引发空指针。这里要强调一下utf8mb4和utf8的区别：老项目常见的是utf8，但 MySQL 的 utf8 最多存 3 字节，遇到生僻字或表情符号会报错；从新项目开始一律用 utf8mb4。

# 命令行导入，注意这里的字符集参数 mysql --default-character-set=utf8mb4 -uroot -p < db/book_db.sql

逻辑说明：--default-character-set=utf8mb4是告诉客户端以 UTF-8 编码解析 SQL 文件内容，避免 Windows 下默认的 GBK 导致中文变乱码。<是 Shell 重定向，把文件内容送入 mysql 命令执行。

参数说明：如果你用的是 Navicat 之类的图形客户端，导入前在连接属性里把编码选为 UTF-8，效果相同。导入成功后，顺手插入一条管理员账号和两本测试图书，验证表结构和 DAO 代码能正常读写：

INSERT INTO t_user (username, password, role, real_name) VALUES ('admin', 'e10adc3949ba59abbe56e057f20f883e', 0, '管理员'); INSERT INTO t_book (book_name, author, publisher, price, stock) VALUES ('Java核心技术', 'Cay S. Horstmann', '机械工业出版社', 119.00, 10);

逻辑说明：密码字段存的是123456的 MD5 值e10adc3949ba59abbe56e057f20f883e，这是老 javaweb 源码最常见的做法。检索时按用户名和这个密文比对，避免了数据库里存放明文密码。如果你想改成自己的密码，用任意在线 MD5 工具生成一段 32 位字符串替换即可。

参数说明：role 设为 0 表示这条账号是管理员。如果你在页面上用这个账号登录后发现菜单比别的账号多，说明权限判断没问题，是数据驱动的效果。测试图书的 stock 设为 10，是为了借书时能扣减库存而不至于一把借成负数。

4.3 数据库增删改查在工程里对应哪些代码：连接池与 PreparedStatement

数据库初始化完成后，接下来要理解的不是整个项目，而是增删改查四条链路在源码里的落点。图书管理系统的核心动作就四个：管理员添加图书是 Create，图书列表是 Read，编辑图书信息是 Update，删除图书或借阅记录是 Delete。找到src/com/book/dao包下的 BookDao 类，你会在里面看到 5 到 6 个方法，对应不同 SQL。

public int addBook(Book book) throws SQLException { try (Connection conn = JdbcUtil.getConnection(); PreparedStatement ps = conn.prepareStatement( "INSERT INTO t_book(book_name, author, publisher, price, stock) VALUES(?,?,?,?)")) { ps.setString(1, book.getBookName()); ps.setString(2, book.getAuthor()); ps.setString(3, book.getPublisher()); ps.setBigDecimal(4, book.getPrice()); ps.setInt(5, book.getStock()); return ps.executeUpdate(); } }

逻辑说明：try-with-resources写法会在这个方法结束后自动关闭 PreparedStatement 和 Connection，不用手动写 finally 块，这是老源码里难得能直接移植到新项目的习惯。executeUpdate()返回受影响行数，等于 1 表示插入成功。

参数说明：注意这里用的是PreparedStatement而不是Statement，两者区别在于预编译和防止 SQL 注入。老项目里有不少教程写 Statement 拼接字符串，但增删改查一旦接触用户输入，拼 SQL 就是安全灾难。你接手源码时优先看 DAO 里用的是哪个类，如果是 String 拼接的"SELECT * FROM t_user WHERE username='" + name + "'"，建议你改成 PreparedStatement 的写法再继续往下做。

还有一份配套的 c3p0-config.xml，放在 src 根目录时，代码里可以直接用默认配置，不用手动 new 数据源：

<c3p0-config> <default-config> <property name="jdbcUrl">jdbc:mysql://localhost:3306/book_db?useUnicode=true&amp;characterEncoding=UTF-8&amp;useSSL=false&amp;serverTimezone=Asia/Shanghai</property> <property name="user">root</property> <property name="password">123456</property> <property name="initialPoolSize">3</property> <property name="maxPoolSize">10</property> </default-config> </c3p0-config>

逻辑说明：XML 里的&必须转义成&，这是 XML 语法规定，不转义的话启动时会报XML或文本声明不在实体的开头之类的解析错误。改完 c3p0-config.xml 后，重启 Tomcat 才生效。

参数说明：initialPoolSize 和 maxPoolSize 的数值要和 3.4 节保持一致，如果你在 Java 代码里也设置了同一组参数，以 XML 为准。数据库连接池参数的坑在于：配置了多个数据源实例时，哪个被 JdbcUtil 加载取决于初始化代码，所以看到源码里有new ComboPooledDataSource()无参构造时，就让它去读默认配置。

5. 部署运行排查：5 个让图书管理系统 javaweb 源码翻车的坑

代码能编译、数据库能连接之后，运行阶段才是真正考验人的地方。下面这几条是 javaweb 图书管理系统项目里翻车频率最高的五类问题，按“现象、原因、解决”的顺序写，你在哪一步卡住，直接对号入座查对应条目。

5.1 现象：启动报 ClassNotFoundException: javax.servlet

Tomcat 启动到一半，控制台刷出ClassNotFoundException: javax.servlet.ServletException或NoClassDefFoundError: javax/servlet/http/HttpServlet。这时页面打不开，但可能出现一部分静态资源能访问的假象。

原因有两个方向。第一，你用的 Tomcat 是 10.x，它把javax.servlet迁移到了jakarta.servlet，而源码里所有 Servlet 类 import 的仍是旧包名，必然找不到类。第二，IDEA 的 Artifact 里没有把 Tomcat 的库关联到项目依赖，这种情况常见于非 Maven 手动导入的工程，Module 配置里缺少 Tomcat 提供的外部库。

解决：先用java -version确认 JDK 版本，再打开 Tomcat 安装目录的 lib 文件夹看有没有jakarta.servlet-api.jar，有就说明版本不对，换回 Tomcat 8.5 或 9.0。如果是第二种情况，在 Project Structure > Modules > Dependencies 里点 + 号，选择 Application Server Library，把当前 Tomcat 添加进去。这个库是全局生效的，加一次就够。

5.2 现象：页面能开但登录提示数据库连接失败

登录页能正常显示，点登录后等几秒，页面报Cannot create PoolableConnectionFactory或Access denied for user 'root'@'localhost'，或者浏览器转圈后 500。这种情况下 Tomcat 本身没挂，问题出在项目与 MySQL 之间。

原因按概率排序：一是密码与数据库配置不一致，源码里写的密码和你本机 MySQL 密码不同；二是 MySQL 服务根本没启动，Windows 下表现为任务管理器里没有 mysqld 进程；三是连接串的库名或端口写错了，3306 被改过的机器尤其常见。

解决：按顺序排查。先确认端口存活：netstat -ano | findstr 3306能看到 LISTENING 说明服务在；再用命令行mysql -uroot -p验证账号密码，能进说明数据库层没问题；最后打开 jdbc.properties 或 c3p0-config.xml，核对 url、username、password 三项是否与命令行能用的一致。经验是 80% 的问题出在 password 一项上。

5.3 现象：修改了代码但浏览器加载的是旧页面

你改了 JSP 的标题文字，也改了某个 Servlet 的返回值，重启 Tomcat 后刷新浏览器，页面还是老样子。这时如果看 IDEA 的编译输出，可能根本没有重新编译，或者 Tomcat 部署的是 out 目录里的半旧产物。

原因有两个。第一，IDEA 的 Build 动作没有触发，纯改源码文件不会自动重新部署 Artifact；第二，浏览器缓存了旧的静态资源，JSP 编译后的 class 也在 Tomcat 的 work 目录里，没有清理。

解决：在菜单里执行 Build > Rebuild Project，强制全量编译；再把 Run 配置里的 Before launch 选项检查一下，确保包含 Build Artifacts 步骤。开发期部署方式确认选的是war exploded，这样 JSP 改动刷新即生效。如果改的是 Servlet 类，因为类已经被 Tomcat 加载，必须重启 Tomcat 才能生效，这是 Servlet 容器的类加载机制决定的。

5.4 现象：中文乱码，插入数据库后变成问号

页面上能看到中文书名，但导入 MySQL 后查询出来是??，或者反过来，从数据库里读出来的数据在页面上显示为乱码。乱码问题在图书管理系统里尤其典型，因为书名和作者全是中文。

原因是一处字符集不一致，四层链路全要检查：JSP 页面的编码、Tomcat 连接器的 URIEncoding、JDBC 连接串的 characterEncoding、以及 MySQL 表结构本身的字符集。任何一层是默认的 latin1 或 GBK，整条链路就会出乱码。

解决：四层统一为 UTF-8。JSP 头部确认是这段：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %>

Tomcat 的 server.xml 里给 Connector 加URIEncoding="UTF-8"，JDBC 连接串加characterEncoding=UTF-8，MySQL 建库时指定 utf8mb4。四层都改完还乱，重启 Tomcat 并清空 work/Catalina 目录下的编译缓存。乱码问题看起来很玄学，实际上按这个顺序逐层查，两小时内必定位。

5.5 现象：Tomcat 启动秒退或端口被占用

点启动后 IDEA 的 Tomcat 窗口闪一下就消失，或者在输出里看到Address already in use: JVM_Bind:8080。有时候上一次启动没有被正确停止，端口还被残留进程占着。

解决：Windows 下用 netstat 和 taskkill 定位清理：

netstat -ano | findstr 8080 taskkill /PID 1234 /F

逻辑说明：第一条命令找出占用 8080 端口的进程 PID；第二条把该 PID 的进程强制结束。/F是强制终止，不加的话只能礼貌请求，杀不掉常驻进程。

参数说明：如果不想杀进程，也可以直接改 Tomcat 端口。server.xml 里除了 8080，还要同步改 8009（AJP 端口）和 8005（shutdown 端口），只改一处会导致启动时仍然报端口占用。改完后在 IDEA 的 Tomcat 配置里确认 HTTP port 与 server.xml 一致，否则 IDEA 会用自己填写的端口启动而绕过 server.xml。这个细节很容易让人反复翻车，记住三个端口一起改。

6. 从跑通到干净交付：日志验证、Tomcat 参数调优与收尾习惯

系统能跑起来只是一个起点，你迟早要面对“怎么证明它真的没问题”这件事。这一章给出一套验证方法，以及从源码使用者变成源码维护者之前必须养成的两个习惯。

6.1 用日志与验证 SQL 确认三个核心流程

登录、借书、还书是图书管理系统的三个主流程。每个流程走一遍，然后看两个地方：Tomcat 日志和数据库里的数据变化。Tomcat 的日志在logs/catalina.out，开发阶段实时跟踪：

tail -f logs/catalina.out

SQL 层面验证借还书闭环，用一段三表联查：

SELECT b.book_name, u.username, br.borrow_time, br.return_time, br.status FROM t_borrow br JOIN t_book b ON br.book_id = b.id JOIN t_user u ON br.user_id = u.id ORDER BY br.id DESC LIMIT 5;

跑通后你能看到：借书时间有值且 status 为 0，还书后 return_time 有值且 status 变为 1。这条查询对应的就是常见面试题里“JavaWeb 项目完整案例 MySQL”的数据层验证。如果查不出数据，返回去看 DAO 里的 SQL 和表名是否对齐。

6.2 交付前固定这三类参数

这三个参数是运行环境的稳定锚点。调整连接池和连接超时后，记得重测一次登录和借书，因为参数改动只在重启后生效，重启后不回归测试等于没改。

6.3 保持可复现的两个收尾习惯

第一个习惯，把环境版本写进 readme 的第一行。JDK 1.8、Tomcat 9.0、MySQL 5.7、连接串密码，这些信息对你而言是记忆，对三天后的你来说是救命稻草，对接手你代码的人则是唯一的信任来源。第二个习惯，每次跑通一个功能后，导出一次干净版本的数据库脚本备份。开发过程中表结构会改，一旦改乱，你能用备份在十分钟内回到上一个稳定状态。

我早期接手一个图书管理系统源码，花了两小时才进入登录页，最后发现只是 Tomcat 10 和 javax 包不匹配。后来我每次打开 zip 包，先看 pom.xml 和 web.xml，再把 JDK 和 Tomcat 版本写进 readme 第一行，再没在这件事上翻过车。这套流程同样适用于你手里这份源码。希望帮到你。

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