企业官网建设流程全解析

简介：本资源是一套完整的高校计算机专业毕业设计项目——基于JSP与MySQL开发的驾校管理系统，面向Java初学者及Web开发入门学习者，解决传统驾校信息管理效率低、学员预约与成绩查询不便等实际问题。压缩包共22.27MB，含源码、毕业论文、系统演示视频三大核心模块：源码采用B/S架构，涵盖前台学员注册/预约/新闻浏览、教练信息查看，以及后台管理员对预约记录、考试成绩、用户权限的统一管理；论文详述系统需求分析、数据库设计与首页/前台/后台各模块实现逻辑；视频直观展示系统运行效果与关键操作流程。资源已获104人学习下载，结构清晰、功能完整，适合作为课程设计参考、毕设开题范例或JSP+MySQL全栈开发实践案例。

1. 为什么一个用 JSP 做的驾校管理系统，至今还在毕业设计选题榜上稳居前三？

不是因为它多前沿——Servlet 3.0 都是十年前的规范，JSTL 标签库早被 Thymeleaf 和 Vue 挤到角落；而是因为它足够“实”。它不抽象、不悬浮：学员报名要填身份证号和手机号，教练排班得避开冲突时段，车辆调度得看维修状态，考试预约得校验科目顺序。这些全是真实业务里掰着手指头数出来的约束条件，没有一个能靠“前端传个 JSON 后端存个 MongoDB”糊弄过去。

这个系统背后是典型的“小而全”Web 工程训练场：数据库要建学员、教练、车辆、课程、预约、成绩六张主表，外加至少四层外键关联；权限要分管理员、教练、学员三角色，连“教练只能看自己带的学员”这种细粒度控制都得手写逻辑；页面要填表单、查列表、导 Excel、上传照片——每一步都在逼你直面 HTTP 状态码、Session 生命周期、SQL 注入边界、文件上传大小限制这些教科书里写得对、但一跑就报错的硬茬。

它适合两类人：一类是刚学完《Java Web 编程基础》还没碰过 Spring Boot 的学生，需要一个能从零搭起完整请求链路的锚点；另一类是想快速验证某个老系统改造可行性的一线开发者，比如把某驾校旧系统从 Struts 迁移到轻量级架构时，拿它当最小可运行对照组。别被“毕业设计”四个字劝退——真正动手调通request.setCharacterEncoding("UTF-8")和response.setContentType("text/html;charset=UTF-8")乱码问题的人，比写一百行 Spring Cloud 微服务配置更懂字符集本质。

2. 用原生 JSP + Servlet + JDBC 搭出可运行骨架：不依赖任何框架的最小闭环

2.1 数据库建模：从驾校业务流反推表结构与关键约束

驾校核心流程是“报名 → 分配教练 → 安排练车 → 预约考试 → 成绩录入 → 结业”。对应到数据库，必须保证：

• 学员（student）身份证号唯一且非空（id_card VARCHAR(18) NOT NULL UNIQUE）；
• 教练（instructor）必须绑定至少一辆车（vehicle_id INT NOT NULL，外键指向vehicle表）；
• 预约记录（appointment）必须校验：同一学员同一科目不能重复预约、预约时间不能早于当前日期、教练当天排班状态必须为“可用”。

提示：初学者常忽略appointment表的复合唯一索引。仅对student_id加唯一索引不够——学员可以预约不同科目；正确做法是建立(student_id, subject_code)联合唯一索引，防止同一学员重复预约同一科目。

建表 SQL 示例（MySQL 5.7+）：

-- 学员表 CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(20) NOT NULL, id_card VARCHAR(18) NOT NULL UNIQUE, phone VARCHAR(11) NOT NULL, reg_date DATE NOT NULL DEFAULT (CURRENT_DATE) ); -- 教练表（含状态字段：0-停用，1-启用） CREATE TABLE instructor ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(20) NOT NULL, id_card VARCHAR(18) NOT NULL UNIQUE, phone VARCHAR(11) NOT NULL, status TINYINT NOT NULL DEFAULT 1, vehicle_id INT NOT NULL, FOREIGN KEY (vehicle_id) REFERENCES vehicle(id) ); -- 预约表（关键：联合唯一 + 时间校验触发器后续补） CREATE TABLE appointment ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT NOT NULL, instructor_id INT NOT NULL, subject_code CHAR(2) NOT NULL COMMENT 'C1,C2,B2等', app_date DATE NOT NULL, app_time TIME NOT NULL, status TINYINT NOT NULL DEFAULT 0 COMMENT '0-待确认,1-已通过,2-已取消', create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_student_subject (student_id, subject_code), FOREIGN KEY (student_id) REFERENCES student(id), FOREIGN KEY (instructor_id) REFERENCES instructor(id) );

