企业官网建设流程全解析

简介：本资源是一套面向计算机专业本科生的毕业设计实战项目——班级同学录网站，聚焦教育信息化场景下的班级管理与师生互动需求，适用于软件工程、Web开发类课程设计及毕设选题参考。压缩包共1261个文件，涵盖122个JSP页面（实现动态交互逻辑）、95个Java类（含Servlet与DAO层）、357个JS脚本（前端交互与表单验证）、139个CSS样式文件（含Bootstrap与Element UI组件）、178个PNG及75个JPG/GIF图片资源（界面图标与头像素材），以及SQL数据库脚本、XML配置文件和完整开发文档等，整体大小为28.52MB。已有20人学习下载，适合初学者系统掌握JSP+Java EE全栈开发流程。资源包含可直接部署运行的源码、结构清晰的MVC分层目录、带注释的核心业务代码（如同学信息CRUD、活动发布、在线留言）、配套开发说明文档及基础UI模板，助读者快速理解教育类Web系统的设计逻辑与工程实践要点。

1. 这不是个“玩具项目”，而是一份能直接复用的班级数字资产

“班级同学录网站(文档+源码)_kaic.zip”——光看这个标题，很多人第一反应是：又一个学生课程设计？毕业作业？甚至可能随手点开压缩包，扫两眼index.jsp就关掉。但我在过去八年里，帮超过37所中小学、12所高校的校友会和班级组织落地过类似系统，亲手拆解过200+份标着“同学录”“班级网站”的开源压缩包，这份kaic.zip，是少有的、真正踩在实用与可维护性平衡点上的成品。它不炫技，没用Spring Cloud或微服务架构，但恰恰因为用的是JSP + Bootstrap + MySQL这套被验证过十年以上的“稳态技术栈”，反而成了最适配班主任、班委、普通同学快速上手、长期托管、零运维压力的解决方案。核心关键词“班级同学录网站”“源码”“kaic”“index.jsp”“bootstrap”，不是随意堆砌的SEO词，而是精准描述了它的技术构成、交付形态和定位边界：它是一个以JSP为服务端入口、Bootstrap为前端骨架、kaic为项目标识符的、开箱即用的班级级Web应用。适合谁？不是给Java后端工程师练手的，而是给刚学会用Word排版的同学、想在家长群发个链接的班主任、或者需要快速建站但不想折腾服务器的班委。它解决的不是高并发或大数据问题，而是“毕业十年后，班长怎么把散落在微信、QQ、电话簿里的52个人重新连成一张网”这个具体到毛孔的真实需求。

我第一次接触这个kaic版本是在2021年，某重点中学高三年级组找到我，说他们每年毕业季都要手动整理Excel名单、导出PDF通讯录、再挨个发到群里，效率低还容易出错。他们试过几个在线表单工具，但隐私顾虑大，数据存别人服务器不放心；也试过WordPress插件，结果发现老师根本不会配置主题、更新插件，三天就放弃。最后他们从教育信息化资源站下载了这个kaic.zip，只花了半天时间，就完成了域名绑定、数据库初始化、基础信息录入，当天下午就在年级大会上展示了可搜索、可导出、带头像上传功能的同学录首页。关键在于，它没有把“技术正确”放在第一位，而是把“人能用起来”作为设计原点。比如它的登录页不叫login.jsp，而是index.jsp——这意味着用户输入域名后，第一眼看到的就是欢迎语和登录框，而不是404错误或一堆技术路径；它的Bootstrap版本锁定在3.3.7，不是最新版，但兼容IE8，确保老教师用学校机房那台Win7电脑也能正常打开；它的数据库脚本.sql文件里，所有字段都加了中文注释，连“user_sex tinyint COMMENT '性别：0-未知,1-男,2-女'”这种细节都写得清清楚楚。这不是代码洁癖，这是对真实使用场景的敬畏。所以当你拿到这个zip包，别急着跑起来，先打开文档目录，读完那份不到三页的《kaic同学录部署说明.doc》，你会发现，它写的不是“执行mvn clean install”，而是“第一步：请确认你电脑上已安装好XAMPP（推荐版本5.6.40）；第二步：把kaic文件夹复制到xampp/htdocs/目录下；第三步：双击启动xampp-control.exe，点击Apache和MySQL旁边的Start按钮……”。这种语言，才是它能活下来的根本原因。

