尧图网页设计 
简介这份校园管理系统源码包是一套面向高校教务场景的完整Java项目适合毕业设计参考及小程序、安卓开发学习者拆解实践。无论是用于课程设计、毕业答辩还是想从零上手Java Web与微信小程序混合开发都能提供完整参考。系统覆盖学生信息管理、课程安排、成绩记录、教师信息与考勤管理等模块后端由Java编写并通过微信小程序及安卓端提供访问入口整体技术栈清晰。资源共219个文件压缩包14.66MB主要包含43个JSP页面、42个JAR依赖、36个XML配置、32个Java源文件与32个class编译文件等兼顾前后端与配置文件目录按功能模块分层便于检索学习另有分享说明txt便于部署参考。目前已有108人学习浏览适合希望从完整项目中理解Java后端设计、微信小程序接口对接及校园系统业务建模的开发者作为模板二次开发。1. 校园管理系统源码毕业设计季最需要的 Java 双端工程打开这份校园管理系统源码.zip之前我猜你和我当年一样毕设选题定了校园管理系统代码却还没着落。zip 里是一套 Java 后端工程从关键词方向看覆盖了小程序/安卓学生端管理端页面、数据库脚本、初始账号一次配齐。它解决的不是「跑通 demo」的问题而是给你一个能改、能答辩、能写进简历的真实工程骨架学生、教师、管理员三套角色选课、成绩、公告这些模块都有现成实现。适合两类人时间紧、想在现成骨架上换皮改业务的毕业生想搞懂一个管理系统从前端到数据库完整链路的 Java 学习者。2. 拆开 zip 看结构这份 Java 源码的分层与模块地图2.1 为什么毕业设计愿意选这套组合Java 后端 双端前端的选型逻辑先讲选型因为你要答辩得能回答「为什么用这套技术栈」。校园管理系统这种典型 CRUD 项目核心诉求是业务模型清晰学生、课程、成绩、公告、权限简单管理员/教师/学生三套角色、数据量不大但查询链路完整。Java 这边被验证过无数遍的组合是 Spring Boot 做后端MyBatis 管 SQLMySQL 存数据前端要么 Vue Element UI 出管理端要么微信小程序出学生端。关键词里同时出现 小程序源码、安卓开发、微信小程序说明这份资源在交付时就把「管理端 学生端」双端结构考虑进去了这对毕设是加分项——老师看到的不只是一个网页而是一套真正的前后端分离工程。我一般拿到源码先不看业务代码先看 pom.xml。里面如果同时出现 spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java 这三样后面所有步骤都能按同一套路走。选 Spring Boot 而不是老 SSM核心原因是配置收敛数据源、端口、MyBatis 映射全在 application.yml 一个文件里内嵌 Tomcat 省掉单独装容器的麻烦。毕设演示现场最怕多一个环境变量、多一个部署步骤——每多一步就多一次翻车机会。2.2 zip 解压后的目录地图从根目录到 SQL 脚本一层层看解压 zip 之前有个习惯问题先新建一个空目录再把 zip 解到里面。很多 zip 解出来会多一层嵌套比如校园管理系统源码/校园管理系统/路径带中文加空格部分老版本 Maven 插件和 Tomcat 碰到这种路径会出怪问题。解到干净目录后典型结构长这样campus-system/ ├── pom.xml # Maven 工程文件依赖和版本统一在这管 ├── sql/ │ └── campus.sql # 建库建表 初始数据第一步导这个 ├── src/main/java/com/campus/ │ ├── controller/ # 接收 HTTP 请求返回 Result 封装 │ ├── service/ # 业务逻辑事务注解基本在这层 │ ├── mapper/ # MyBatis 接口配 XML 或注解 SQL │ ├── entity/ # 和数据库表一一对应的实体类 │ └── config/ # 拦截器、跨域、WebMvc 配置 ├── src/main/resources/ │ ├── application.yml # 端口、数据源、MyBatis 配置全在这 │ └── mapper/ # StudentMapper.xml 这类 SQL 映射文件 └── src/main/webapp/ # 如果是 JSP 版本页面静态资源在这这个目录怎么读我一般建议按「entity → mapper → service → controller」的顺序看正好是一个请求从数据库到浏览器的完整链路entity 是表的镜像mapper 是 SQL 的容器service 管业务规则比如成绩超过 100 要拦截controller 只负责收参数和返回 JSON。这套分层不是给机器看的是给你答辩时讲「高内聚低耦合」用的。2.3 核心文件清单跑通前先确认这几样都在文件路径作用缺失后果sql/campus.sql建库建表、初始账号启动可以登录必挂src/main/resources/application.yml数据源、端口、MyBatis连不上库控制台直接报错pom.xml依赖版本管理Maven 依赖全部报红config/下的拦截器和跨域类登录态、前后端联调登录失效、前端调不通拿到 zip 先做一次完整性检查用 IDEA 打开后看左侧 project 面板里 resources 目录是否有 application.ymlsql 目录是否有 .sql 文件pom.xml 是否已经被识别为 Maven 工程右侧 Maven 面板能不能展开。这三样齐了才值得往下走。最后说个血泪经验zip 里最容易被忽略的是sql/目录。我见过太多人代码启动成功卡在登录折腾半天发现是没导 SQL——后端连的库是空的admin 账号根本没建。所以下一章的第一步永远是导数据不是点启动。3. 本地跑起来JDK、MySQL、Maven 三件套与启动参数3.1 建库导数据campus.sql 里藏着初始账号把 SQL 脚本当成这份源码的「后悔药」——导乱了数据跑一遍就回到初始状态。打开sql/campus.sql能看到建库建表、插入初始账号的完整语句节选如下CREATE DATABASE IF NOT EXISTS campus DEFAULT CHARSET utf8mb4; USE campus; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT 学号, name VARCHAR(50) NOT NULL COMMENT 姓名, class_name VARCHAR(50) COMMENT 班级, phone VARCHAR(20) COMMENT 手机号, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB COMMENT学生表; INSERT INTO user (username, password, role) VALUES (admin, a66abb5684c45962d887564f08346e8d, ADMIN);两个点必须注意。第一DEFAULT CHARSET utf8mb4不要改你本地如果是 MySQL 8字符集不对后面必出中文乱码。第二密码列存的是 MD5 摘要a66abb5684c45962d887564f08346e8d对应的明文是admin123但你不能直接在 SQL 里写明文——登录逻辑是拿输入值做 MD5 再比对存明文必登录失败。导库用命令行最直接一张表都不落mysql -uroot -p sql/campus.sql执行完别急着走先确认表建出来了mysql -uroot -p -e USE campus; SHOW TABLES;看到 student、course、score、user 这些表名说明数据落库了。如果你导 SQL 时报ERROR 1049 Unknown database说明脚本里没有 CREATE DATABASE 语句有些作者把建库语句单独放手动执行CREATE DATABASE campus DEFAULT CHARSET utf8mb4;再导一次即可。3.2 改 application.yml数据源是开工第一道闸项目要连你的本地 MySQLapplication.yml必须改四个参数url、username、password还有一个容易被漏的serverTimezone。常见配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.campus.entity参数逐个说useSSLfalse关掉 MySQL 8 默认的 SSL 握手不然启动报一堆证书警告serverTimezoneAsia/Shanghai解决时区差 8 小时的问题characterEncodingutf8配合建库的utf8mb4保证中文不乱码。jackson下的date-format决定接口返回的时间格式如果你看到日期变成时间戳多半是这里没配。driver-class-name这行我建议你别动MySQL 5 用com.mysql.jdbc.DriverMySQL 8 用com.mysql.cj.jdbc.Driver差一个cj写错直接ClassNotFoundException。你本地装哪个版本就用哪个版本的驱动包名别照抄老教程。3.3 启动后端Maven 命令两条路确认 JDK 版本和 pom.xml 里配的一致命令行进到campus-system/根目录有 pom.xml 的那层然后# 开发调试用改完代码重启方便 mvn spring-boot:run # 我更推荐先打包再跑能提前暴露打包阶段的问题 mvn clean package -DskipTests java -jar target/campus-system-1.0.0.jar第一次跑mvn spring-boot:runMaven 下载依赖卡几分钟是常态不是死机。判断死活看最后一行出现Started CampusApplication in xx.xxx seconds就是起来了如果停在Downloading...不动去第 5 章换镜像源。另外先确认mvn -v能输出版本报mvn 不是内部命令说明没配环境变量把 Maven 的 bin 目录加进 PATH 就行IDEA 里跑则不需要命令行打开项目等 Maven 索引完点绿色启动按钮。后端起完后浏览器访问http://localhost:8080/。能看到登录页说明工程没问题。这时候分两种情况前端是独立 Vue 工程要另开终端npm install npm run dev前端打包好放在static/或webapp/下后端起完直接能访问不用折腾 Node。先确认登录页出来再继续别急着改业务。4. 改业务模块学生、成绩、公告的三处实战改动4.1 权限拦截器三套角色怎么生效先改权限因为答辩必问「你怎么控制不同角色看到不同菜单」。常见实现是 Spring MVC 的HandlerInterceptor登录后把用户对象塞进 session拦截器检查 session 里有没有人、角色对不对public class LoginInterceptor implements HandlerInterceptor { private static final ListString WHITELIST Arrays.asList( /login, /api/login, /css/**, /js/**, /error ); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); if (WHITELIST.contains(uri)) { return true; } Object user request.getSession().getAttribute(loginUser); if (user null) { response.setStatus(401); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } // 到这里说明已登录需要细分角色时取 user.getRole() 判断 return true; } }逻辑说明preHandle在请求进 Controller 之前执行返回false就短路前端拿到 401 统一跳登录页。白名单用静态列表维护新增免登录接口就往里加一行。参数说明response.setStatus(401)是为了配合前端 axios 拦截器统一处理——如果后端返回 200 但 body 里写code:401前端就得写两套错误分支很别扭。角色细分有两种常见做法。一是拦截器里再判断user.getRole()ADMIN 放行所有TEACHER 只放行成绩相关接口二是菜单接口按角色返回不同列表前端只渲染有权限的菜单。毕设用方案一就够代码量小答辩也好讲。注意注册拦截器时用excludePathPatterns(/api/login)把登录接口放掉——「拦截器忘了放行登录接口」这个坑我至少见三个人踩过现象是后端起来了但登录接口一直 401。4.2 成绩统计从 SQL 到接口的一整条链路成绩统计是答辩高频功能把它从数据库到前端拉通你就能举一反三改任何查询类功能。先看 mapper 里的聚合 SQLselect idcourseAvgScore resultTypemap SELECT c.course_name, ROUND(AVG(s.score), 1) AS avg_score, COUNT(*) AS total FROM score s JOIN course c ON s.course_id c.id GROUP BY c.course_name ORDER BY avg_score DESC /selectresultTypemap是因为返回的是聚合结果不是单表实体用 Map 接收最省事。ROUND(AVG(s.score), 1)保留一位小数漏了 ROUND前端会显示一长串小数答辩时被老师盯着看很尴尬。Service 层就是一个方法调用Controller 层暴露成接口RestController RequestMapping(/api/score) public class ScoreController { Autowired private ScoreMapper scoreMapper; GetMapping(/course-avg) public Result courseAvg() { return Result.ok(scoreMapper.courseAvgScore()); } }前端用 axios 拉这个接口渲染成表格或柱状图axios.get(/api/score/course-avg).then(res { const rows res.data.data; // Result 的 data 字段 rows.forEach(r console.log(r.course_name, r.avg_score)); });这条链路的要点实体类能搞定就用实体类搞不定就写聚合 SQL 返回 Map不要强行造实体接聚合结果。我见过有人在 entity 里写avgScore字段去映射聚合列Mapper 折腾半天对不上纯属给自己加戏。4.3 新增公告模块照学生管理模板抄想加「公告管理」最快路径不是从零写是找现成的单表 CRUD 模板抄。学生管理模块就是最好的模板entity 一张表、mapper 一个接口加 XML、service 一个类、controller 四个增删改查方法。公告表建出来CREATE TABLE notice ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 标题, content TEXT COMMENT 正文, publisher VARCHAR(50) COMMENT 发布人, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSET utf8mb4;然后复制 StudentController 改成 NoticeController路由前缀从/api/student换成/api/noticeService、Mapper 同级复制改名。如果源码用的是 MyBatis Plus更省事——Service 继承ServiceImplNoticeMapper, Notice就有现成的 save、removeById、page 方法XML 都不用写。抄模板最容易翻车的是字段名不一致。学生表有student_no公告表没有你复制 SQL 时忘了换字段MyBatis 会报Invalid bound statement或者查出来全是 null。动手前花两分钟把 entity 字段和表字段对一遍比启动后调试半小时划算。5. 常见问题与避坑连不上库、端口冲突、乱码的五个现场5.1 数据库连接失败时区、SSL 与密码被拒现象启动日志报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized紧跟着一堆 SSL 证书警告最后连接失败另一种是直接报Access denied for user rootlocalhost (using password: YES)。原因第一条是 MySQL 8 的驱动要求 URL 里显式写时区而源码作者交付时用的是他自己机器的配置没带serverTimezoneSSL 警告是因为 MySQL 8 默认开了 SSL证书对不上就握手失败。第二条纯粹是application.yml里的密码和你本地 root 密码不一致源码作者留在文件里的通常是他自己的密码。解决在application.yml的 url 末尾补全参数url: jdbc:mysql://localhost:3306/campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai注意不能写成有人从网页复制配置把 HTML 转义符一起带进 yml解析直接失败。密码被拒就把password改成你自己的毕设阶段用 root 最省事安全加固是答辩之后的事。5.2 端口被占用8080 起不来现象启动日志报Port 8080 was already in use浏览器访问localhost:8080出来的是别人的页面。原因8080 是 Java Web 项目默认端口机器上可能已经跑了另一个 Tomcat、Nacos 或别的毕设项目。解决先看谁占的# Windows netstat -ano | findstr 8080 # Linux/macOS lsof -i :8080确认是残留进程就杀掉不想杀就把server.port改成 8081然后全局搜索前端代码里写死的8080同步替换。我的习惯是一项目一端口本地同时跑三四个毕设项目也不会打架。5.3 中文乱码三层排查法现象页面查询出来的中文全是???新增一条中文数据存进库里也是乱码。原因乱码可能是三层里任何一层的问题数据库连接 URL 没带characterEncodingutf8表结构字符集不是 utf8/utf8mb4MySQL 服务端character_set_server是 latin1。解决按「先看表、再看连接、最后看服务端」排查SHOW TABLE STATUS LIKE student; SHOW VARIABLES LIKE character_set%;表不是 utf8mb4 就执行ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4;。连接 URL 已带 utf8 还乱基本就是服务端默认字符集问题把 my.cnf 里character_set_serverutf8mb4加上重启 MySQL。这三个地方按顺序查半小时内必定位。5.4 初始账号登录失败明文密码与 MD5 比对现象用脚本里预置的admin / admin123登录提示密码错误或者自己往 user 表插了记录登录依然失败。原因登录代码是把输入值 MD5 之后再去查库比对而你手动插入的密码是明文比对必然失败。另一种情况是密码字段长度不够MD5 摘要是 32 位字段VARCHAR(32)刚好但如果表结构用了VARCHAR(20)MD5 串被截断存进去就是错的。解决找到源码里的 MD5 工具类算出一串新摘要再 UPDATEUPDATE user SET password新的32位MD5串 WHERE usernameadmin;改完之后清一下浏览器缓存和 session重新登录。别直接 UPDATE 成明文那是埋雷不是排雷。5.5 Maven 依赖下载卡死镜像与版本现象mvn spring-boot:run长时间停在Downloading...IDEA 里依赖全部标红。原因Maven 默认中央仓库在国外国内网络下载慢或者~/.m2/settings.xml里配的镜像地址当前网络访问不了。解决换阿里云镜像改~/.m2/settings.xmlmirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror改完在 IDEA 里刷新 Maven 项目。还有一个隐蔽坑pom.xml 锁了某个依赖版本但该版本已从中央仓库移除这种只能升降级把2.7.x这类通配版本改成2.7.18这种具体补丁版本比用RELEASE通配符稳得多。6. 收尾部署打成 jar 上线把后端接口复用到微信小程序毕设答辩前几天老师大概率会让在他自己电脑上跑一遍或者你现场演示。我的习惯是提前把项目打成 jar 包用命令启动不依赖 IDEA——换任何一台装了 JDK 和 MySQL 的机器都能跑现场不用等 IDE 索引。mvn clean package -DskipTests nohup java -jar target/campus-system-1.0.0.jar app.log 21 启动后访问http://localhost:8080/用初始账号逐项点一遍学生、课程、成绩、公告把功能截图存下来这就是答辩素材。关键词里有 微信小程序和安卓开发如果你的资源里没有现成的小程序端或者你想把后端接口复用到小程序核心就一件事把 session 登录改成 token 登录。后端登录成功后返回一个随机 token小程序每次请求在 header 里带Authorization: token值拦截器校验 token 而不是查 session。接口本身不用动前端换一层壳子wx.request({ url: http://localhost:8080/api/score/course-avg, header: { Authorization: wx.getStorageSync(token) }, success (res) { console.log(res.data) // 和后端返回的 JSON 完全一致 } })安卓端同理baseURL 指到后端地址OkHttp 或 Retrofit 在拦截器里加同样的 header 就行。要注意的是小程序真机调试时localhost指向手机自己要改成电脑的局域网 IP这是小程序联调最常见的坑。从那以后我每次拿到一份毕业设计源码都强制自己先走一遍「导 SQL → 改 yml → 起后端 → 测登录 → 点核心模块」的流程再碰业务代码。这个顺序帮我避开了至少十次「跑不起来」的尴尬。这份校园管理系统源码里该踩的坑我基本替你踩过了照第 5 章排查半小时内把工程跑起来问题不大希望帮到你。本文还有配套的精品资源点击获取 校园管理系统Java源码：Spring Boot双端工程搭建与实战
简介这份校园管理系统源码包是一套面向高校教务场景的完整Java项目适合毕业设计参考及小程序、安卓开发学习者拆解实践。无论是用于课程设计、毕业答辩还是想从零上手Java Web与微信小程序混合开发都能提供完整参考。系统覆盖学生信息管理、课程安排、成绩记录、教师信息与考勤管理等模块后端由Java编写并通过微信小程序及安卓端提供访问入口整体技术栈清晰。资源共219个文件压缩包14.66MB主要包含43个JSP页面、42个JAR依赖、36个XML配置、32个Java源文件与32个class编译文件等兼顾前后端与配置文件目录按功能模块分层便于检索学习另有分享说明txt便于部署参考。目前已有108人学习浏览适合希望从完整项目中理解Java后端设计、微信小程序接口对接及校园系统业务建模的开发者作为模板二次开发。1. 校园管理系统源码毕业设计季最需要的 Java 双端工程打开这份校园管理系统源码.zip之前我猜你和我当年一样毕设选题定了校园管理系统代码却还没着落。zip 里是一套 Java 后端工程从关键词方向看覆盖了小程序/安卓学生端管理端页面、数据库脚本、初始账号一次配齐。它解决的不是「跑通 demo」的问题而是给你一个能改、能答辩、能写进简历的真实工程骨架学生、教师、管理员三套角色选课、成绩、公告这些模块都有现成实现。适合两类人时间紧、想在现成骨架上换皮改业务的毕业生想搞懂一个管理系统从前端到数据库完整链路的 Java 学习者。2. 拆开 zip 看结构这份 Java 源码的分层与模块地图2.1 为什么毕业设计愿意选这套组合Java 后端 双端前端的选型逻辑先讲选型因为你要答辩得能回答「为什么用这套技术栈」。校园管理系统这种典型 CRUD 项目核心诉求是业务模型清晰学生、课程、成绩、公告、权限简单管理员/教师/学生三套角色、数据量不大但查询链路完整。Java 这边被验证过无数遍的组合是 Spring Boot 做后端MyBatis 管 SQLMySQL 存数据前端要么 Vue Element UI 出管理端要么微信小程序出学生端。关键词里同时出现 小程序源码、安卓开发、微信小程序说明这份资源在交付时就把「管理端 学生端」双端结构考虑进去了这对毕设是加分项——老师看到的不只是一个网页而是一套真正的前后端分离工程。我一般拿到源码先不看业务代码先看 pom.xml。里面如果同时出现 spring-boot-starter-web、mybatis-spring-boot-starter、mysql-connector-java 这三样后面所有步骤都能按同一套路走。选 Spring Boot 而不是老 SSM核心原因是配置收敛数据源、端口、MyBatis 映射全在 application.yml 一个文件里内嵌 Tomcat 省掉单独装容器的麻烦。毕设演示现场最怕多一个环境变量、多一个部署步骤——每多一步就多一次翻车机会。2.2 zip 解压后的目录地图从根目录到 SQL 脚本一层层看解压 zip 之前有个习惯问题先新建一个空目录再把 zip 解到里面。很多 zip 解出来会多一层嵌套比如校园管理系统源码/校园管理系统/路径带中文加空格部分老版本 Maven 插件和 Tomcat 碰到这种路径会出怪问题。解到干净目录后典型结构长这样campus-system/ ├── pom.xml # Maven 工程文件依赖和版本统一在这管 ├── sql/ │ └── campus.sql # 建库建表 初始数据第一步导这个 ├── src/main/java/com/campus/ │ ├── controller/ # 接收 HTTP 请求返回 Result 封装 │ ├── service/ # 业务逻辑事务注解基本在这层 │ ├── mapper/ # MyBatis 接口配 XML 或注解 SQL │ ├── entity/ # 和数据库表一一对应的实体类 │ └── config/ # 拦截器、跨域、WebMvc 配置 ├── src/main/resources/ │ ├── application.yml # 端口、数据源、MyBatis 配置全在这 │ └── mapper/ # StudentMapper.xml 这类 SQL 映射文件 └── src/main/webapp/ # 如果是 JSP 版本页面静态资源在这这个目录怎么读我一般建议按「entity → mapper → service → controller」的顺序看正好是一个请求从数据库到浏览器的完整链路entity 是表的镜像mapper 是 SQL 的容器service 管业务规则比如成绩超过 100 要拦截controller 只负责收参数和返回 JSON。这套分层不是给机器看的是给你答辩时讲「高内聚低耦合」用的。2.3 核心文件清单跑通前先确认这几样都在文件路径作用缺失后果sql/campus.sql建库建表、初始账号启动可以登录必挂src/main/resources/application.yml数据源、端口、MyBatis连不上库控制台直接报错pom.xml依赖版本管理Maven 依赖全部报红config/下的拦截器和跨域类登录态、前后端联调登录失效、前端调不通拿到 zip 先做一次完整性检查用 IDEA 打开后看左侧 project 面板里 resources 目录是否有 application.ymlsql 目录是否有 .sql 文件pom.xml 是否已经被识别为 Maven 工程右侧 Maven 面板能不能展开。这三样齐了才值得往下走。最后说个血泪经验zip 里最容易被忽略的是sql/目录。我见过太多人代码启动成功卡在登录折腾半天发现是没导 SQL——后端连的库是空的admin 账号根本没建。所以下一章的第一步永远是导数据不是点启动。3. 本地跑起来JDK、MySQL、Maven 三件套与启动参数3.1 建库导数据campus.sql 里藏着初始账号把 SQL 脚本当成这份源码的「后悔药」——导乱了数据跑一遍就回到初始状态。打开sql/campus.sql能看到建库建表、插入初始账号的完整语句节选如下CREATE DATABASE IF NOT EXISTS campus DEFAULT CHARSET utf8mb4; USE campus; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE COMMENT 学号, name VARCHAR(50) NOT NULL COMMENT 姓名, class_name VARCHAR(50) COMMENT 班级, phone VARCHAR(20) COMMENT 手机号, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB COMMENT学生表; INSERT INTO user (username, password, role) VALUES (admin, a66abb5684c45962d887564f08346e8d, ADMIN);两个点必须注意。第一DEFAULT CHARSET utf8mb4不要改你本地如果是 MySQL 8字符集不对后面必出中文乱码。第二密码列存的是 MD5 摘要a66abb5684c45962d887564f08346e8d对应的明文是admin123但你不能直接在 SQL 里写明文——登录逻辑是拿输入值做 MD5 再比对存明文必登录失败。导库用命令行最直接一张表都不落mysql -uroot -p sql/campus.sql执行完别急着走先确认表建出来了mysql -uroot -p -e USE campus; SHOW TABLES;看到 student、course、score、user 这些表名说明数据落库了。如果你导 SQL 时报ERROR 1049 Unknown database说明脚本里没有 CREATE DATABASE 语句有些作者把建库语句单独放手动执行CREATE DATABASE campus DEFAULT CHARSET utf8mb4;再导一次即可。3.2 改 application.yml数据源是开工第一道闸项目要连你的本地 MySQLapplication.yml必须改四个参数url、username、password还有一个容易被漏的serverTimezone。常见配置server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.campus.entity参数逐个说useSSLfalse关掉 MySQL 8 默认的 SSL 握手不然启动报一堆证书警告serverTimezoneAsia/Shanghai解决时区差 8 小时的问题characterEncodingutf8配合建库的utf8mb4保证中文不乱码。jackson下的date-format决定接口返回的时间格式如果你看到日期变成时间戳多半是这里没配。driver-class-name这行我建议你别动MySQL 5 用com.mysql.jdbc.DriverMySQL 8 用com.mysql.cj.jdbc.Driver差一个cj写错直接ClassNotFoundException。你本地装哪个版本就用哪个版本的驱动包名别照抄老教程。3.3 启动后端Maven 命令两条路确认 JDK 版本和 pom.xml 里配的一致命令行进到campus-system/根目录有 pom.xml 的那层然后# 开发调试用改完代码重启方便 mvn spring-boot:run # 我更推荐先打包再跑能提前暴露打包阶段的问题 mvn clean package -DskipTests java -jar target/campus-system-1.0.0.jar第一次跑mvn spring-boot:runMaven 下载依赖卡几分钟是常态不是死机。判断死活看最后一行出现Started CampusApplication in xx.xxx seconds就是起来了如果停在Downloading...不动去第 5 章换镜像源。另外先确认mvn -v能输出版本报mvn 不是内部命令说明没配环境变量把 Maven 的 bin 目录加进 PATH 就行IDEA 里跑则不需要命令行打开项目等 Maven 索引完点绿色启动按钮。后端起完后浏览器访问http://localhost:8080/。能看到登录页说明工程没问题。这时候分两种情况前端是独立 Vue 工程要另开终端npm install npm run dev前端打包好放在static/或webapp/下后端起完直接能访问不用折腾 Node。先确认登录页出来再继续别急着改业务。4. 改业务模块学生、成绩、公告的三处实战改动4.1 权限拦截器三套角色怎么生效先改权限因为答辩必问「你怎么控制不同角色看到不同菜单」。常见实现是 Spring MVC 的HandlerInterceptor登录后把用户对象塞进 session拦截器检查 session 里有没有人、角色对不对public class LoginInterceptor implements HandlerInterceptor { private static final ListString WHITELIST Arrays.asList( /login, /api/login, /css/**, /js/**, /error ); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri request.getRequestURI(); if (WHITELIST.contains(uri)) { return true; } Object user request.getSession().getAttribute(loginUser); if (user null) { response.setStatus(401); response.getWriter().write({\code\:401,\msg\:\未登录\}); return false; } // 到这里说明已登录需要细分角色时取 user.getRole() 判断 return true; } }逻辑说明preHandle在请求进 Controller 之前执行返回false就短路前端拿到 401 统一跳登录页。白名单用静态列表维护新增免登录接口就往里加一行。参数说明response.setStatus(401)是为了配合前端 axios 拦截器统一处理——如果后端返回 200 但 body 里写code:401前端就得写两套错误分支很别扭。角色细分有两种常见做法。一是拦截器里再判断user.getRole()ADMIN 放行所有TEACHER 只放行成绩相关接口二是菜单接口按角色返回不同列表前端只渲染有权限的菜单。毕设用方案一就够代码量小答辩也好讲。注意注册拦截器时用excludePathPatterns(/api/login)把登录接口放掉——「拦截器忘了放行登录接口」这个坑我至少见三个人踩过现象是后端起来了但登录接口一直 401。4.2 成绩统计从 SQL 到接口的一整条链路成绩统计是答辩高频功能把它从数据库到前端拉通你就能举一反三改任何查询类功能。先看 mapper 里的聚合 SQLselect idcourseAvgScore resultTypemap SELECT c.course_name, ROUND(AVG(s.score), 1) AS avg_score, COUNT(*) AS total FROM score s JOIN course c ON s.course_id c.id GROUP BY c.course_name ORDER BY avg_score DESC /selectresultTypemap是因为返回的是聚合结果不是单表实体用 Map 接收最省事。ROUND(AVG(s.score), 1)保留一位小数漏了 ROUND前端会显示一长串小数答辩时被老师盯着看很尴尬。Service 层就是一个方法调用Controller 层暴露成接口RestController RequestMapping(/api/score) public class ScoreController { Autowired private ScoreMapper scoreMapper; GetMapping(/course-avg) public Result courseAvg() { return Result.ok(scoreMapper.courseAvgScore()); } }前端用 axios 拉这个接口渲染成表格或柱状图axios.get(/api/score/course-avg).then(res { const rows res.data.data; // Result 的 data 字段 rows.forEach(r console.log(r.course_name, r.avg_score)); });这条链路的要点实体类能搞定就用实体类搞不定就写聚合 SQL 返回 Map不要强行造实体接聚合结果。我见过有人在 entity 里写avgScore字段去映射聚合列Mapper 折腾半天对不上纯属给自己加戏。4.3 新增公告模块照学生管理模板抄想加「公告管理」最快路径不是从零写是找现成的单表 CRUD 模板抄。学生管理模块就是最好的模板entity 一张表、mapper 一个接口加 XML、service 一个类、controller 四个增删改查方法。公告表建出来CREATE TABLE notice ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 标题, content TEXT COMMENT 正文, publisher VARCHAR(50) COMMENT 发布人, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSET utf8mb4;然后复制 StudentController 改成 NoticeController路由前缀从/api/student换成/api/noticeService、Mapper 同级复制改名。如果源码用的是 MyBatis Plus更省事——Service 继承ServiceImplNoticeMapper, Notice就有现成的 save、removeById、page 方法XML 都不用写。抄模板最容易翻车的是字段名不一致。学生表有student_no公告表没有你复制 SQL 时忘了换字段MyBatis 会报Invalid bound statement或者查出来全是 null。动手前花两分钟把 entity 字段和表字段对一遍比启动后调试半小时划算。5. 常见问题与避坑连不上库、端口冲突、乱码的五个现场5.1 数据库连接失败时区、SSL 与密码被拒现象启动日志报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized紧跟着一堆 SSL 证书警告最后连接失败另一种是直接报Access denied for user rootlocalhost (using password: YES)。原因第一条是 MySQL 8 的驱动要求 URL 里显式写时区而源码作者交付时用的是他自己机器的配置没带serverTimezoneSSL 警告是因为 MySQL 8 默认开了 SSL证书对不上就握手失败。第二条纯粹是application.yml里的密码和你本地 root 密码不一致源码作者留在文件里的通常是他自己的密码。解决在application.yml的 url 末尾补全参数url: jdbc:mysql://localhost:3306/campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai注意不能写成有人从网页复制配置把 HTML 转义符一起带进 yml解析直接失败。密码被拒就把password改成你自己的毕设阶段用 root 最省事安全加固是答辩之后的事。5.2 端口被占用8080 起不来现象启动日志报Port 8080 was already in use浏览器访问localhost:8080出来的是别人的页面。原因8080 是 Java Web 项目默认端口机器上可能已经跑了另一个 Tomcat、Nacos 或别的毕设项目。解决先看谁占的# Windows netstat -ano | findstr 8080 # Linux/macOS lsof -i :8080确认是残留进程就杀掉不想杀就把server.port改成 8081然后全局搜索前端代码里写死的8080同步替换。我的习惯是一项目一端口本地同时跑三四个毕设项目也不会打架。5.3 中文乱码三层排查法现象页面查询出来的中文全是???新增一条中文数据存进库里也是乱码。原因乱码可能是三层里任何一层的问题数据库连接 URL 没带characterEncodingutf8表结构字符集不是 utf8/utf8mb4MySQL 服务端character_set_server是 latin1。解决按「先看表、再看连接、最后看服务端」排查SHOW TABLE STATUS LIKE student; SHOW VARIABLES LIKE character_set%;表不是 utf8mb4 就执行ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4;。连接 URL 已带 utf8 还乱基本就是服务端默认字符集问题把 my.cnf 里character_set_serverutf8mb4加上重启 MySQL。这三个地方按顺序查半小时内必定位。5.4 初始账号登录失败明文密码与 MD5 比对现象用脚本里预置的admin / admin123登录提示密码错误或者自己往 user 表插了记录登录依然失败。原因登录代码是把输入值 MD5 之后再去查库比对而你手动插入的密码是明文比对必然失败。另一种情况是密码字段长度不够MD5 摘要是 32 位字段VARCHAR(32)刚好但如果表结构用了VARCHAR(20)MD5 串被截断存进去就是错的。解决找到源码里的 MD5 工具类算出一串新摘要再 UPDATEUPDATE user SET password新的32位MD5串 WHERE usernameadmin;改完之后清一下浏览器缓存和 session重新登录。别直接 UPDATE 成明文那是埋雷不是排雷。5.5 Maven 依赖下载卡死镜像与版本现象mvn spring-boot:run长时间停在Downloading...IDEA 里依赖全部标红。原因Maven 默认中央仓库在国外国内网络下载慢或者~/.m2/settings.xml里配的镜像地址当前网络访问不了。解决换阿里云镜像改~/.m2/settings.xmlmirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror改完在 IDEA 里刷新 Maven 项目。还有一个隐蔽坑pom.xml 锁了某个依赖版本但该版本已从中央仓库移除这种只能升降级把2.7.x这类通配版本改成2.7.18这种具体补丁版本比用RELEASE通配符稳得多。6. 收尾部署打成 jar 上线把后端接口复用到微信小程序毕设答辩前几天老师大概率会让在他自己电脑上跑一遍或者你现场演示。我的习惯是提前把项目打成 jar 包用命令启动不依赖 IDEA——换任何一台装了 JDK 和 MySQL 的机器都能跑现场不用等 IDE 索引。mvn clean package -DskipTests nohup java -jar target/campus-system-1.0.0.jar app.log 21 启动后访问http://localhost:8080/用初始账号逐项点一遍学生、课程、成绩、公告把功能截图存下来这就是答辩素材。关键词里有 微信小程序和安卓开发如果你的资源里没有现成的小程序端或者你想把后端接口复用到小程序核心就一件事把 session 登录改成 token 登录。后端登录成功后返回一个随机 token小程序每次请求在 header 里带Authorization: token值拦截器校验 token 而不是查 session。接口本身不用动前端换一层壳子wx.request({ url: http://localhost:8080/api/score/course-avg, header: { Authorization: wx.getStorageSync(token) }, success (res) { console.log(res.data) // 和后端返回的 JSON 完全一致 } })安卓端同理baseURL 指到后端地址OkHttp 或 Retrofit 在拦截器里加同样的 header 就行。要注意的是小程序真机调试时localhost指向手机自己要改成电脑的局域网 IP这是小程序联调最常见的坑。从那以后我每次拿到一份毕业设计源码都强制自己先走一遍「导 SQL → 改 yml → 起后端 → 测登录 → 点核心模块」的流程再碰业务代码。这个顺序帮我避开了至少十次「跑不起来」的尴尬。这份校园管理系统源码里该踩的坑我基本替你踩过了照第 5 章排查半小时内把工程跑起来问题不大希望帮到你。本文还有配套的精品资源点击获取