校园管理系统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 管 SQL，MySQL 存数据，前端要么 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 核心文件清单：跑通前先确认这几样都在

拿到 zip 先做一次完整性检查：用 IDEA 打开后，看左侧 project 面板里 resources 目录是否有 application.yml，sql 目录是否有 .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 ) ENGINE=InnoDB 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：数据源是开工第一道闸

项目要连你的本地 MySQL，application.yml必须改四个参数：url、username、password，还有一个容易被漏的serverTimezone。常见配置：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/campus?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.campus.entity

参数逐个说：useSSL=false关掉 MySQL 8 默认的 SSL 握手，不然启动报一堆证书警告；serverTimezone=Asia/Shanghai解决时区差 8 小时的问题；characterEncoding=utf8配合建库的utf8mb4，保证中文不乱码。jackson下的date-format决定接口返回的时间格式，如果你看到日期变成时间戳，多半是这里没配。

driver-class-name这行我建议你别动：MySQL 5 用com.mysql.jdbc.Driver，MySQL 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:run，Maven 下载依赖卡几分钟是常态，不是死机。判断死活看最后一行：出现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 List<String> 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 里的聚合 SQL：

<select id="courseAvgScore" resultType="map"> 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 </select>

resultType="map"是因为返回的是聚合结果，不是单表实体，用 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 ) ENGINE=InnoDB DEFAULT CHARSET utf8mb4;

然后复制 StudentController 改成 NoticeController，路由前缀从/api/student换成/api/notice，Service、Mapper 同级复制改名。如果源码用的是 MyBatis Plus，更省事——Service 继承ServiceImpl<NoticeMapper, 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 'root'@'localhost' (using password: YES)。

原因：第一条是 MySQL 8 的驱动要求 URL 里显式写时区，而源码作者交付时用的是他自己机器的配置，没带serverTimezone；SSL 警告是因为 MySQL 8 默认开了 SSL，证书对不上就握手失败。第二条纯粹是application.yml里的密码和你本地 root 密码不一致，源码作者留在文件里的通常是他自己的密码。

解决：在application.yml的 url 末尾补全参数：

url: jdbc:mysql://localhost:3306/campus?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/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 没带characterEncoding=utf8；表结构字符集不是 utf8/utf8mb4；MySQL 服务端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_server=utf8mb4加上重启 MySQL。这三个地方按顺序查，半小时内必定位。

5.4 初始账号登录失败：明文密码与 MD5 比对

现象：用脚本里预置的admin / admin123登录，提示密码错误；或者自己往 user 表插了记录，登录依然失败。

原因：登录代码是把输入值 MD5 之后再去查库比对，而你手动插入的密码是明文，比对必然失败。另一种情况是密码字段长度不够，MD5 摘要是 32 位，字段VARCHAR(32)刚好，但如果表结构用了VARCHAR(20)，MD5 串被截断，存进去就是错的。

解决：找到源码里的 MD5 工具类，算出一串新摘要再 UPDATE：

UPDATE user SET password='新的32位MD5串' WHERE username='admin';

改完之后清一下浏览器缓存和 session，重新登录。别直接 UPDATE 成明文，那是埋雷不是排雷。

5.5 Maven 依赖下载卡死：镜像与版本

现象：mvn spring-boot:run长时间停在Downloading...，IDEA 里依赖全部标红。

原因：Maven 默认中央仓库在国外，国内网络下载慢；或者~/.m2/settings.xml里配的镜像地址当前网络访问不了。

解决：换阿里云镜像，改~/.m2/settings.xml：

<mirror> <id>aliyun</id> <mirrorOf>central</mirrorOf> <url>https://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 2>&1 &

启动后访问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 章排查，半小时内把工程跑起来问题不大，希望帮到你。

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