逻辑说明：uk_student_subject联合唯一索引直接拦截重复预约；status字段用整型而非字符串，减少存储开销且便于 Java 枚举映射；create_time默认值让后台无需手动赋值，避免new Date()时区偏差。

参数说明：

• VARCHAR(18)严格匹配中国大陆身份证长度（15位老号已淘汰，18位为标准）；
• TINYINT占 1 字节，比INT节省 3 字节/行，在万级预约数据下可省百 KB 存储；
• COMMENT字段虽不参与执行，但生成 ER 图或后期维护时能立刻定位subject_code含义。

2.2 Servlet 层路由设计：用 web.xml 显式声明替代注解，看清请求生命周期

JSP 项目若用@WebServlet注解，新手极易陷入“为什么这个 Servlet 不生效”的玄学排查。我们回归原始方式：在WEB-INF/web.xml中显式注册，强制你理解容器启动时如何加载 Servlet。

<!-- web.xml 片段 --> <servlet> <servlet-name>StudentListServlet</servlet-name> <servlet-class>com.driving.servlet.StudentListServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>StudentListServlet</servlet-name> <url-pattern>/admin/student/list</url-pattern> </servlet-mapping> <servlet> <servlet-name>AppointmentAddServlet</servlet-name> <servlet-class>com.driving.servlet.AppointmentAddServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>AppointmentAddServlet</servlet-name> <url-pattern>/student/appoint</url-pattern> </servlet-mapping>

逻辑说明：/admin/student/list是管理员路径，/student/appoint是学员路径，天然形成权限隔离雏形；所有 URL 统一以/开头，避免相对路径跳转混乱；Servlet 类名与 URL 模式解耦，改路径不用动 Java 文件。

参数说明：

