简介这是一套基于Java的高校校友信息管理系统完整项目源码面向计算机相关专业做毕业设计、课程设计或期末大作业的学生以及需要实战练手的Java学习者。项目采用SSM框架搭配JSP技术运行于JDK1.8、Tomcat7与MySQL5.7环境分为系统管理员、班级管理员和注册用户三类角色涵盖登录密码修改、用户信息管理、新闻信息、班级相册、留言互动及个人信息管理等模块功能结构贴近真实业务场景。压缩包共1287个文件约65.86MB以java源码、jsp页面、js脚本、css样式及png、gif、jpg等图片资源为主另含sql数据库脚本、xml配置、properties文件与mp4演示视频并附开发说明、部署视频、lw文档和运行截图。目前已有209人学习下载。整套资料经过严格调试可直接作为毕设方案使用帮助读者快速理解SSM分层结构、数据库设计与前后端交互流程省去从零搭建的时间成本。1. 拿到一份 Java 高校校友信息管理系统源码先别急着导入 IDE很多同学做 Java 课程设计或毕业设计时第一反应是去搜「Java 高校校友信息管理系统源码.zip」下载下来解压然后直接往 Eclipse 或 IDEA 里一拖结果满屏红叉数据库连不上Tomcat 一启动就报 500。这个场景太常见了。这份源码本质上是一个典型的 Java Web 管理系统核心功能围绕校友信息的增删改查、班级/院系分类、活动记录和统计报表展开技术栈通常是 Servlet/JSP 或 SSMSpring Spring MVC MyBatis数据库用 MySQL。它适合三类人正在做课程设计需要参考实现的学生、想通过一个完整项目巩固 Java Web 基础的初学者、以及需要快速搭建校友管理原型的小型开发团队。但「拿到源码」和「跑起来」之间隔着环境配置、数据库初始化、依赖版本对齐三道坎。这一章先把这份源码的骨架讲清楚后面几章再一步步拆解怎么让它真正跑起来。2. 拆解校友管理系统的技术栈与目录结构从 web.xml 到实体类2.1 先看技术栈SSM 还是 Servlet/JSP决定了你怎么配拿到源码压缩包解压后第一件事不是打开 IDE而是看目录结构和关键配置文件。常见的 Java 高校校友信息管理系统源码有两种技术路线一种是较老的 Servlet JSP JDBC另一种是 SSM 框架。判断方法很简单看WEB-INF下有没有applicationContext.xml和spring-mvc.xml有就是 SSM如果只有web.xml和一堆 Servlet 类那就是原生 Servlet/JSP。SSM 项目的典型目录结构是这样的AlumniSystem/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/alumni/ │ │ │ ├── controller/ # 控制层 │ │ │ ├── service/ # 业务层 │ │ │ ├── mapper/ # 持久层接口 │ │ │ └── entity/ # 实体类 │ │ ├── resources/ │ │ │ ├── mapper/ # MyBatis XML │ │ │ ├── applicationContext.xml │ │ │ └── jdbc.properties │ │ └── webapp/ │ │ ├── WEB-INF/ │ │ │ ├── web.xml │ │ │ └── views/ # JSP 页面 │ │ └── static/ # CSS/JS └── pom.xml如果是 Maven 项目pom.xml里会列出所有依赖。重点看三个版本Spring 版本、MyBatis 版本、MySQL 驱动版本。这三个版本不匹配是后面报错的主要来源。比如 Spring 5.x 配 MyBatis 3.5.x 是稳的但如果 MySQL 驱动用的是 8.x而jdbc.properties里的 URL 没加时区参数启动就会报The server time zone value is unrecognized。2.2 数据库表结构校友信息管理系统的核心表就这几张不管前端怎么变校友管理系统的数据库表结构基本固定。打开源码里的.sql文件通常能看到以下核心表表名作用关键字段alumni_info校友基本信息id, name, gender, graduation_year, class_name, major, phone, email, companydepartment院系信息id, dept_name, dept_codeclass_info班级信息id, class_name, dept_id, graduation_yearactivity校友活动id, title, activity_date, location, descriptionuser系统用户id, username, password, role其中alumni_info是核心表字段最多也最容易在导入时出问题。比如graduation_year如果定义成varchar而不是int后面做统计查询时排序会变成字符串排序2023 会排在 2022 前面这就是典型的「玄学 bug」。2.3 用一条 SQL 验证数据库是否初始化成功导入 SQL 文件后不要急着启动项目先用命令行验证mysql -u root -p alumni_db alumni_db.sql mysql -u root -p -e USE alumni_db; SHOW TABLES; SELECT COUNT(*) FROM alumni_info;第一行是导入 SQL 文件第二行是查看表列表和校友记录数。如果alumni_info返回 0 条记录说明 SQL 文件里只有建表语句没有插入数据这时候系统跑起来会是空页面不是报错但你会以为「跑通了其实没数据」。常见做法是手动插入几条测试数据INSERT INTO alumni_info (name, gender, graduation_year, class_name, major, phone, email, company) VALUES (张三, 男, 2020, 计算机1601, 计算机科学与技术, 13800000001, zhangsanexample.com, 某科技公司);执行完再查一次确认有数据。这一步看着简单但很多新手跳过后面调试时浪费大量时间在「为什么列表是空的」上。3. 把源码跑起来JDK、Tomcat、MySQL 的版本对齐与启动命令3.1 环境准备三个版本号必须对齐Java Web 项目跑不起来八成是版本问题。我一般按这个组合来配JDK 1.8不要用 JDK 11 或 17老项目的 JSP 编译会出问题Tomcat 8.5 或 9.0Tomcat 10 的 Servlet API 包名从javax变成jakarta老项目直接崩MySQL 5.7 或 8.08.0 要改驱动类和 URL检查 JDK 版本java -version javac -version两个命令输出的版本号必须一致。如果java -version是 1.8 而javac -version是 11说明系统里有多个 JDKJAVA_HOME指向不对。Windows 下改环境变量Linux/Mac 下改~/.bash_profile或~/.zshrc。3.2 修改 jdbc.properties数据库连接的四要素打开src/main/resources/jdbc.properties通常是这样的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/alumni_db?useUnicodetruecharacterEncodingutf-8 jdbc.usernameroot jdbc.password123456如果你用的是 MySQL 8.0驱动类要改成com.mysql.cj.jdbc.DriverURL 要加时区和 SSL 参数jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/alumni_db?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码serverTimezone不设会报时区错误useSSLfalse不设会有警告。这两个参数是 MySQL 8.0 的标配少一个都可能启动失败。3.3 用 Maven 打包并部署到 Tomcat如果项目是 Maven 结构在项目根目录执行mvn clean package -DskipTestsclean清掉旧编译产物package打成 war 包-DskipTests跳过测试老项目的测试类经常跑不过跳过能省时间。打包成功后target目录下会出现AlumniSystem.war。把这个文件复制到 Tomcat 的webapps目录cp target/AlumniSystem.war $TOMCAT_HOME/webapps/ $TOMCAT_HOME/bin/startup.sh启动后访问http://localhost:8080/AlumniSystem/如果看到登录页说明部署成功。如果报 404检查web.xml里的welcome-file和实际首页文件名是否一致如果报 500看 Tomcat 日志logs/catalina.out通常是数据库连接失败或 Spring 配置错误。3.4 非 Maven 项目的导入方式如果源码没有pom.xml那就是传统的 Eclipse 动态 Web 项目。导入步骤Eclipse → File → Import → Existing Projects into Workspace → 选择解压后的目录。导入后右键项目 → Properties → Project Facets确认 Dynamic Web Module 版本和 Java 版本。然后把 MySQL 驱动 jar 放到WEB-INF/lib下右键 → Build Path → Add to Build Path。最后配置 Tomcat Server右键项目 → Run As → Run on Server。这种方式容易出的问题是WEB-INF/lib下的 jar 包和 Tomcat 自带的 jar 冲突比如servlet-api.jar重复。解决办法是在 Build Path 里把 Tomcat 的库加到 Server Runtime而不是手动复制servlet-api.jar。4. 校友信息增删改查的代码链路从 Controller 到 Mapper 的完整调用4.1 一条校友记录的查询请求经历了什么以「按姓名模糊查询校友」为例请求从浏览器发出到返回 JSON经过四层浏览器请求/alumni/search?name张AlumniController接收请求调用AlumniService.searchByName(张)AlumniServiceImpl调用AlumniMapper.selectByName(张)MyBatis 执行AlumniMapper.xml里的 SQL返回ListAlumniController 层的典型代码Controller RequestMapping(/alumni) public class AlumniController { Autowired private AlumniService alumniService; RequestMapping(/search) ResponseBody public MapString, Object search(RequestParam(value name, required false) String name) { MapString, Object result new HashMap(); ListAlumni list alumniService.searchByName(name); result.put(code, 200); result.put(data, list); result.put(total, list.size()); return result; } }RequestMapping(/search)映射 URLRequestParam接收查询参数required false表示姓名可以不传不传就查全部。返回的 Map 里code是状态码data是数据列表total是总数前端表格分页会用到。4.2 MyBatis 映射文件里的 SQL 怎么写才不出错对应的AlumniMapper.xmlselect idselectByName resultTypecom.alumni.entity.Alumni SELECT id, name, gender, graduation_year, class_name, major, phone, email, company FROM alumni_info where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if /where ORDER BY graduation_year DESC /selectwhere标签会自动处理第一个ANDif做条件判断。CONCAT(%, #{name}, %)是 MySQL 的模糊查询写法用#{}而不是${}能防止 SQL 注入。ORDER BY graduation_year DESC让最新毕业的校友排在前面。这里有个坑如果graduation_year字段在数据库里是varchar类型ORDER BY会按字符串排序2023 会排在 2022 前面但 2023 和 2022 之间可能插着 202。解决办法是在 SQL 里转成数字ORDER BY CAST(graduation_year AS UNSIGNED) DESC。4.3 新增校友时的参数校验与事务处理新增校友的 Service 层代码Service Transactional public class AlumniServiceImpl implements AlumniService { Autowired private AlumniMapper alumniMapper; Override public int addAlumni(Alumni alumni) { if (alumni.getName() null || alumni.getName().trim().isEmpty()) { throw new RuntimeException(姓名不能为空); } if (alumni.getGraduationYear() null) { throw new RuntimeException(毕业年份不能为空); } return alumniMapper.insert(alumni); } }Transactional保证方法内多个数据库操作要么全成功要么全回滚。参数校验放在 Service 层而不是 Controller 层是为了让其他调用方比如定时任务也能复用校验逻辑。alumniMapper.insert(alumni)返回影响行数1 表示成功0 表示失败。对应的 Mapper XMLinsert idinsert parameterTypecom.alumni.entity.Alumni useGeneratedKeystrue keyPropertyid INSERT INTO alumni_info (name, gender, graduation_year, class_name, major, phone, email, company) VALUES (#{name}, #{gender}, #{graduationYear}, #{className}, #{major}, #{phone}, #{email}, #{company}) /insertuseGeneratedKeystrue和keyPropertyid让插入后自动把数据库生成的主键回填到实体类的id字段后面如果需要用这个 id 做关联操作就不用再查一次。5. 避坑与排查源码跑不起来时先看这五个地方5.1 现象Tomcat 启动报 ClassNotFoundException原因依赖 jar 包没导入或版本冲突。常见的是spring-webmvc.jar和spring-context.jar版本不一致或者WEB-INF/lib下缺少mybatis-spring的桥接包。解决如果是 Maven 项目执行mvn dependency:tree查看依赖树找到冲突的包用exclusions排除。如果是非 Maven 项目检查WEB-INF/lib下是否有spring-webmvc-5.x.x.jar、spring-context-5.x.x.jar、mybatis-3.5.x.jar、mybatis-spring-2.x.x.jar版本号要匹配。5.2 现象页面报 500日志显示 Access denied for user rootlocalhost原因jdbc.properties里的用户名或密码不对或者 MySQL 用户没有远程/本地访问权限。解决先用命令行验证账号密码mysql -u root -p能登录说明密码对。如果登录不了用ALTER USER rootlocalhost IDENTIFIED BY 新密码;重置。如果密码对但项目连不上检查jdbc.url里的主机名是localhost还是127.0.0.1有些环境里localhost会走 socket 连接而不是 TCP。5.3 现象中文乱码校友姓名显示成问号原因数据库字符集、JDBC URL 字符集、JSP 页面编码三者不一致。解决三步统一。数据库层面ALTER DATABASE alumni_db CHARACTER SET utf8mb4;。JDBC URL 加characterEncodingutf-8。JSP 页面顶部加% page contentTypetext/html;charsetUTF-8 languagejava %。Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。5.4 现象MyBatis 报 Invalid bound statement (not found)原因Mapper XML 文件没有被扫描到或者 XML 里的namespace和接口全限定名不一致。解决检查applicationContext.xml里mapperLocations配置的路径是否匹配实际文件位置常见配置是classpath:mapper/*.xml。再检查 XML 的namespace是否等于 Mapper 接口的全限定名比如com.alumni.mapper.AlumniMapper。如果用的是 MavenXML 文件要放在src/main/resources下放在src/main/java下默认不会被打包。5.5 现象修改代码后重启 Tomcat 不生效原因Tomcat 缓存了旧的编译产物或者 IDE 没有自动重新编译。解决删除 Tomcat 的work目录和webapps/AlumniSystem目录重新部署 war 包。在 IDEA 里Build → Rebuild Project然后重新 Run。如果用的是 EclipseProject → Clean然后重新发布。6. 从跑通到改好给校友管理系统加一个毕业年份统计图表的技巧跑通源码只是第一步真正让这个项目变成自己的东西是能按需求改功能。这里拿「毕业年份分布统计」举例讲一个具体技巧用 Java 后端聚合数据前端用 ECharts 渲染柱状图。先在 Mapper 里加一个统计查询select idcountByGraduationYear resultTypemap SELECT graduation_year AS year, COUNT(*) AS count FROM alumni_info GROUP BY graduation_year ORDER BY graduation_year ASC /selectresultTypemap让 MyBatis 把每行结果封装成MapString, Objectkey 是字段名value 是值。Service 层直接返回ListMapString, ObjectOverride public ListMapString, Object countByGraduationYear() { return alumniMapper.countByGraduationYear(); }Controller 层RequestMapping(/stats/year) ResponseBody public MapString, Object statsByYear() { MapString, Object result new HashMap(); result.put(code, 200); result.put(data, alumniService.countByGraduationYear()); return result; }前端 JSP 页面引入 ECharts发 AJAX 请求拿数据$.get(/AlumniSystem/alumni/stats/year, function(res) { var years res.data.map(function(item) { return item.year; }); var counts res.data.map(function(item) { return item.count; }); var chart echarts.init(document.getElementById(yearChart)); chart.setOption({ title: { text: 校友毕业年份分布 }, tooltip: { trigger: axis }, xAxis: { type: category, data: years }, yAxis: { type: value }, series: [{ type: bar, data: counts, itemStyle: { color: #5470c6 } }] }); });这段代码的关键点后端只负责返回原始统计数据不做任何图表格式处理前端用map把数据拆成两个数组分别对应 X 轴和 Y 轴。这样后端接口是通用的以后换图表库也不用改后端。参数说明GROUP BY graduation_year按年份分组COUNT(*)统计每组的记录数ORDER BY graduation_year ASC让年份从小到大排列。如果graduation_year是varchar类型ORDER BY会按字符串排序需要在 SQL 里加CAST(graduation_year AS UNSIGNED)。我自己的习惯是每改一个功能先在数据库里用 SQL 验证结果对不对再写 Java 代码。SQL 跑出来的数据不对Java 代码写得再漂亮也没用。这个项目我前后跑过不下十遍每次换环境都会遇到新的版本兼容问题但核心链路始终是「数据库连上 → Mapper 扫描到 → Service 事务生效 → Controller 返回 JSON」。把这四步拆开排查没有跑不起来的 Java Web 项目。希望帮到你。本文还有配套的精品资源点击获取 Java高校校友信息管理系统源码解析与实战部署指南
简介这是一套基于Java的高校校友信息管理系统完整项目源码面向计算机相关专业做毕业设计、课程设计或期末大作业的学生以及需要实战练手的Java学习者。项目采用SSM框架搭配JSP技术运行于JDK1.8、Tomcat7与MySQL5.7环境分为系统管理员、班级管理员和注册用户三类角色涵盖登录密码修改、用户信息管理、新闻信息、班级相册、留言互动及个人信息管理等模块功能结构贴近真实业务场景。压缩包共1287个文件约65.86MB以java源码、jsp页面、js脚本、css样式及png、gif、jpg等图片资源为主另含sql数据库脚本、xml配置、properties文件与mp4演示视频并附开发说明、部署视频、lw文档和运行截图。目前已有209人学习下载。整套资料经过严格调试可直接作为毕设方案使用帮助读者快速理解SSM分层结构、数据库设计与前后端交互流程省去从零搭建的时间成本。1. 拿到一份 Java 高校校友信息管理系统源码先别急着导入 IDE很多同学做 Java 课程设计或毕业设计时第一反应是去搜「Java 高校校友信息管理系统源码.zip」下载下来解压然后直接往 Eclipse 或 IDEA 里一拖结果满屏红叉数据库连不上Tomcat 一启动就报 500。这个场景太常见了。这份源码本质上是一个典型的 Java Web 管理系统核心功能围绕校友信息的增删改查、班级/院系分类、活动记录和统计报表展开技术栈通常是 Servlet/JSP 或 SSMSpring Spring MVC MyBatis数据库用 MySQL。它适合三类人正在做课程设计需要参考实现的学生、想通过一个完整项目巩固 Java Web 基础的初学者、以及需要快速搭建校友管理原型的小型开发团队。但「拿到源码」和「跑起来」之间隔着环境配置、数据库初始化、依赖版本对齐三道坎。这一章先把这份源码的骨架讲清楚后面几章再一步步拆解怎么让它真正跑起来。2. 拆解校友管理系统的技术栈与目录结构从 web.xml 到实体类2.1 先看技术栈SSM 还是 Servlet/JSP决定了你怎么配拿到源码压缩包解压后第一件事不是打开 IDE而是看目录结构和关键配置文件。常见的 Java 高校校友信息管理系统源码有两种技术路线一种是较老的 Servlet JSP JDBC另一种是 SSM 框架。判断方法很简单看WEB-INF下有没有applicationContext.xml和spring-mvc.xml有就是 SSM如果只有web.xml和一堆 Servlet 类那就是原生 Servlet/JSP。SSM 项目的典型目录结构是这样的AlumniSystem/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/alumni/ │ │ │ ├── controller/ # 控制层 │ │ │ ├── service/ # 业务层 │ │ │ ├── mapper/ # 持久层接口 │ │ │ └── entity/ # 实体类 │ │ ├── resources/ │ │ │ ├── mapper/ # MyBatis XML │ │ │ ├── applicationContext.xml │ │ │ └── jdbc.properties │ │ └── webapp/ │ │ ├── WEB-INF/ │ │ │ ├── web.xml │ │ │ └── views/ # JSP 页面 │ │ └── static/ # CSS/JS └── pom.xml如果是 Maven 项目pom.xml里会列出所有依赖。重点看三个版本Spring 版本、MyBatis 版本、MySQL 驱动版本。这三个版本不匹配是后面报错的主要来源。比如 Spring 5.x 配 MyBatis 3.5.x 是稳的但如果 MySQL 驱动用的是 8.x而jdbc.properties里的 URL 没加时区参数启动就会报The server time zone value is unrecognized。2.2 数据库表结构校友信息管理系统的核心表就这几张不管前端怎么变校友管理系统的数据库表结构基本固定。打开源码里的.sql文件通常能看到以下核心表表名作用关键字段alumni_info校友基本信息id, name, gender, graduation_year, class_name, major, phone, email, companydepartment院系信息id, dept_name, dept_codeclass_info班级信息id, class_name, dept_id, graduation_yearactivity校友活动id, title, activity_date, location, descriptionuser系统用户id, username, password, role其中alumni_info是核心表字段最多也最容易在导入时出问题。比如graduation_year如果定义成varchar而不是int后面做统计查询时排序会变成字符串排序2023 会排在 2022 前面这就是典型的「玄学 bug」。2.3 用一条 SQL 验证数据库是否初始化成功导入 SQL 文件后不要急着启动项目先用命令行验证mysql -u root -p alumni_db alumni_db.sql mysql -u root -p -e USE alumni_db; SHOW TABLES; SELECT COUNT(*) FROM alumni_info;第一行是导入 SQL 文件第二行是查看表列表和校友记录数。如果alumni_info返回 0 条记录说明 SQL 文件里只有建表语句没有插入数据这时候系统跑起来会是空页面不是报错但你会以为「跑通了其实没数据」。常见做法是手动插入几条测试数据INSERT INTO alumni_info (name, gender, graduation_year, class_name, major, phone, email, company) VALUES (张三, 男, 2020, 计算机1601, 计算机科学与技术, 13800000001, zhangsanexample.com, 某科技公司);执行完再查一次确认有数据。这一步看着简单但很多新手跳过后面调试时浪费大量时间在「为什么列表是空的」上。3. 把源码跑起来JDK、Tomcat、MySQL 的版本对齐与启动命令3.1 环境准备三个版本号必须对齐Java Web 项目跑不起来八成是版本问题。我一般按这个组合来配JDK 1.8不要用 JDK 11 或 17老项目的 JSP 编译会出问题Tomcat 8.5 或 9.0Tomcat 10 的 Servlet API 包名从javax变成jakarta老项目直接崩MySQL 5.7 或 8.08.0 要改驱动类和 URL检查 JDK 版本java -version javac -version两个命令输出的版本号必须一致。如果java -version是 1.8 而javac -version是 11说明系统里有多个 JDKJAVA_HOME指向不对。Windows 下改环境变量Linux/Mac 下改~/.bash_profile或~/.zshrc。3.2 修改 jdbc.properties数据库连接的四要素打开src/main/resources/jdbc.properties通常是这样的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/alumni_db?useUnicodetruecharacterEncodingutf-8 jdbc.usernameroot jdbc.password123456如果你用的是 MySQL 8.0驱动类要改成com.mysql.cj.jdbc.DriverURL 要加时区和 SSL 参数jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/alumni_db?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码serverTimezone不设会报时区错误useSSLfalse不设会有警告。这两个参数是 MySQL 8.0 的标配少一个都可能启动失败。3.3 用 Maven 打包并部署到 Tomcat如果项目是 Maven 结构在项目根目录执行mvn clean package -DskipTestsclean清掉旧编译产物package打成 war 包-DskipTests跳过测试老项目的测试类经常跑不过跳过能省时间。打包成功后target目录下会出现AlumniSystem.war。把这个文件复制到 Tomcat 的webapps目录cp target/AlumniSystem.war $TOMCAT_HOME/webapps/ $TOMCAT_HOME/bin/startup.sh启动后访问http://localhost:8080/AlumniSystem/如果看到登录页说明部署成功。如果报 404检查web.xml里的welcome-file和实际首页文件名是否一致如果报 500看 Tomcat 日志logs/catalina.out通常是数据库连接失败或 Spring 配置错误。3.4 非 Maven 项目的导入方式如果源码没有pom.xml那就是传统的 Eclipse 动态 Web 项目。导入步骤Eclipse → File → Import → Existing Projects into Workspace → 选择解压后的目录。导入后右键项目 → Properties → Project Facets确认 Dynamic Web Module 版本和 Java 版本。然后把 MySQL 驱动 jar 放到WEB-INF/lib下右键 → Build Path → Add to Build Path。最后配置 Tomcat Server右键项目 → Run As → Run on Server。这种方式容易出的问题是WEB-INF/lib下的 jar 包和 Tomcat 自带的 jar 冲突比如servlet-api.jar重复。解决办法是在 Build Path 里把 Tomcat 的库加到 Server Runtime而不是手动复制servlet-api.jar。4. 校友信息增删改查的代码链路从 Controller 到 Mapper 的完整调用4.1 一条校友记录的查询请求经历了什么以「按姓名模糊查询校友」为例请求从浏览器发出到返回 JSON经过四层浏览器请求/alumni/search?name张AlumniController接收请求调用AlumniService.searchByName(张)AlumniServiceImpl调用AlumniMapper.selectByName(张)MyBatis 执行AlumniMapper.xml里的 SQL返回ListAlumniController 层的典型代码Controller RequestMapping(/alumni) public class AlumniController { Autowired private AlumniService alumniService; RequestMapping(/search) ResponseBody public MapString, Object search(RequestParam(value name, required false) String name) { MapString, Object result new HashMap(); ListAlumni list alumniService.searchByName(name); result.put(code, 200); result.put(data, list); result.put(total, list.size()); return result; } }RequestMapping(/search)映射 URLRequestParam接收查询参数required false表示姓名可以不传不传就查全部。返回的 Map 里code是状态码data是数据列表total是总数前端表格分页会用到。4.2 MyBatis 映射文件里的 SQL 怎么写才不出错对应的AlumniMapper.xmlselect idselectByName resultTypecom.alumni.entity.Alumni SELECT id, name, gender, graduation_year, class_name, major, phone, email, company FROM alumni_info where if testname ! null and name ! AND name LIKE CONCAT(%, #{name}, %) /if /where ORDER BY graduation_year DESC /selectwhere标签会自动处理第一个ANDif做条件判断。CONCAT(%, #{name}, %)是 MySQL 的模糊查询写法用#{}而不是${}能防止 SQL 注入。ORDER BY graduation_year DESC让最新毕业的校友排在前面。这里有个坑如果graduation_year字段在数据库里是varchar类型ORDER BY会按字符串排序2023 会排在 2022 前面但 2023 和 2022 之间可能插着 202。解决办法是在 SQL 里转成数字ORDER BY CAST(graduation_year AS UNSIGNED) DESC。4.3 新增校友时的参数校验与事务处理新增校友的 Service 层代码Service Transactional public class AlumniServiceImpl implements AlumniService { Autowired private AlumniMapper alumniMapper; Override public int addAlumni(Alumni alumni) { if (alumni.getName() null || alumni.getName().trim().isEmpty()) { throw new RuntimeException(姓名不能为空); } if (alumni.getGraduationYear() null) { throw new RuntimeException(毕业年份不能为空); } return alumniMapper.insert(alumni); } }Transactional保证方法内多个数据库操作要么全成功要么全回滚。参数校验放在 Service 层而不是 Controller 层是为了让其他调用方比如定时任务也能复用校验逻辑。alumniMapper.insert(alumni)返回影响行数1 表示成功0 表示失败。对应的 Mapper XMLinsert idinsert parameterTypecom.alumni.entity.Alumni useGeneratedKeystrue keyPropertyid INSERT INTO alumni_info (name, gender, graduation_year, class_name, major, phone, email, company) VALUES (#{name}, #{gender}, #{graduationYear}, #{className}, #{major}, #{phone}, #{email}, #{company}) /insertuseGeneratedKeystrue和keyPropertyid让插入后自动把数据库生成的主键回填到实体类的id字段后面如果需要用这个 id 做关联操作就不用再查一次。5. 避坑与排查源码跑不起来时先看这五个地方5.1 现象Tomcat 启动报 ClassNotFoundException原因依赖 jar 包没导入或版本冲突。常见的是spring-webmvc.jar和spring-context.jar版本不一致或者WEB-INF/lib下缺少mybatis-spring的桥接包。解决如果是 Maven 项目执行mvn dependency:tree查看依赖树找到冲突的包用exclusions排除。如果是非 Maven 项目检查WEB-INF/lib下是否有spring-webmvc-5.x.x.jar、spring-context-5.x.x.jar、mybatis-3.5.x.jar、mybatis-spring-2.x.x.jar版本号要匹配。5.2 现象页面报 500日志显示 Access denied for user rootlocalhost原因jdbc.properties里的用户名或密码不对或者 MySQL 用户没有远程/本地访问权限。解决先用命令行验证账号密码mysql -u root -p能登录说明密码对。如果登录不了用ALTER USER rootlocalhost IDENTIFIED BY 新密码;重置。如果密码对但项目连不上检查jdbc.url里的主机名是localhost还是127.0.0.1有些环境里localhost会走 socket 连接而不是 TCP。5.3 现象中文乱码校友姓名显示成问号原因数据库字符集、JDBC URL 字符集、JSP 页面编码三者不一致。解决三步统一。数据库层面ALTER DATABASE alumni_db CHARACTER SET utf8mb4;。JDBC URL 加characterEncodingutf-8。JSP 页面顶部加% page contentTypetext/html;charsetUTF-8 languagejava %。Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。5.4 现象MyBatis 报 Invalid bound statement (not found)原因Mapper XML 文件没有被扫描到或者 XML 里的namespace和接口全限定名不一致。解决检查applicationContext.xml里mapperLocations配置的路径是否匹配实际文件位置常见配置是classpath:mapper/*.xml。再检查 XML 的namespace是否等于 Mapper 接口的全限定名比如com.alumni.mapper.AlumniMapper。如果用的是 MavenXML 文件要放在src/main/resources下放在src/main/java下默认不会被打包。5.5 现象修改代码后重启 Tomcat 不生效原因Tomcat 缓存了旧的编译产物或者 IDE 没有自动重新编译。解决删除 Tomcat 的work目录和webapps/AlumniSystem目录重新部署 war 包。在 IDEA 里Build → Rebuild Project然后重新 Run。如果用的是 EclipseProject → Clean然后重新发布。6. 从跑通到改好给校友管理系统加一个毕业年份统计图表的技巧跑通源码只是第一步真正让这个项目变成自己的东西是能按需求改功能。这里拿「毕业年份分布统计」举例讲一个具体技巧用 Java 后端聚合数据前端用 ECharts 渲染柱状图。先在 Mapper 里加一个统计查询select idcountByGraduationYear resultTypemap SELECT graduation_year AS year, COUNT(*) AS count FROM alumni_info GROUP BY graduation_year ORDER BY graduation_year ASC /selectresultTypemap让 MyBatis 把每行结果封装成MapString, Objectkey 是字段名value 是值。Service 层直接返回ListMapString, ObjectOverride public ListMapString, Object countByGraduationYear() { return alumniMapper.countByGraduationYear(); }Controller 层RequestMapping(/stats/year) ResponseBody public MapString, Object statsByYear() { MapString, Object result new HashMap(); result.put(code, 200); result.put(data, alumniService.countByGraduationYear()); return result; }前端 JSP 页面引入 ECharts发 AJAX 请求拿数据$.get(/AlumniSystem/alumni/stats/year, function(res) { var years res.data.map(function(item) { return item.year; }); var counts res.data.map(function(item) { return item.count; }); var chart echarts.init(document.getElementById(yearChart)); chart.setOption({ title: { text: 校友毕业年份分布 }, tooltip: { trigger: axis }, xAxis: { type: category, data: years }, yAxis: { type: value }, series: [{ type: bar, data: counts, itemStyle: { color: #5470c6 } }] }); });这段代码的关键点后端只负责返回原始统计数据不做任何图表格式处理前端用map把数据拆成两个数组分别对应 X 轴和 Y 轴。这样后端接口是通用的以后换图表库也不用改后端。参数说明GROUP BY graduation_year按年份分组COUNT(*)统计每组的记录数ORDER BY graduation_year ASC让年份从小到大排列。如果graduation_year是varchar类型ORDER BY会按字符串排序需要在 SQL 里加CAST(graduation_year AS UNSIGNED)。我自己的习惯是每改一个功能先在数据库里用 SQL 验证结果对不对再写 Java 代码。SQL 跑出来的数据不对Java 代码写得再漂亮也没用。这个项目我前后跑过不下十遍每次换环境都会遇到新的版本兼容问题但核心链路始终是「数据库连上 → Mapper 扫描到 → Service 事务生效 → Controller 返回 JSON」。把这四步拆开排查没有跑不起来的 Java Web 项目。希望帮到你。本文还有配套的精品资源点击获取