智慧校园微信小程序毕设实战：Java后端+MySQL从搭建到答辩

简介：这份智慧校园管理系统毕业设计源码包，基于微信小程序+Java+MySQL实现，面向计算机相关专业毕业生或课程设计者，可快速理解前后端分离的校园管理平台开发思路。资源总计1759个文件，涵盖339个vue前端页面、224个java后端接口、184个json配置、85个wxml/wxss小程序页面及sql数据库脚本等，包体约41.01MB。系统功能覆盖用户认证、课程表查询、图书馆服务、校园活动、成绩查询等模块，后端提供完整API接口，前端小程序封装交互，并配套环境说明、数据库表设计、答辩PPT等文档，便于从0到1复现与扩展。已有114人学习下载，适合需要完整可运行毕设项目、参考小程序端与Java端联调机制的开发者。

1. 这套智慧校园毕设包是什么：拆开看它的技术选型与使用人群

又到毕设季，微信小程序毕业设计的需求几乎占了我这里咨询量的一半，其中「智慧校园管理系统」又是出现频率最高的那一类。java 后端 + 微信小程序 + MySQL，再加一份 LW（论文文档），这个组合几乎是国内计算机类毕设的标配形态。它解决的问题很直接：让一个只有 Java 基础、没独立做过完整系统的学生，在两个月内交付一个"前端能点、后端能查、数据库有数据、论文有截图"的闭环系统。

这套系统的典型场景是：学生通过小程序查课表、看通知、查成绩、提交请假；管理端在 Web 或小程序里维护学生信息、课程安排、公告发布。核心价值在于它覆盖了「登录鉴权、角色区分、CRUD、文件展示」这几块毕设答辩必问的内容。适合三种人：想快速跑通一个完整项目再改造成自己题目的学生，想拿现成架构补业务模块的 Java 初学者，以及需要一套可演示 demo 做课程设计的在校生。

2. 从 ZIP 到能跑：环境准备、目录解读与前后端启动的最小路径

拿到 zip 包之后最怕的是解压完对着几十个文件夹发呆。先别急着点启动，花十几分钟把项目的骨架看清楚，后面能省下一下午的排错时间。

2.1 先给项目定调：前后端分离的经典三层结构

这套系统虽然标题写的是「java + 小程序」，但大多数源码包内部是标准的前后端分离结构。你会在压缩包里看到至少四个东西：后端工程（Maven 结构）、小程序前端目录、数据库脚本（通常是 .sql 文件）、LW 文档。

simple-upms/ # 后端 Java 工程，Maven 结构 ├── src/main/java # Java 源码，按 controller/service/mapper 分层 ├── src/main/resources # 配置文件 application.yml、mapper xml └── pom.xml # Maven 依赖声明 ├── miniprogram/ # 微信小程序前端目录 │ ├── pages/ # 页面文件夹 │ ├── app.js # 小程序入口逻辑 │ ├── app.json # 页面注册与全局配置 │ └── utils/ # request 封装、工具函数 ├── sql/ # 数据库初始化脚本 └── LW/ # 论文文档，通常是 Word 或 PDF

后端分层是经典的 Controller → Service → Mapper 三层，Controller 接收小程序端的请求，Service 写业务逻辑，Mapper 用 MyBatis 操作 MySQL。前端小程序通过 wx.request 发起 HTTP 请求到这个后端接口，拿到 JSON 数据再渲染到页面上。

注意：每个源码包的目录命名不一样，有的后端叫 server，有的叫 back-end；小程序文件夹有的叫 miniprogram，有的叫 pages。不用背名字，找「有 pom.xml 的是后端，有 app.json 的是小程序前端」这个规律就够了。

2.2 环境准备：JDK、Maven、MySQL、微信开发者工具的版本搭配

这套技术栈最怕的不是代码难，而是版本不配套导致启动失败。我一般建议按下面这套组合装，踩坑最少：

有个容易被忽略的点是 Maven 的 settings.xml 镜像。国内网络直接拉中央仓库依赖会非常慢，甚至超时失败。建议先把仓库镜像配到阿里云：