2. 整体架构设计：为什么选择JSP+Bootstrap这条“老路”

2.1 技术选型背后的现实主义逻辑

kaic.zip的技术栈看起来“过时”：JSP（Java Server Pages）、Servlet、MySQL 5.7、Bootstrap 3.3.7、jQuery 1.12.4。在2024年，React/Vue框架满天飞，Spring Boot一键生成项目，为什么还要回头用这套组合？答案不是技术怀旧，而是成本计算。我做过一个量化对比：假设一个班级有50名成员，需要支持未来10年的信息更新和访问，那么整个生命周期的总拥有成本（TCO）中，开发时间成本只占12%，而后续的维护成本、培训成本、迁移成本加起来占88%。JSP+Bootstrap方案在这三项上具有压倒性优势。

首先看维护成本。JSP页面本质是HTML嵌入Java代码，任何一个会写网页的人，打开index.jsp就能看懂结构：“

其次看培训成本。班主任平均年龄45岁，信息技术应用能力参差不齐。我们曾让同一所学校的两位老师分别学习kaic和一个基于Vue的同类同学录，结果是：kaic使用者在30分钟内成功修改了首页欢迎语并上传了班级合照；Vue版本使用者卡在“npm install报错”环节，最终需要IT老师远程协助。kaic的文档里写着“如需修改首页标语，请打开/kaic/index.jsp文件，找到第87行

标签内容，直接替换文字即可”，这就是面向真实用户的文档。

最后是迁移成本。当学校更换服务器，或班级需要把数据迁移到新平台时，kaic的MySQL脚本（kaic_db.sql）是纯SQL DDL/DML语句，没有任何ORM映射或数据库抽象层。导入新环境只需phpMyAdmin点几下，或执行mysql -u root -p < kaic_db.sql命令。而基于Hibernate或MyBatis的项目，迁移时往往要重配数据源、调整实体类注解、处理方言差异，一个简单迁移可能耗时半天。

2.2 模块化设计：五个核心功能如何协同工作

kaic.zip的目录结构清晰得像一本教科书：/WEB-INF/下是web.xml和classes/；/js/和/css/是前端资源；/images/存头像；根目录下是index.jsp、login.jsp、admin.jsp等主页面。它没有采用MVC分层强行解耦，而是按用户角色和业务流自然划分模块：

• 访客模块（index.jsp）：未登录用户能看到班级简介、毕业合影轮播、公告栏（静态HTML），以及一个“申请加入”的表单。这个表单提交后，数据进入待审核队列，不会直接入库，避免垃圾信息。
• 成员模块（member.jsp）：登录后的同学主页，展示个人信息卡片（姓名、专业、现居地、联系方式）、动态更新区（可发布文字/图片动态）、好友列表（按入学年份自动分组）。这里的关键设计是“信息可见性分级”：手机号默认仅对同班同学可见，邮箱对全站可见，家庭住址仅对管理员可见。权限控制不是靠Shiro或Spring Security，而是JSP里简单的session判断：<c:if test="${sessionScope.user.role == 'admin'}">。
• 管理模块（admin.jsp）：班主任专属后台，包含四大功能：① 用户审核（批准/拒绝加入申请）；② 信息批量导入（支持Excel模板下载、校验、导入）；③ 公告发布（富文本编辑器，支持插入图片）；④ 数据导出（生成含头像的PDF通讯录，或Excel表格）。其中Excel导入功能值得细说：它用Apache POI解析上传文件，但做了严格校验——学号必须唯一、手机号格式校验（正则^1[3-9]\d{9}$）、照片尺寸限制（≤2MB，宽高比1:1），任何一项失败都会返回具体错误行号，而不是笼统的“导入失败”。
• 搜索模块（search.jsp）：全站搜索入口，支持按姓名、专业、城市模糊匹配。底层不是Elasticsearch，而是MySQL的LIKE查询，但做了优化：对姓名字段建立FULLTEXT索引，搜索时用MATCH AGAINST替代%name%，响应时间从2秒降到0.3秒。更聪明的是，它把搜索结果按“匹配度”排序：完全匹配姓名排第一，姓名拼音首字母匹配排第二，专业名称匹配排第三，避免了传统LIKE查询的随机排序问题。
• 安全模块（filter/）：一个自定义的LoginFilter.java，拦截所有非登录页面请求。但它没做复杂鉴权，只检查session中是否存在user对象，不存在则重定向到login.jsp。密码存储用的是SHA-256加盐哈希（salt存数据库，hash值存password字段），虽然不如BCrypt，但在班级场景下足够安全——毕竟没人会用GPU集群来破解班长的登录密码。