• <servlet-name>是内部标识符，不暴露给前端，可任意命名（如StuListSvc），但建议与类名一致降低认知负荷；
• <url-pattern>必须以/开头，否则 Tomcat 会报java.lang.IllegalArgumentException: Invalid <url-pattern>；
• 若需通配符，用*.do或/api/*，但毕业设计中建议用精确路径，避免路由歧义。

2.3 JSP 页面渲染：用 JSTL 替代 scriptlet，把 Java 逻辑踢出 HTML

禁止在 JSP 里写<% while(rs.next()) { %>—— 这是十年前的写法，现在必须用 JSTL。先在web.xml声明 JSTL 支持（Tomcat 8+ 默认内置，但显式声明更稳妥）：

<jsp-config> <taglib> <taglib-uri>http://java.sun.com/jsp/jstl/core</taglib-uri> <taglib-location>/WEB-INF/tld/c.tld</taglib-location> </taglib> </jsp-config>

然后在 JSP 页顶部引入：

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

学员列表页（student_list.jsp）核心片段：

<table class="table"> <thead> <tr> <th>姓名</th><th>身份证号</th><th>手机号</th><th>报名日期</th><th>操作</th> </tr> </thead> <tbody> <c:choose> <c:when test="${empty studentList}"> <tr><td colspan="5">暂无学员</td></tr> </c:when> <c:otherwise> <c:forEach items="${studentList}" var="stu"> <tr> <td>${stu.name}</td> <td>${stu.idCard}</td> <td>${stu.phone}</td> <td><fmt:formatDate value="${stu.regDate}" pattern="yyyy-MM-dd"/></td> <td> <a href="student/edit?id=${stu.id}">编辑</a> | <a href="student/delete?id=${stu.id}" onclick="return confirm('确定删除？')">删除</a> </td> </tr> </c:forEach> </c:otherwise> </c:choose> </tbody> </table>

逻辑说明：<c:choose>替代if-else，<c:forEach>替代for循环，<fmt:formatDate>统一日期格式，彻底剥离 Java 代码；${stu.idCard}中的idCard对应 Java Bean 的getIdCard()方法，遵循 JavaBean 规范；onclick="return confirm(...)"是最简前端校验，防误点。

参数说明：

• prefix="c"是自定义前缀，可改为jstl，但c是业界约定，减少团队协作成本；
• pattern="yyyy-MM-dd"必须双引号包裹，单引号会报org.apache.jasper.JasperException；
• confirm()返回false时阻止<a>默认跳转，这是最轻量的删除防护。

3. JDBC 连接池与事务控制：为什么 DriverManager.getConnection() 在毕业设计里就是错的

3.1 用 DBCP2 替代裸连接：三步接入连接池

DriverManager.getConnection()每次创建新连接，100 个并发请求就会创建 100 个 TCP 连接，MySQL 默认最大连接数 151，瞬间打满。必须用连接池。Apache Commons DBCP2 是最轻量选择（比 HikariCP 少 2 个依赖，比 Druid 少 5 个监控模块）。

第一步：下载commons-dbcp2-2.9.0.jar和commons-pool2-2.11.1.jar，放入WEB-INF/lib/目录。

第二步：在WEB-INF/web.xml添加监听器，容器启动时初始化连接池：

<listener> <listener-class>com.driving.listener.DBPoolListener</listener-class> </listener>

第三步：编写DBPoolListener（实现ServletContextListener）：

public class DBPoolListener implements ServletContextListener { private static BasicDataSource dataSource; @Override public void contextInitialized(ServletContextEvent sce) { dataSource = new BasicDataSource(); dataSource.setUrl("jdbc:mysql://localhost:3306/driving?useSSL=false&serverTimezone=Asia/Shanghai"); dataSource.setUsername("root"); dataSource.setPassword("123456"); dataSource.setInitialSize(5); // 初始连接数 dataSource.setMaxTotal(20); // 最大连接数 dataSource.setMaxWaitMillis(3000); // 获取连接超时（毫秒） dataSource.setTestOnBorrow(true); // 取连接前校验有效性 dataSource.setValidationQuery("SELECT 1"); // 校验 SQL // 将连接池存入 ServletContext，全局可取 sce.getServletContext().setAttribute("dataSource", dataSource); } public static DataSource getDataSource() { return dataSource; } }

逻辑说明：setTestOnBorrow(true)是血泪经验——不加这句，MySQL 连接空闲 8 小时后自动断开（wait_timeout 默认值），用户点击按钮时抛Communications link failure；validationQuery用SELECT 1最轻量，比SELECT NOW()少一次函数调用。

参数说明：

• initialSize=5：避免首次访问慢，5 个连接够 3 人小组测试；
• maxTotal=20：毕业设计并发不会超 20，设太高反而占内存；
• maxWaitMillis=3000：超时 3 秒立即报错，比卡住 30 秒更利于定位问题。

3.2 手动事务管理：在预约添加场景中保证数据一致性

预约操作涉及三张表：更新appointment表插入记录、更新instructor表的busy_count字段、更新student表的last_appoint_date。任一环节失败，必须全部回滚。

关键代码（AppointmentAddServlet.java）：

protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { Connection conn = null; PreparedStatement ps = null; try { DataSource ds = (DataSource) getServletContext().getAttribute("dataSource"); conn = ds.getConnection(); conn.setAutoCommit(false); // 关闭自动提交 // 插入预约记录 String sql1 = "INSERT INTO appointment(student_id, instructor_id, subject_code, app_date, app_time) VALUES (?, ?, ?, ?, ?)"; ps = conn.prepareStatement(sql1, Statement.RETURN_GENERATED_KEYS); ps.setInt(1, Integer.parseInt(req.getParameter("studentId"))); ps.setInt(2, Integer.parseInt(req.getParameter("instructorId"))); ps.setString(3, req.getParameter("subjectCode")); ps.setDate(4, Date.valueOf(req.getParameter("appDate"))); ps.setTime(5, Time.valueOf(req.getParameter("appTime"))); ps.executeUpdate(); // 更新教练忙时计数 String sql2 = "UPDATE instructor SET busy_count = busy_count + 1 WHERE id = ?"; ps = conn.prepareStatement(sql2); ps.setInt(1, Integer.parseInt(req.getParameter("instructorId"))); ps.executeUpdate(); // 更新学员最后预约时间 String sql3 = "UPDATE student SET last_appoint_date = ? WHERE id = ?"; ps = conn.prepareStatement(sql3); ps.setDate(1, Date.valueOf(req.getParameter("appDate"))); ps.setInt(2, Integer.parseInt(req.getParameter("studentId"))); ps.executeUpdate(); conn.commit(); // 全部成功才提交 req.setAttribute("msg", "预约成功"); } catch (SQLException e) { if (conn != null) { try { conn.rollback(); } catch (SQLException ex) { } } req.setAttribute("msg", "预约失败：" + e.getMessage()); e.printStackTrace(); } finally { closeResources(conn, ps, null); } req.getRequestDispatcher("result.jsp").forward(req, resp); }

逻辑说明：conn.setAutoCommit(false)是事务起点；ps.executeUpdate()不提交；conn.commit()是终点；rollback()在 catch 块中确保异常时回滚；closeResources()是自定义工具方法，统一关闭资源防泄漏。

参数说明：

• Statement.RETURN_GENERATED_KEYS用于获取自增主键，此处未用但预留扩展；
• Date.valueOf()和Time.valueOf()直接解析字符串，比SimpleDateFormat线程安全；
• req.getRequestDispatcher("result.jsp")用转发而非重定向，保留req.setAttribute()数据。

4. 权限控制与常见问题排查：为什么登录后点菜单还是 404？

4.1 基于 Filter 的粗粒度权限拦截

不推荐在每个 Servlet 里写if (!"admin".equals(session.getAttribute("role")))—— 复制粘贴三次就失控。用Filter统一拦截：

public class AuthFilter implements Filter { @Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(false); String path = request.getServletPath(); String role = session != null ? (String) session.getAttribute("role") : null; // 管理员路径必须登录且角色为 admin if (path.startsWith("/admin/") && !"admin".equals(role)) { response.sendRedirect(request.getContextPath() + "/login.jsp?error=access_denied"); return; } // 教练路径必须登录且角色为 instructor if (path.startsWith("/instructor/") && !"instructor".equals(role)) { response.sendRedirect(request.getContextPath() + "/login.jsp?error=access_denied"); return; } chain.doFilter(req, resp); } }

在web.xml中注册：

<filter> <filter-name>AuthFilter</filter-name> <filter-class>com.driving.filter.AuthFilter</filter-class> </filter> <filter-mapping> <filter-name>AuthFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

逻辑说明：path.startsWith("/admin/")比正则更高效；session.getAttribute("role")从登录成功时存入；response.sendRedirect()是客户端跳转，URL 变化，适合权限拒绝；chain.doFilter()是放行，必须调用否则请求中断。

参数说明：

• <url-pattern>/*</url-pattern>拦截所有请求，包括静态资源（CSS/JS），但毕业设计中静态资源少，可接受；
• session != null ? ... : null防止空指针，比session.getAttribute("role") == null更安全。

4.2 常见问题排查：五条真实踩坑记录

注意：以下问题均来自某高校计算机系近三届毕业设计答辩现场高频故障

现象 1：登录成功后跳转到index.jsp，但页面显示HTTP Status 404 – Not Found
→ 原因：web.xml中<welcome-file-list>未配置，或配置了index.html但实际文件是index.jsp；Tomcat 默认只认index.html、index.htm、index.jsp，漏掉.jsp后缀即 404。
→ 解决：在web.xml中显式声明：

<welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list>

现象 2：学员列表页表格为空，控制台无报错，数据库明明有数据
→ 原因：JSP 中${studentList}取不到值，但没写<c:when test="${empty studentList}">分支，导致表格<tbody>内无内容，浏览器渲染空白。
→ 解决：强制所有循环结构包裹<c:choose>，即使只是提示“暂无数据”。

现象 3：修改学员信息后，中文姓名变成??，数据库里存的是乱码
→ 原因：MySQL 表字符集是latin1，未改成utf8mb4；或 JDBC URL 缺少characterEncoding=utf8参数。
→ 解决：两步走——① 执行ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;；② JDBC URL 补全：jdbc:mysql://...?characterEncoding=utf8。

现象 4：点击“删除学员”，浏览器地址栏 URL 变成student/delete?id=5，但数据库没删
→ 原因：StudentDeleteServlet的doGet()方法未实现，只写了doPost()；而<a href="...">发送的是 GET 请求。
→ 解决：在 Servlet 中重写doGet()，调用与doPost()相同的删除逻辑，或统一用表单 POST 提交。

现象 5：本地 Tomcat 运行正常，部署到学校服务器后所有 JSP 报org.apache.jasper.JasperException: /index.jsp (line: [1], column: [1]) Unable to compile class for JSP
→ 原因：服务器 Tomcat 版本低于开发环境（如本地用 Tomcat 9，服务器是 Tomcat 7），JSP 语法不兼容；或WEB-INF/lib/下混入了高版本 Servlet API jar。
→ 解决：统一使用 Tomcat 8.5（兼容性最好），并删除lib/中所有servlet-api.jar（Tomcat 自带，重复引入必报错）。

5. 文件上传与 Excel 导出：用 Apache Commons FileUpload 和 POI 实现两个刚需功能

5.1 学员照片上传：绕过request.getParameter()的 multipart 陷阱

HTML 表单必须设enctype="multipart/form-data"，此时request.getParameter()失效，必须用Apache Commons FileUpload。

第一步：引入commons-fileupload-1.5.jar和commons-io-2.11.0.jar。

第二步：在学员新增页面（student_add.jsp）写表单：

<form action="student/add" method="post" enctype="multipart/form-data"> <input type="text" name="name" required> <input type="text" name="idCard" required> <input type="file" name="photo" accept="image/*" required> <button type="submit">提交</button> </form>

第三步：在StudentAddServlet.java中解析：

protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { DiskFileItemFactory factory = new DiskFileItemFactory(); ServletFileUpload upload = new ServletFileUpload(factory); List<FileItem> items = upload.parseRequest(req); String name = "", idCard = ""; String photoPath = null; for (FileItem item : items) { if (item.isFormField()) { // 普通字段 String fieldName = item.getFieldName(); String value = item.getString("UTF-8"); if ("name".equals(fieldName)) name = value; if ("idCard".equals(fieldName)) idCard = value; } else { // 文件字段 if (!item.getName().isEmpty()) { String fileName = new Date().getTime() + "_" + item.getName(); String savePath = req.getServletContext().getRealPath("/uploads/"); File uploadDir = new File(savePath); if (!uploadDir.exists()) uploadDir.mkdirs(); item.write(new File(uploadDir, fileName)); photoPath = "/uploads/" + fileName; } } } // 插入数据库（photoPath 存入 student 表的 photo_url 字段） // ... JDBC 插入逻辑 }

逻辑说明：item.isFormField()区分普通字段和文件字段；item.getString("UTF-8")强制用 UTF-8 解码，解决中文参数乱码；new Date().getTime()生成唯一文件名，避免重名覆盖；getRealPath("/uploads/")获取服务器绝对路径，必须用此而非相对路径。

参数说明：

• accept="image/*"是前端校验，防用户选错文件类型；
• fileName拼接时间戳而非原名，杜绝../../etc/passwd路径遍历攻击；
• uploadDir.mkdirs()确保目录存在，否则item.write()抛java.io.FileNotFoundException。

5.2 学员数据 Excel 导出：用 Apache POI 生成 .xlsx 文件

导出功能不走页面跳转，而是response直接写二进制流。

protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 1. 查询数据 List<Student> students = studentService.findAll(); // 2. 创建工作簿 XSSFWorkbook workbook = new XSSFWorkbook(); XSSFSheet sheet = workbook.createSheet("学员列表"); // 3. 写表头 XSSFRow headerRow = sheet.createRow(0); String[] headers = {"ID", "姓名", "身份证号", "手机号", "报名日期"}; for (int i = 0; i < headers.length; i++) { headerRow.createCell(i).setCellValue(headers[i]); } // 4. 写数据行 int rowNum = 1; for (Student stu : students) { XSSFRow row = sheet.createRow(rowNum++); row.createCell(0).setCellValue(stu.getId()); row.createCell(1).setCellValue(stu.getName()); row.createCell(2).setCellValue(stu.getIdCard()); row.createCell(3).setCellValue(stu.getPhone()); row.createCell(4).setCellValue( stu.getRegDate() != null ? new SimpleDateFormat("yyyy-MM-dd").format(stu.getRegDate()) : ""); } // 5. 设置响应头，触发下载 resp.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); String fileName = URLEncoder.encode("学员列表_" + new Date().getTime() + ".xlsx", "UTF-8"); resp.setHeader("Content-Disposition", "attachment; filename=" + fileName); // 6. 写出流 workbook.write(resp.getOutputStream()); workbook.close(); }

逻辑说明：XSSFWorkbook对应.xlsx（Excel 2007+），比HSSFWorkbook（.xls）支持更大行数；URLEncoder.encode()处理中文文件名，否则 Chrome 下下载文件名乱码；resp.getOutputStream()直接写二进制，不经过 JSP 渲染。

参数说明：

• sheet.createRow(0)从第 0 行开始，Excel 行号从 1 显示，但 POI 索引从 0；
• setCellValue()自动识别字符串/数字/日期，无需手动判断类型；
• workbook.close()必须调用，否则内存泄漏，100 次导出吃光 JVM 堆内存。

6. 从源码包到可运行系统：解压后必须做的七件事与三个验证技巧

拿到标题里的毕业设计-基于JSP的驾校管理系统-设计与实现（源码+论文+视频）.zip，别急着导入 IDE。这个压缩包大概率是某届学生打包的成品，但直接运行九成失败。我带过三届毕设，总结出解压后必须立即执行的七件事，以及三个快速验证是否真跑通的技巧。

6.1 解压后必做的七件事（按顺序）

1. 检查WEB-INF/web.xml的 servlet-mapping 路径
   打开web.xml，搜索<url-pattern>，确认所有路径不以//开头（如/admin//student/list是错的），且无空格。Tomcat 对路径空格极其敏感，一个空格就 404。

2. 核对WEB-INF/lib/下的 jar 包版本
   列出所有 jar，重点检查：mysql-connector-java-*.jar（必须 5.1.49 或 8.0.28，新版驱动不兼容老 Tomcat）、commons-dbcp2-*.jar（必须 2.9.0，2.8.x 有连接泄漏 bug）、poi-*.jar（必须 5.2.4，低版本不支持.xlsx）。版本不符立刻替换。

3. 修改数据库连接配置
   找到DBPoolListener.java或DBUtil.java，将setUrl()、setUsername()、setPassword()改成你本地 MySQL 的值。特别注意：如果 MySQL 8.0+ 用caching_sha2_password认证插件，必须在 URL 加?serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true，否则连不上。

4. 创建 uploads 目录并赋权
   在项目根目录下手动创建uploads/文件夹（不是WEB-INF/uploads/）。Tomcat 运行时用户需有写权限，Windows 下右键属性 → 安全 → 编辑 → 添加Users组并勾选“写入”；Linux 下chmod 755 uploads。

5. 清理build/和target/文件夹
   如果压缩包里包含这两个文件夹，全部删除。它们是编译产物，IDE 会重新生成，残留旧 class 文件会导致NoClassDefFoundError。

6. 检查 JSP 页面的 pageEncoding
   打开任意 JSP（如index.jsp），确认第一行是<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>。缺pageEncoding="UTF-8"，中文注释会编译报错。

7. 设置 Tomcat 的 URI 编码
   编辑conf/server.xml，找到<Connector port="8080" ... />，在末尾添加URIEncoding="UTF-8"：

   <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />

   不加这句，GET 请求的中文参数（如?name=张三）会变乱码。

6.2 三个验证技巧：5 分钟内确认系统是否真可用

最后说个血泪习惯：每次改完配置，我一定在 Tomcatbin/目录下执行./shutdown.sh && ./startup.sh（Windows 用shutdown.bat/startup.bat），而不是只点 IDE 的 restart 按钮。因为 IDE 的热部署有时不重载web.xml和server.xml，你以为重启了，其实还是旧配置在跑。这个习惯帮我少熬了 27 个通宵。

希望帮到你。

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