<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

这段配置放在 Maven 安装目录下的 conf/settings.xml 里，或者用户目录下的 .m2/settings.xml 中。mirrorOf 写 central 表示只镜像中央仓库，不会影响其他私服配置。

如果拉依赖的时候你看到 pom.xml 里一堆红色波浪线，或者控制台报Cannot resolve symbol 'SpringBootApplication'，八成是依赖没下全。这时候不要反复点刷新，先确认镜像配置对不对，再在 IDEA 的 Maven 面板里执行 clean + install。

MySQL 安装完以后，记得把 root 密码设置成符合源码里配置的值。很多毕设源码的数据库密码直接写在 application.yml 里，最常见的是 root/123456，还有 root/root 的。你可以在后续自己改回安全密码，但第一次跑通建议先用源码默认值，减少变量。

2.3 启动前先看懂三块关键配置：数据库连接、小程序 AppID、接口地址

后端能否启动成功，百分之七十取决于 application.yml 里的数据库配置。通常长这样：

server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/smart_campus?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: "123456" mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: true

这里三个参数最关键。driver-class-name如果是 MySQL 8.0，必须用com.mysql.cj.jdbc.Driver，用老的com.mysql.jdbc.Driver会直接启动报错；url里的serverTimezone=Asia/Shanghai是 MySQL 8.0 的强制要求，不加会报时区异常；map-underscore-to-camel-case开了以后，数据库里的create_time字段能自动映射到 Java 的createTime，没开的话查询结果会一堆 null。

如果你在 zip 包里没找到 application.yml 而是 application.properties，也没关系，核心配置项就是那几行，写法换一下而已。

小程序端的配置要看两处。第一处是app.js里的全局变量，通常定义了baseUrl或apiBaseUrl：

// app.js App({ globalData: { // 开发环境下指向本机后端地址 baseUrl: 'http://localhost:8080' } })

第二处是project.config.json里的 appid。如果没有自己的小程序 AppID，可以先在微信公众平台注册一个测试号，或者用开发者工具里的「测试号」选项，只是部分 API（比如真机预览）会受限。

2.4 一键启动顺序与验证：后端启动成功日志、小程序编译通过

启动顺序有讲究。正确顺序是：先启动 MySQL 并导入数据库脚本，再启动 Java 后端，最后打开微信开发者工具。

数据库导入用命令行最直观：

mysql -u root -p123456 < sql/smart_campus.sql

导入成功后验证一下表是否完整：

SHOW TABLES;

常见表有t_user、t_student、t_course、t_notice这类前缀带 t_ 的表。如果 SHOW TABLES 出来是空的，说明导入失败，检查一下 sql 文件里有没有CREATE DATABASE语句，如果文件里只建表没建库，你得手动先建库再导入。

后端启动：在 IDEA 里找到启动类（类名通常叫Application或SmartCampusApplication，带@SpringBootApplication注解），右键 Run。看到Started Application in X.XX seconds就是成功了。

小程序端启动：打开微信开发者工具，导入 miniprogram 目录，AppID 填测试号，编译后如果首页能加载数据，说明前后端链路已经通了。

提示：如果小程序页面白屏且控制台报url not in domain list，是开发工具默认校验合法域名导致的，在「详情 → 本地设置」里勾掉「校验合法域名」即可，这是开发阶段的常规操作。

3. 后端实现拆解：用户表设计、鉴权逻辑与查询接口怎么写才经得起答辩

后端是答辩时被追问最密集的部分。把表结构、登录鉴权、查询逻辑这三块吃透，答辩基本就稳了。

3.1 数据表设计：核心表与字段（user / student / course / notice）

智慧校园的数据表设计通常围绕「角色」和「业务」两条线展开。角色线解决谁在用什么，业务线解决具体做什么。

角色线至少三张表：用户表t_user、学生表t_student、教师表t_teacher。用户表存登录凭证，学生表存学号、班级、专业等档案信息。这两张表通过user_id关联，而不是把学生所有字段塞进用户表，这是答辩时能说清楚的第一个设计亮点。