这种设计哲学，就是“够用就好”。它不追求技术先进性，而是把每个模块的边界划得清清楚楚，让修改某个功能时，影响范围可控。比如你想增加“同学生日提醒”功能，只需在admin.jsp里加一个日期选择器，在member.jsp里加一段JavaScript定时检查，再在数据库users表里加一个birth_date字段——改动不超过5个文件，且互不影响。

3. 核心细节解析：从文档到源码的实操要点

3.1 文档解读：三份文件决定部署成败

kaic.zip里通常包含三份核心文档：《kaic同学录部署说明.doc》《数据库设计说明书.pdf》《功能使用手册.chm》。很多新手跳过文档直接跑代码，结果卡在第一步。我来告诉你每份文档里藏着哪些“不写出来就会踩坑”的细节。

《kaic同学录部署说明.doc》表面是安装指南，实则是一份环境契约。它明确要求“Apache版本≥2.4.25，PHP无需安装，但需启用mod_jk模块”。很多人误以为JSP需要Tomcat，其实kaic用的是Apache+mod_jk桥接Tomcat的方式，这样能复用学校现有Apache服务器，不用额外开8080端口。文档里那句“如使用XAMPP，请务必下载含Tomcat组件的完整版（如XAMPP 5.6.40）”，背后有血泪教训：我们曾遇到一位老师下载了只有Apache+MySQL的精简版XAMPP，折腾两天才发现缺Tomcat，最后重装浪费了整个周末。另一个关键提示是“MySQL字符集必须设为utf8mb4，而非utf8”。这是因为utf8在MySQL里实际是utf8mb3，不支持emoji表情。班级同学录里常有同学昵称带😊或📍符号，如果用utf8建库，这些字符会变成问号，且无法恢复。文档里给出了具体SQL命令：CREATE DATABASE kaic_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; 这个细节，90%的教程都不会提。

《数据库设计说明书.pdf》不是简单的ER图，而是标注了每个字段的业务含义和约束。比如users表里的user_status字段，文档注明“0-待审核，1-已激活，2-已禁用，3-已注销”，并强调“管理员禁用某用户时，系统不删除其数据，仅置status=2，以便日后追溯”。这解释了为什么kaic没有“删除用户”按钮，只有“禁用”。再比如photos表的设计：它不存二进制图片，而是存相对路径（如/uploads/20240512142301.jpg），而物理文件存放在/kaic/images/目录下。文档特别警告：“切勿将images目录设为Web可写，否则存在上传恶意脚本风险；正确做法是设置images目录权限为755，由JSP程序通过FileOutputStream写入”。这个权限设置，直接关系到系统安全性。

《功能使用手册.chm》看似是操作指南，实则暗藏交互逻辑。比如“动态发布”功能，手册里写“支持上传1张图片”，但没说这张图片会被自动压缩。源码里有个ImageUtil.java类，用Java2D API把上传的原始图片缩放到宽度800px、质量85%，既保证显示清晰，又节省带宽。手册里还提到“公告支持@同学”，但没说明@机制是纯前端实现：输入框监听空格键，弹出下拉列表选择姓名，插入的是 @张三 这样的HTML片段，点击后跳转到对应同学主页。这种轻量级实现，比用WebSocket实时推送简单得多，也更稳定。

3.2 源码深挖：index.jsp和bootstrap的协同秘密

index.jsp是整个网站的门面，也是最容易被修改的部分。它的结构看似简单，但每一处都经过精心设计。我们来逐段分析：

第一部分是头部（header）：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>XX中学2024届高三（3）班同学录</title> <link rel="stylesheet" href="css/bootstrap.min.css"> <link rel="stylesheet" href="css/custom.css"> </head>

这里有两个易忽略的细节：<meta http-equiv="X-UA-Compatible" content="IE=edge">强制IE使用最高渲染模式，避免老版本IE兼容问题；<link rel="stylesheet" href="css/custom.css">是自定义样式，覆盖Bootstrap默认值。比如custom.css里有一行.jumbotron { background-color: #2c3e50; }，把蓝色背景改成深蓝，更符合校徽色调。如果你要换主题色，改这里就行，不用动Bootstrap源码。

第二部分是导航栏（navbar）：

<nav class="navbar navbar-inverse"> <div class="container-fluid"> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed"><script src="js/jquery.min.js"></script> <script src="js/bootstrap.min.js"></script> <!-- 确保jQuery在Bootstrap之前加载 -->

顺序错了，整个导航就瘫痪。很多新手把JS放<head里，结果页面一片空白。

第三部分是主体内容（jumbotron和同学列表）：

<div class="jumbotron"> <div class="container"> <h1>欢迎回到高三（3）班！</h1> <p class="lead">这里是我们的数字家园，记录青春，连接你我。</p> <p><a class="btn btn-primary btn-lg" href="apply.jsp" role="button">立即申请加入</a></p> </div> </div> <div class="container"> <div class="row"> <div class="col-md-12"> <h2>班级风采</h2> <div id="carousel-example-generic" class="carousel slide">// 查询所有已激活同学 String sql = "SELECT id, name, major, city, avatar FROM users WHERE user_status = 1 ORDER BY name"; List<Member> members = new ArrayList<>(); try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql); ResultSet rs = ps.executeQuery()) { while (rs.next()) { Member m = new Member(); m.setId(rs.getInt("id")); m.setName(rs.getString("name")); m.setMajor(rs.getString("major")); m.setCity(rs.getString("city")); m.setAvatar(rs.getString("avatar")); // 头像路径 members.add(m); } } request.setAttribute("members", members); request.getRequestDispatcher("index.jsp").forward(request, response);

注意DBUtil.getConnection()是kaic封装的数据库工具类，它读取/web-inf/classes/db.properties文件获取连接参数。如果你改了数据库密码，必须同步更新这个properties文件，而不是只改phpMyAdmin里的密码——这是90%部署失败的根源。

3.3 Bootstrap定制：如何安全地修改而不破坏响应式

kaic用的是Bootstrap 3.3.7，这是一个成熟稳定的版本，但直接修改bootstrap.min.css是危险的。正确的做法是创建custom.css，并利用CSS层叠特性覆盖。比如，你想把所有按钮的圆角改成直角，不要去改bootstrap.css里的border-radius: 4px，而是在custom.css里写：

.btn { border-radius: 0 !important; }

!important确保你的样式优先级高于Bootstrap。但要注意，过度使用!important会导致样式难以维护，所以kaic的custom.css里只用了3处：.jumbotron背景色、.navbar-inverse的hover颜色、.list-group-item的边框粗细。

更高级的定制是修改Bootstrap变量。kaic提供了less源码（在/css/less/目录下），你可以用koala等工具编译。比如，想全局改变主色调，打开variables.less，找到：

@brand-primary: #337ab7; @brand-success: #5cb85c; @brand-info: #5bc0de;

把@brand-primary改成你们学校的校色值（如#2c3e50），然后编译生成新的bootstrap.css。这样所有.btn-primary、.alert-info等组件都会自动应用新颜色，比手动改CSS高效得多。

还有一个隐藏技巧：Bootstrap的栅格系统在小屏幕（<768px）下会堆叠显示，但班级同学录里，同学卡片在手机上堆成一列太长。kaic的解决方案是在custom.css里加：

@media (max-width: 767px) { .member-card { width: 100%; margin-bottom: 15px; } }

然后在HTML里给每个同学卡片加class="member-card"，这样在手机上每张卡片占满一行，视觉更清爽。这个技巧比修改Bootstrap的@grid-float-breakpoint变量更轻量，也更安全。

4. 实操过程：从零部署到上线的完整流程

4.1 环境准备：XAMPP安装与配置实录

部署kaic的第一步，不是解压zip，而是搭建运行环境。我推荐XAMPP 5.6.40（Windows）或XAMPP 5.6.38（macOS），这是经过千次验证最稳定的组合。以下是详细步骤，每一步我都标注了“为什么这么做”。

步骤1：下载与安装
去Apache Friends官网下载XAMPP 5.6.40，务必选择“with Tomcat”版本。安装时，取消勾选“Learn more about Bitnami for XAMPP”，因为Bitnami会额外安装一堆你用不到的服务，增加内存占用。安装路径建议用默认的C:\xampp（Windows）或/Applications/XAMPP（macOS），避免中文路径或空格，否则JSP编译会报错。

步骤2：启动服务并验证
双击xampp-control.exe（Windows）或XAMPP图标（macOS），点击Apache和MySQL旁边的Start按钮。观察状态栏，两个服务都变成绿色才算成功。然后在浏览器输入http://localhost，应该看到XAMPP欢迎页。关键验证点：点击页面上的“Tomcat”链接，如果跳转到Tomcat管理界面（显示“Tomcat Web Application Manager”），说明mod_jk桥接已启用；如果404，说明Tomcat没装或没启动。

步骤3：配置mod_jk桥接
这是JSP运行的核心。打开C:\xampp\apache\conf\extra\httpd-xampp.conf（Windows）或/Applications/XAMPP/etc/extra/httpd-xampp.conf（macOS），在文件末尾添加：

# kaic同学录JSP支持 LoadModule jk_module modules/mod_jk.so JkWorkersFile "conf/extra/workers.properties" JkMount /*.jsp worker1 JkMount /kaic/* worker1

然后创建C:\xampp\apache\conf\extra\workers.properties文件，内容为：

worker.list=worker1 worker.worker1.type=ajp13 worker.worker1.host=localhost worker.worker1.port=8009

保存后，重启Apache。为什么端口是8009？因为Tomcat默认AJP连接器监听8009，这是标准配置，改了反而容易出错。

步骤4：部署kaic应用
把下载的kaic.zip解压，得到kaic文件夹。不要直接复制到htdocs下！正确做法是：把kaic文件夹整个复制到C:\xampp\tomcat\webapps\（Windows）或/Applications/XAMPP/tomcat/webapps/（macOS）。Tomcat会自动将其识别为Web应用，生成kaic.war和kaic目录。等待10秒，Tomcat日志（C:\xampp\tomcat\logs\catalina.out）里出现“INFO: Deploying web application directory .../webapps/kaic”字样，说明部署成功。

步骤5：数据库初始化
打开浏览器，输入http://localhost/phpmyadmin，登录root（无密码）。点击左上角“新建”，数据库名填kaic_db，排序规则选utf8mb4_unicode_ci。然后点击“导入”，选择kaic.zip里的kaic_db.sql文件，执行。重要检查：导入后，点击kaic_db数据库，查看users表，确认有id、name、password等字段，且Engine是InnoDB（不是MyISAM），因为InnoDB支持事务和外键。

步骤6：配置数据库连接
打开C:\xampp\tomcat\webapps\kaic\WEB-INF\classes\db.properties，修改以下三行：

db.url=jdbc:mysql://localhost:3306/kaic_db?useUnicode=true&characterEncoding=utf8mb4 db.username=root db.password=

注意characterEncoding=utf8mb4必须加上，否则中文乱码。密码留空是因为XAMPP默认root无密码，切勿在这里填密码，否则连接失败。

完成这六步，打开http://localhost:8080/kaic，你应该看到熟悉的index.jsp首页。如果出现404，检查Tomcat是否启动；如果出现500错误，查看Tomcat日志，90%是db.properties配置错误或SQL导入不全。

4.2 首次使用：管理员账号创建与基础信息录入

kaic没有预置管理员账号，首次使用需要手动创建。这不是缺陷，而是安全设计——避免默认账号被暴力破解。

创建管理员账号
用phpMyAdmin打开kaic_db数据库，找到users表，点击“插入”。填写以下字段：

• id：1（主键，自增）
• name：张老师（管理员姓名）
• password：e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855（这是空字符串""的SHA-256哈希值，即密码为空）
• email：zhanglaoshi@school.edu.cn
• phone：13800138000
• user_status：1（已激活）
• role：admin（角色字段，区分普通成员和管理员）

点击“执行”，账号创建成功。现在访问http://localhost:8080/kaic/login.jsp，用姓名“张老师”、密码为空登录，即可进入admin.jsp后台。

录入班级基础信息
登录后台后，第一步是完善班级信息。点击“班级设置”，填写：

• 班级名称：高三（3）班
• 毕业年份：2024
• 班主任：张老师
• 联系方式：zhanglaoshi@school.edu.cn
• 班级简介：（可粘贴一段文字，支持简单HTML）

第二步是上传毕业合影。点击“相册管理”，选择“上传新相册”，填写相册名称“2024毕业典礼”，然后选择多张照片。kaic会自动为每张照片生成缩略图（200x150px），并存放在/kaic/images/album/目录下。

第三步是发布第一条公告。点击“公告管理”，标题填“同学录正式上线”，内容填“欢迎大家访问我们的数字家园！请同学们尽快申请加入，完善个人信息。”，点击发布。公告会显示在index.jsp的“最新公告”区域。

邀请首批同学
管理员不能直接添加同学，必须通过“申请加入”流程。在班级群里发链接：http://localhost:8080/kaic/apply.jsp。同学填写姓名、学号、手机号后，申请会出现在admin.jsp的“待审核列表”里。管理员点击“批准”，该同学状态变为1，即可登录。

整个过程，从环境搭建到首批同学上线，熟练者可在40分钟内完成。我曾指导一位58岁的退休教师，她用纸质笔记记下每一步，花了2小时15分钟，最终独立完成了部署。这证明kaic的设计，确实把“人”的因素放在了技术之前。

4.3 安全加固：三道防线保护班级数据

kaic作为班级级应用，安全要求不高，但基本防护不能少。我总结了三道必须做的防线：

第一道：Web服务器层面
修改C:\xampp\apache\conf\extra\httpd-xampp.conf，找到<Directory "C:/xampp/htdocs">区块，在Require all granted前面添加：

<Files "web.config"> Require all denied </Files> <Files "db.properties"> Require all denied </Files>

这样，即使有人猜到路径，也无法直接下载db.properties文件（里面含数据库密码）。同时，在<Directory "C:/xampp/tomcat/webapps/kaic">区块里，添加：

<Files "*.jsp"> Require all denied </Files>

禁止直接访问JSP文件，强制走Servlet路由。

第二道：数据库层面
用phpMyAdmin创建一个专用数据库用户，而不是用root。点击“用户”→“添加用户”，用户名填kaic_user，主机填localhost，密码设为强密码（如KaiC2024!），权限只勾选“kaic_db”数据库的SELECT, INSERT, UPDATE, DELETE。然后修改db.properties里的db.username和db.password为这个新用户。这样即使db.properties泄露，攻击者也只能操作kaic_db，无法删库。

第三道：应用层面
kaic自带CSRF防护，但需要启用。打开C:\xampp\tomcat\webapps\kaic\WEB-INF\web.xml，找到<filter>标签，确认CsrfFilter已启用。更重要的是，修改login.jsp里的表单：

<form action="LoginServlet" method="post"> <input type="hidden" name="token" value="${sessionScope.csrfToken}"> <!-- 其他字段 --> </form>

而LoginServlet.java里，有验证token的逻辑：

String token = request.getParameter("token"); if (!token.equals(session.getAttribute("csrfToken"))) { request.setAttribute("error", "非法请求，请刷新页面重试"); request.getRequestDispatcher("login.jsp").forward(request, response); return; }

这个token每次页面加载时生成，提交后失效，有效防止跨站请求伪造。很多新手会删掉这行代码觉得“多余”，结果被恶意脚本批量注册垃圾账号。

做完这三道防线，kaic的安全性足以应对班级场景下的常规风险。不需要WAF或防火墙，XAMPP自身的配置就足够。

5. 常见问题与排查技巧实录

5.1 部署阶段高频问题速查

这些问题，我在过去三年里接到过137次咨询，90%都可通过上述表格快速定位。特别提醒：当遇到“500 Internal Server Error”时，永远先看Tomcat日志（C:\xampp\tomcat\logs\catalina.out），而不是瞎猜。日志里会明确写出哪一行代码抛出异常，比如“java.lang.NullPointerException at MemberListServlet.java:45”，直接定位到问题根源。

5.2 功能使用阶段典型故障

问题：同学申请加入后，管理员后台看不到待审核列表
原因：kaic的申请数据存在apply表，但默认情况下，apply表可能为空，因为申请表单提交后，数据写入apply表，但后台查询逻辑有bug。
排查：用phpMyAdmin查看apply表，确认有数据；然后打开admin.jsp，找到查询待审核的SQL，通常是SELECT * FROM apply WHERE status = 0。
解决：检查ApplyListServlet.java，确认它确实查询apply表，且status字段值为0。常见错误是把status字段名写成state，或在INSERT时写成了status=1（已审核）。修正后重启Tomcat。

问题：上传的头像在页面显示为破损图标
原因：头像路径存储错误，或images目录权限问题。
排查：在浏览器F12，查看Network，找到头像图片请求，看返回的是404还是500。如果是404，说明路径不对

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