CREATE TABLE `t_user` ( `id` INT NOT NULL AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL COMMENT '登录账号', `password` VARCHAR(100) NOT NULL COMMENT 'MD5或BCrypt加密后的密码', `role` TINYINT NOT NULL DEFAULT 2 COMMENT '1管理员 2学生 3教师', `status` TINYINT NOT NULL DEFAULT 1 COMMENT '1启用 0禁用', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

password 字段千万不能存明文。常见做法是 MD5 后加盐，或直接用BCryptPasswordEncoder。答趴时如果被问「密码安全性怎么保证」，能说出至少两层加密方案就已经超过平均水平。

业务线围绕「校园日常生活」展开：课程表t_course、课表t_timetable、通知公告t_notice、失物招领t_lost_found。这套系统的业务不重，但覆盖面广，刚好覆盖了 CRUD 的每个操作类型。

3.2 登录与鉴权：token 怎么生成、拦截器怎么放行

毕设里最常被问到的就是「你怎么知道当前请求是谁发的」这个问题的答案是 token 或 session。现在毕设源码主流用 token，因为小程序不像浏览器那样天然支持 Cookie，token 在请求头里带，前后端分离更自然。

登录接口的核心逻辑很简单：查询用户是否存在 → 校验密码 → 生成 token → 返回用户信息和 token。

@PostMapping("/login") public Result login(@RequestBody LoginRequest req) { // 1. 根据用户名查用户 User user = userMapper.selectByUsername(req.getUsername()); if (user == null) { return Result.error("用户不存在"); } // 2. 校验密码，MD5后比对 String md5Pwd = DigestUtils.md5DigestAsHex(req.getPassword().getBytes()); if (!user.getPassword().equals(md5Pwd)) { return Result.error("密码错误"); } // 3. 用户被禁用则拒绝登录 if (user.getStatus() == 0) { return Result.error("账号已被禁用"); } // 4. 生成token，UUID简单可靠，毕设阶段不需要引入JWT String token = UUID.randomUUID().toString().replace("-", ""); tokenMapper.save(token, user.getId()); // 5. 返回给前端 return Result.success(new LoginResponse(token, user)); }

这段代码里每步都值得在答辩时展开讲。第二步为什么要 MD5 而不是明文；第三步为什么要禁用状态字段；第四步为什么用 UUID 而不用 JWT——因为毕设项目没有分布式部署需求，UUID 存在库表里够用且实现简单，JWT 的优势在这种单应用场景体现不出来，说清楚这个权衡反而显得你懂取舍。

有了 token 之后需要一个拦截器，拦截所有需要登录的接口。逻辑是：从请求头里拿 token，查到一个有效 token 就放行，查不到就返回 401。

public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token = request.getHeader("token"); if (token == null || token.isEmpty()) { response.setStatus(401); return false; } Integer userId = tokenMapper.getUserIdByToken(token); if (userId == null) { response.setStatus(401); return false; } // 把userId放到请求上下文里，后续Controller可以取 request.setAttribute("userId", userId); return true; } }

注意拦截器只是「拦」，还要在配置类里告诉 Spring「哪些接口要拦、哪些放行」。登录接口本身必须放行，否则就死循环了。

3.3 查询接口的答辩点：分页参数与 SQL 注入

毕设的管理端列表页，几乎全部要走分页查询。分页做得好不好，是区分「自己写过」和「背了套代码」的试金石。

小程序端请求列表接口时最常见的参数设计是pageNum和pageSize，后端返回一个带total的对象，这样前端才能渲染分页组件。

@GetMapping("/notice/list") public Result listNotices(@RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, @RequestParam(required = false) String title) { // PageHelper做分页，底层是拦截器自动拼接LIMIT PageHelper.startPage(pageNum, pageSize); // title参数支持模糊查询，使用CONCAT避免拼接SQL List<Notice> list = noticeMapper.selectListByTitle(title); PageInfo<Notice> pageInfo = new PageInfo<>(list); return Result.success(pageInfo); }

对应的 Mapper XML 里，模糊查询的正确写法是：

<select id="selectListByTitle" resultType="com.example.entity.Notice"> SELECT * FROM t_notice <where> <if test="title != null and title != ''"> AND title LIKE CONCAT('%', #{title}, '%') </if> </where> ORDER BY create_time DESC </select>

用#{}而不是${}传参，能避免 SQL 注入。这里我用CONCAT('%', #{title}, '%')而不用'%#{title}%'，是因为后者在 MyBatis 里会被当作普通字符串，查不出结果。这是新手在 mapper 里最容易犯的错。

4. 小程序端对接：登录、列表渲染、请求封装与真机调试注意点

小程序端看似只是「套页面」，但坑都在细节里。跟我说的方法走，能把联调时间砍掉一半。

4.1 小程序的目录结构与工具函数

小程序前端的核心文件是app.js、app.json、app.wxss和pages目录下的页面文件。pages 下每个功能一个文件夹，比如pages/login/、pages/home/、pages/course/，每个文件夹里一对四件套：.js、.wxml、.wxss、.json。

先做一个统一请求封装，不然每个页面都写一遍wx.request，到后期想改接口地址会想死。常见的做法是在 utils 里写一个request.js：

// utils/request.js const BASE_URL = getApp().globalData.baseUrl function request(url, method = 'GET', data = {}) { return new Promise((resolve, reject) => { // 从缓存里拿token，登录后存进去 const token = wx.getStorageSync('token') wx.request({ url: `${BASE_URL}${url}`, method: method, data: data, header: { 'Content-Type': 'application/json', 'token': token }, success: (res) => { // 后端返回的code为200表示成功 if (res.data.code === 200) { resolve(res.data.data) } else if (res.statusCode === 401) { // token失效，跳转登录页 wx.removeStorageSync('token') wx.reLaunch({ url: '/pages/login/login' }) reject(new Error('未登录')) } else { reject(new Error(res.data.msg || '请求失败')) } }, fail: (err) => reject(err) }) }) } module.exports = { request }

这个封装做了三件很重要的事：统一带 token、统一处理 401、统一返回数据体。后续每个页面的请求都走这个函数，代码量能少三分之一。参数method默认 GET，data默认空对象，页面传参时不用每次写全。

4.2 从 wx.login 到拿到自己的 token：登录链路实现

小程序的登录和我们平时在网页里输入用户名密码不太一样。微信生态的常规流程是：前端调wx.login拿到一个临时code，把 code 发给后端，后端拿着 code 去微信的接口换 openid，再用 openid 查用户表拿到自己的 token。

但毕设项目里很多老板——啊不，很多指导老师——更喜欢看到账号密码登录，因为教学场景下管理学生账号更方便，以及论文里好写「账号密码登录 + 微信授权」的混合方案。所以小程序端的登录页，通常两种都做。

// pages/login/login.js const { request } = require('../../utils/request') Page({ data: { username: '', password: '' }, onInputUsername(e) { this.setData({ username: e.detail.value }) }, onInputPassword(e) { this.setData({ password: e.detail.value }) }, async onLogin() { const { username, password } = this.data if (!username || !password) { wx.showToast({ title: '请输入账号密码', icon: 'none' }) return } try { const res = await request('/login', 'POST', { username, password }) // 登录成功后存token、存用户信息 wx.setStorageSync('token', res.token) wx.setStorageSync('userInfo', res.userInfo) wx.switchTab({ url: '/pages/home/home' }) } catch (err) { wx.showToast({ title: err.message, icon: 'none' }) } } })

这段代码的重点在wx.setStorageSync，把 token 放在本地缓存里，后续所有请求从缓存读取。页面的onLogin用 async/await 替代回调地狱，出错时 toast 提示，交互上会自然很多。顺序是先跳转登录成功页再存 token，避免存了 token 但后续逻辑失败了。

4.3 首页通知列表：数据渲染与下拉刷新

首页最常见的形态是轮播图 + 通知公告列表 + 快捷入口入口。列表部分拿通知公告举例，数据从/notice/list接口来：

// pages/home/home.js const { request } = require('../../utils/request') Page({ data: { noticeList: [], pageNum: 1, pageSize: 10, hasMore: true }, onLoad() { this.loadNotices() }, async loadNotices() { if (!this.data.hasMore) return const res = await request('/notice/list', 'GET', { pageNum: this.data.pageNum, pageSize: this.data.pageSize }) const list = res.list || [] this.setData({ noticeList: this.data.noticeList.concat(list), pageNum: this.data.pageNum + 1, hasMore: list.length === this.data.pageSize }) }, onPullDownRefresh() { this.setData({ noticeList: [], pageNum: 1, hasMore: true }) this.loadNotices().then(() => wx.stopPullDownRefresh()) } })

这里有三个关键设计。hasMore字段控制是否还能继续翻页，避免加载到最后一页后还发请求；concat拼接而不是赋值，才能实现「加载更多」而不是「覆盖全部」；下拉刷新先把列表清空再重新加载，数据才不会变成重复的两份。

要在app.json里给页面开启enablePullDownRefresh: true，不然 onPullDownRefresh 不会触发，这个属性写在页面对应的 json 配置文件中。

4.4 真机调试与开发者工具的区别

开发者工具里一切正常，一上真机就白屏、报错、请求失败，这是毕设最常见的猫病。原因不外乎三个。

第一个是localhost问题。开发者工具里http://localhost:8080能通，但手机上的 localhost 是手机自己。联调时要改成电脑在局域网里的 IP 地址，比如http://192.168.1.101:8080，而且手机和电脑要连同一个 Wi-Fi。

第二个是合法域名校验。开发者工具里勾几「校验合法域名」就能绕过限制，但真机预览时，这个选项是无效的。想在真机上跑通 HTTP 请求，必须在小程序后台把域名加到 request 合法域名里，而且在线上环境必须用 HTTPS。抱佛脚的办法是开发时用「真机调试」功能，它会自动打开一个调试模式，能临时绕过域名校验。

第三个是后端防火墙。Windows 防火墙默认会挡掉对 8080 端口的访问，手机请求直接超时。建议开发阶段在后端配置里临时开放端口，或者用腾讯云/阿里云的学生机把后端部署上去，直接给手机一个公网地址。这也是答辩演示时最稳的方案。

5. 避坑清单：智慧校园项目里最常见的七个翻车现场

这部分是从实际调试中总结的血泪经验，每一条都对应一次真实的「系统跑不起来」或「答辩被问住」。按现象 → 原因 → 解决来写，方便你对照排查。

5.1 现象：后端启动时报Access denied for user 'root'@'localhost'

原因是 MySQL 的 root 密码和application.yml里的配置不一致，或者是 MySQL 8.0 默认用caching_sha2_password加密方式，而项目里的数据库驱动版本太老。

解决：如果密码不一致，用ALTER USER 'root'@'localhost' IDENTIFIED BY '123456';把密码改回来。如果是加密方式问题，在 MySQL 命令行执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';，然后刷新权限FLUSH PRIVILEGES;。我从不在 MySQL 密码上多折腾，第一次跑通毕设代码，直接用源码默认密码是最省时间的。

5.2 现象：小程序请求接口一直 pending，最后超时

原因是 baseUrl 写的是localhost或127.0.0.1，真机上无法访问；或者后端启动的端口和请求端口不一致（后端跑在 8081 而小程序请求 8080）。

解决：先在后端 Controller 里加一个测试接口@GetMapping("/ping")，在浏览器里访问http://localhost:8080/ping，确认后端通。然后用ipconfig（Windows）或ifconfig（Mac）查电脑的局域网 IP，替换小程序端的 baseUrl。后端端口要改的话，改完application.yml记得重启。

5.3 现象：数据库导入 SQL 后中文乱码

原因是 SQL 文件本身的字符集和数据库连接字符集不一致。

解决：建库语句加DEFAULT CHARSET=utf8mb4，导入的时候加上字符集参数：

mysql -u root -p123456 --default-character-set=utf8mb4 < sql/smart_campus.sql

如果还是乱码，回到表里查看已经导入的数据，如果数据本身乱了，就要用ALTER TABLE t_notice CONVERT TO CHARACTER SET utf8mb4;转一下，然后重新导入。这里要注意 utf8mb4 和 utf8 的区别，emoji 表情只有 utf8mb4 才能存。

5.4 现象：查询结果全是 null，但数据库里有数据

原因是 MyBatis 的驼峰映射没打开，create_time映射不到createTime属性上。

解决：在application.yml的 mybatis 配置里加map-underscore-to-camel-case: true。如果你不想改全局配置，可以在 Mapper XML 的查询语句里给每个字段起别名：SELECT create_time AS createTime FROM t_notice。两种方案，第二种更直接，但每个查询都要写；第一种改一行配置，全局生效。我推荐第一种，省事。

5.5 现象：登录成功后，点击功能又频繁跳回登录页

原因是 token 过期时间设置得太短，或者 token 存在服务端后，服务端重启导致缓存清空（如果存在内存里的话）。

解决：如果是 JWT 类型，看后端工具类里setExpiration的毫秒值，默认 7 天的配置改大一点儿。如果是把 token 存内存里，那后端每次重启 token 就失效，改成存数据库表，这样重启不丢。调试时频繁重启后端的话，可以把 token 相关校验逻辑先临时注释掉，等最后再打开。

5.6 现象：小程序端上传图片失败，报uploadFile:fail

原因是上传接口地址用的是和请求同源没问题，但wx.uploadFile的url不能复用普通 request 封装，需要单独配置。

wx.uploadFile({ url: `${BASE_URL}/upload`, filePath: filePath, name: 'file', header: { 'token': wx.getStorageSync('token') }, success(res) { const data = JSON.parse(res.data) console.log('上传成功', data) } })

注意name字段要和后端接收参数名对应。后端如果是@RequestParam("file") MultipartFile file，这里就必须写name: 'file'。

5.7 现象：LW 论文里的截图和实际代码对不上，答辩被指导老师指出来

原因是写论文的时候改了页面样式、换了表结构，论文截图却没有同步更新。

解决：论文的每张截图都重新截一遍，截完以后对照代码再检查。重点是数据库设计章节的表格要和t_user等表结构保持一致，页面截图要和当前小程序界面一致。所有图重截后，整体替换到论文里，别只改几处。

6. 答辩前的压轴改造：从「能跑」到「值得讲」

项目能跑通了，离高分还有一段距离。最后这几天，把时间花在三个改造上，性价比最高。

第一个改造是加一个「导出功能」。课程表导出成 Excel、学生名单导出成 CSV，代码量很小（用 EasyExcel 或 POI 都行），但是答辩演示时效果非常直观。指导老师看到你能「把数据从系统里带走」，对系统完整性的认知会上一个台阶。

第二个改造是加一个「统计图表」。哪怕只是课程数量按学院做个柱状图，或者通知发布数量按月份做个折线图，都能让答辩 PPT 的「系统亮点」页面有图可放。小程序端可以用原生 canvas 画，也可以用 eCharts 的小程序版本。

第三个改造是准备两个「预设演示数据」的故事。比如答辩时说失物招领模块，先演示发布一条失物信息，然后切账号演示「我来认领」，把流程走完整。这样讲比逐个点菜单要有说服力得多。

我自己的习惯是：答辩前一晚把项目从零启动三遍——第一次用命令行启动后端和小程序验证全流程，第二次重新导入数据库验证初始化脚本没问题，第三次把电脑合上再打开，模拟答辩现场环境。这个小习惯帮我躲过了至少两次环境问题，也欢迎你试试。

这套系统的上限不低，下限也不高，最终拿多少分，取决于你把每个环节讲透了多少。希望帮到你。

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