简介这是一套面向高校毕业设计与课程设计的智慧校园管理系统完整源码包采用微信小程序作为前端、Java作为后端服务并搭配MySQL 5.7数据库。系统覆盖用户身份认证、课表查询、校园活动、成绩查询、校园卡管理等典型模块适合需要快速搭建校园信息化管理项目的学生直接参考与二次开发。压缩包共1759个文件含214个Java后端源码、339个vue前端页面、85个wxml/85个wxss小程序页面、200个js脚本及1份SQL数据库脚本另有docx/pptx答辩说明与md文档整体体积41.01MB目录按小程序端、后端与数据库分层便于定位。当前已有115人学习下载。资源内不仅提供可运行的前后端代码和建库脚本还附带环境配置说明、项目介绍文档及答辩演示PPT能帮助读者从部署调试到论文整理全流程完成毕业设计尤其适合Java Web与小程序开发的初学者借鉴。1. 智慧校园管理系统是个什么毕设一套源码解决“管理端 学生端”两条线拿到“智慧校园管理系统”这类毕设源码包时第一件事不是急着解压跑代码而是想清楚它到底在解决什么问题。这个题目年年有学生做覆盖的模块无非是校园公告、课表查询、教室报修、活动报名、个人信息维护这几类学生端用微信小程序完成查询和提交管理端用 Java 写后台接口数据统一落在 MySQL。真正让这套系统显得“完整”的地方在于它同时具备两个视角学生看到的是轻量的小程序界面管理员看到的是能处理数据增删改查的 Web 服务。对这个题感兴趣的人多半是正在选毕设题目的计算机相关专业学生或者已经拿到源码但不知道怎么在本地把环境跑起来的人。下面从技术栈、运行步骤、核心链路和常见坑四个角度展开把这条线走通。2. 为什么是 java 小程序 mysql一套毕设源码的选型逻辑2.1 三个角色各管什么边界在哪小程序端负责界面渲染和用户交互Java 后端负责业务规则与接口校验MySQL 负责数据持久化。三者分工明确的好处是每一层都可以独立替换。小程序页面不好看改前端就行不影响接口接口返回字段不对改 Java 就行不碰数据库数据库表结构设计不合理只要接口层做兼容前端也不感知。这个选型在毕业设计里尤其合适。微信小程序天然适配移动端使用场景演示时用微信扫码就能打开比装一个 Android 或 Web 应用更有“落地感”。Java 后端配合 Spring Boot 这类框架Controller、Service、Mapper 三层结构清晰答辩时能对着架构图讲清楚请求怎么走。MySQL 则是所有数据类项目的基础哪怕不懂复杂调优建表、写 SQL、讲清楚表关系就足够应付提问。需要注意的是这套组合的边界不是绝对的。有的源码会把业务逻辑写进 Controller有的会为了省事直接用 JdbcTemplate 而不是 MyBatis。拿到包之后先别在代码风格上纠结而是确认一条主链路能不能跑通。2.2 解压后先认目录小程序端、服务端、数据库脚本和 LW 文档怎么区分一个典型的智慧校园毕设 zip 解压之后目录结构大致如下不同学校对文档命名要求不同但核心构件不会有太大差别smart-campus/ ├── frontend/ # 微信小程序工程 │ ├── pages/ │ ├── utils/ │ ├── app.js │ └── app.json ├── backend/ # Java 后端工程Maven 项目 │ ├── src/main/java │ ├── src/main/resources │ └── pom.xml ├── database/ │ └── smart_campus.sql └── LW/ # 论文与答辩相关文档frontend 目录对应小程序工程用微信开发者工具打开时选这个目录而不是整个 zip 解压根目录。backend 是 Java 后端需用 IDEA 或 Eclipse 以 Maven 项目方式导入pom.xml 里声明了依赖版本。database 下的 sql 文件是建库建表脚本导入 MySQL 后才能让后端连上。LW 目录里一般是论文正文、任务书和开题报告。这里容易犯的第一个低级错误是把整个解压目录直接拖进微信开发者工具。开发者工具要求导入的目录必须包含 app.json如果你选的目录不对会直接提示“未找到 app.json”。同理Java 后端导入 IDEA 时要选到 pom.xml 所在的层级而不是把整个 backend 当成普通文件夹打开。提示如果遇到源码是 uni-app 写的frontend 目录里应该能看到 src 子目录和 manifest.json这种情况需要先运行 npm install 再在 HBuilderX 或开发者工具中编译导入。原生小程序和 uni-app 工程的结构不能混用。3. 三分跑通MySQL 建库、Java 后端启动、小程序联调3.1 先导数据库常见命令和字符集参数后端连不上数据库是启动失败的第一大原因所以顺序上先处理 MySQL。拿到 sql 脚本后第一步是建库再导入不要直接双击打开 sql 文件执行那样容易因为默认字符集不对导致中文乱码。推荐用命令行完成mysql -u root -p -e CREATE DATABASE IF NOT EXISTS smart_campus DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p smart_campus database/smart_campus.sql第一条命令先创建数据库并指定 utf8mb4 字符集第二条命令把表结构和初始数据导入。注意两条命令都用了 -p 参数命令行会提示输入密码。如果本机没装 MySQL先装好服务再执行装好的标志是mysql --version能输出版本信息。为什么强调 utf8mb4 而不是 utf8因为 utf8 在 MySQL 里最多支持 3 字节字符像生僻字或部分 emoji 符号如果小程序端允许用户输入昵称里有表情会写入失败。utf8mb4 是完全覆盖 utf8 的兼容性更好。如果 sql 文件本身已经带了 CREATE DATABASE 语句可以直接省略第一条但导入前还是要确认字符集。导入完成后用mysql -u root -p smart_campus -e SHOW TABLES;验证是否有表生成。能看到表列表就说明数据库部分完成。看不到任何表时检查 sql 文件里是否混入了 CREATE DATABASE 语句如果建库语句里的库名和后端配置的库名不一致后面同样连不上。3.2 后端启动要改的三个配置项和启动结果怎么看Java 后端大多数是 Spring Boot 工程配置文件放在 src/main/resources 下常见文件名是 application.yml 或 application.properties。启动前必须确认三项配置数据库地址、数据库账号密码、服务端口。如果源码里默认配置和你的本地环境不一致启动必然报错。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/smart_campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver端口默认 8080如果本机被其他程序占用改成 8081 或 9090 都行但后面小程序端请求地址也要同步换。数据库名 smart_campus 要和 3.1 中建的库完全一致。password 换成你自己 MySQL 的密码。url 参数里的 useSSLfalse 不是可有可无的MySQL 8.x 默认开启 SSL本地开发环境下驱动握手时经常因为证书校验失败抛异常显式关闭可以少踩一个坑。启动方式是在 IDEA 里找到带 main 方法的 Application 类右键运行。看到类似Tomcat started on port(s): 8080的日志就算成功。如果你没装 IDEA用命令行进到 backend 目录执行mvn spring-boot:run也行但前提是 Maven 已安装且配置过国内镜像源。这里常遇到的翻车现场是 Maven 依赖下载失败原因多半是初始 settings.xml 指向的中央仓库很慢换成阿里云镜像后基本能解决。3.3 小程序端联调关闭域名校验的一个开关和 wx.request 打通的标志后端起来了小程序要能调到接口。用微信开发者工具导入 frontend 目录以后最常见的现象是页面能打开但所有列表都是空的Console 里报request:fail或url not in domain list。这是因为微信小程序在生产环境要求请求地址必须是 HTTPS 且配置在后台的合法域名里但本地开发可以直接绕过这个限制。在开发者工具的右上角“详情 - 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。这是所有本地联调的开关不勾选的话请求 http://localhost:8080 一定会被拦。勾选之后小程序里发起请求的地址大致是这样写的// utils/api.js const BASE_URL http://localhost:8080 function request(path, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json }, success: res resolve(res.data), fail: err reject(err) }) }) } module.exports { request, BASE_URL }BASE_URL 有小程序前端和后端两个地方要对应。如果你后端端口改成了 8081这里也要改成 8081。如果你是把小程序放到真机上预览而不是在开发者工具里模拟BASE_URL 里的 localhost 需要换成电脑在局域网中的 IP例如 http://192.168.1.10:8080同时确保手机和电脑连同一个 WiFi。联调打通的标志很简单小程序页面上能看到数据库里的公告列表或个人信息而不是停留在空白或 loading 状态。打开开发者工具的 Network 面板能看到请求返回 200 且 response 里带 JSON 数据。注意真机调试时手机访问不到 localhost这是新手最容易反复折腾半小时的地方。提示如果后端接口地址是 HTTPS但证书是自签名的同样会在真机上被拦。本地联调阶段统一走 HTTP 关闭域名校验是最省事的方案等真正上线再考虑备案和域名配置。4. 看懂一条数据链路从 wx.request 到 MySQL 的完整读写4.1 小程序端最小请求写法wx.request 的参数和 loading 处理小程序端的逻辑集中在 page 里。一个常见的列表页页面加载时先显示 loading再请求后端接口数据回来后用 setData 更新渲染。以下是一段典型的公告列表请求写法// pages/notice/notice.js const api require(../../utils/api) Page({ data: { noticeList: [], loading: false }, onLoad() { this.fetchNotices() }, fetchNotices() { this.setData({ loading: true }) api.request(/api/notice/list, GET) .then(res { this.setData({ noticeList: res.data || [] }) }) .catch(err { console.error(公告列表加载失败, err) }) .finally(() { this.setData({ loading: false }) }) } })这里的关键点有两个。第一wx.request 是异步的不能用回调里的数据直接给外部变量赋值必须走 setData否则页面不会刷新。第二loading 状态需要手工维护接口慢的时候至少能让用户看到“正在加载”的反馈。页面模板里对应的渲染逻辑就是 wx:for 循环view wx:if{{loading}}加载中.../view view wx:for{{noticeList}} wx:keyid classnotice-item text{{item.title}}/text text{{item.publishTime}}/text /viewwx:key 建议用数据主键 id而不是 index。用了 index 的话列表做删除或排序操作时渲染容易错乱。4.2 后端三层链路Controller、Service、Mapper 各改哪一行后端接口需要配合前端路径来写。前端请求 /api/notice/list后端对应的 Controller 里必须有 GetMapping(/list) 且类上标了 RequestMapping(/api/notice)。三层结构里Controller 只负责接收参数和返回结果业务写在 Service 里数据库操作在 Mapper 里。以下是一个查询公告列表的最简实现// NoticeController.java RestController RequestMapping(/api/notice) public class NoticeController { Autowired private NoticeService noticeService; GetMapping(/list) public Result list() { return Result.success(noticeService.listNotices()); } }// NoticeService.java Service public class NoticeService { Autowired private NoticeMapper noticeMapper; public ListNotice listNotices() { return noticeMapper.selectList(null); } }// NoticeMapper.java Mapper public interface NoticeMapper extends BaseMapperNotice { }这里用了 MyBatis-Plus 的 BaseMapperselectList(null) 表示查询全部公告不需要手写 SQL。如果你的源码没有用 MyBatis-Plus而是原生 MyBatis那 Mapper 里会是 List selectAllNotice();对应的 XML 文件里有一条 select 语句。两种写法都能跑通改的时候别混。后端返回的统一结构 Result 也很重要。前端 res.data 拿到的其实是一整个 Result 对象里面可能包含 code、message 和 data 三个字段真正的数据在 data 里。前端代码里写 res.data 是取 data 字段但如果后端 Result 里把数据字段命名为 records 或者 rows这里就要对齐。最好通过 Network 面板直接看响应体结构再决定怎么写。4.3 分页与“加载更多”LIMIT 参数和小程序 onReachBottom 的配合智慧校园的公告、报修记录这类列表不会永远只有几条毕设做到分页是加分项。后端分页常见做法是用 MyBatis-Plus 的 Page 对象前端滚动到底部时再次请求下一页。前端 page 里需要维护一个页码变量// pages/notice/notice.js 追加部分 Page({ data: { pageNum: 1, pageSize: 10, hasMore: true }, onReachBottom() { if (!this.data.hasMore) return this.fetchNotices(this.data.pageNum 1) }, fetchNotices(pageNum) { api.request(/api/notice/page, GET, { pageNum, pageSize: this.data.pageSize }) .then(res { const records res.data.records || [] this.setData({ noticeList: this.data.noticeList.concat(records), pageNum: pageNum, hasMore: records.length this.data.pageSize }) }) } })后端 /api/notice/page 对应一个带分页参数的接口Mapper 层用 LIMIT #{offset}, #{pageSize} 实现。MySQL 分页的 offset 等于 (pageNum - 1) * pageSize这个换算容易写错通常在 Service 层用 Page 对象自动处理不需要手写。这个“加载更多”场景里最典型的 bug 是第二次请求回来后直接把新数据赋值给 noticeList而不是 concat。结果就是下拉到底部后列表没有变多只看到第一页数据在刷新。上面代码里的 concat 是关键动作演示的时候可以刻意让后端返回两页数据再把这段代码换回直接赋值对比给答辩老师看。5. 智慧校园源码导入与运行的 5 个常见坑现象、原因、解决5.1 Unknown database 和 Access denied检查建库语句和字符集现象启动后端时控制台报java.sql.SQLException: Unknown database smart_campus或者Access denied for user rootlocalhost。原因Unknown database 说明后端配置的库名和实际创建的库不一致或者 sql 文件根本没导入成功。Access denied 则通常是密码错误或账号权限不足。解决先执行 SHOW DATABASES 看库里是否存在。不存在就回到 3.1 重新建库。存在但连不上就确认配置文件中的 username 和 password 是不是 root 对应的密码。注意 MySQL 8.0 与 5.7 的默认认证插件不同如果你本机是 8.0 而源码依赖的驱动比较老可能抛Unable to load authentication plugin caching_sha2_password升级 mysql-connector-java 驱动版本即可。5.2 mysql ssl 连接错误MySQL 8 认证方式与驱动版本现象启动后端时抛异常日志里出现Communications link failure或SSL connection error。原因MySQL 8 系列默认启用 SSL 连接而本地数据库通常没有有效的服务端证书驱动握手失败。另一个常见诱因是驱动版本是 5.x连 MySQL 8 不受支持。解决在数据库连接 URL 后面追加useSSLfalseallowPublicKeyRetrievaltrue。前者关闭 SSL后者允许驱动在本地使用公钥检索方式完成认证。同时确认 pom.xml 里的 mysql-connector-java 版本是 8.0.20 或更新。不要只改其中一项两个参数组合出现频率很高。5.3 小程序请求不到数据域名校验、端口、局域网 IP 三处现象开发者工具里页面空白Console 报request:fail url not in domain list或timeout。原因前者是没勾选“不校验合法域名”。后者是请求地址写错或后端没起来或手机真机上访问了 localhost。解决开发者工具模拟器里先确认右上角本地设置勾选了跳过域名校验。再确认后端控制台确实在监听对应端口。真机预览时把 BASE_URL 改成电脑的局域网 IP。三处都检查后仍然超时可以先用电脑浏览器访问一下 http://localhost:8080/api/notice/list浏览器能通就说明后端没问题问题只在小程序端配置。5.4 分页重复加载更多时 list 被整体覆盖现象列表加载完第一页后滚动到底部数据没有增加而是停留在第一页或者第二页和第一页数据完全一样。原因前端把每次请求返回的数据直接 setData 到 noticeList没用 concat。另外一个原因是后端分页没有按页码计算 offset每次都查第一页。解决前端把赋值改成数组拼接同时在请求参数里带上当前页 pageNum。后端验证分页逻辑时可以在 MySQL 里手动执行两次带不同 LIMIT 的 SQL确认记录确实不同。这个坑在答辩演示时容易出现因为演示时下滑速度过快看起来像数据没加载其实是被覆盖了。5.5 LW 论文架构图和源码对不上单体项目别画微服务图现象论文里画了 Nginx 网关、注册中心、多个微服务模块但源码里就是一个单体 Spring Boot 项目加上一个小程序前端。答辩老师看完源码提问回答不上来。原因写论文时参考了网上的微服务架构模板没有按源码实际结构画图。解决LW 里的架构图必须和源码匹配。单体项目就画三层架构前端小程序、后端 Spring Boot分 Controller/Service/Mapper 三层、MySQL 数据库。如果需要体现“智慧校园”的完整性可以用功能模块图来补充而不是硬画部署拓扑。论文可以写得比源码完善但不能和源码矛盾。这个对照在答辩前必须逐图核对一遍。6. 答辩前一夜能做的四件验证让演示不翻车的具体检查项演示翻车通常不是功能缺失而是环境问题。答辩前按下面四个步骤过一遍能规避掉大部分意外。第一步用 Postman 直接调 5 个核心接口登录、获取公告列表、提交报修、修改个人信息、分页查询。把请求 URL、请求体、返回结果截图放在论文的测试章节里。这一步同时验证了后端是活的也避免了演示时在小程序端现场敲代码。第二步在开发者工具里模拟一次完整的“加载更多”操作确认列表确实在追加而不是覆盖。下拉触底的操作在模拟器里可以用鼠标滚轮或者手动拖动触发触发时注意 Network 面板里有没有发出包含 pageNum2 的请求。没有这个请求说明 onReachBottom 没有正确触发需要检查对应页面的配置。第三步用真机预览一次。开发者工具里正常不代表手机正常。生成体验版二维码拿你自己的手机扫一遍重点确认 BASE_URL 是否已从 localhost 换成局域网 IP以及后端电脑的防火墙是否放行了对应端口。这一步提前做能避免答辩当天换了一台新机器导致接口全部不通的尴尬。第四步对照 LW 论文的时序图把核心流程在源码里找出来。比如“学生提交报修”这个流程论文里画了三个实体源码里就要能对应找到页面、接口、数据表。很多老师会随手翻到时序图指着其中一个动作问“这个在哪实现”能现场指出来比背稿子有效得多。还有一个小技巧把数据库里的一些演示数据改成和你校园相关的真实内容比如把公告标题换成自己学院的名称。答辩时评委看到熟悉的名字认可度会明显不一样。这也侧面证明你确实理解这套系统的数据流而不只是把代码跑通了。我自己的教训是答辩那天不要现场连数据库、不要现场改配置所有环境在头一天晚上全部验证好甚至要把 MySQL 服务设置成开机自启。一个看似不起眼的服务没启动就能毁掉整场演示。希望帮到你。本文还有配套的精品资源点击获取
简介这是一套面向高校毕业设计与课程设计的智慧校园管理系统完整源码包采用微信小程序作为前端、Java作为后端服务并搭配MySQL 5.7数据库。系统覆盖用户身份认证、课表查询、校园活动、成绩查询、校园卡管理等典型模块适合需要快速搭建校园信息化管理项目的学生直接参考与二次开发。压缩包共1759个文件含214个Java后端源码、339个vue前端页面、85个wxml/85个wxss小程序页面、200个js脚本及1份SQL数据库脚本另有docx/pptx答辩说明与md文档整体体积41.01MB目录按小程序端、后端与数据库分层便于定位。当前已有115人学习下载。资源内不仅提供可运行的前后端代码和建库脚本还附带环境配置说明、项目介绍文档及答辩演示PPT能帮助读者从部署调试到论文整理全流程完成毕业设计尤其适合Java Web与小程序开发的初学者借鉴。1. 智慧校园管理系统是个什么毕设一套源码解决“管理端 学生端”两条线拿到“智慧校园管理系统”这类毕设源码包时第一件事不是急着解压跑代码而是想清楚它到底在解决什么问题。这个题目年年有学生做覆盖的模块无非是校园公告、课表查询、教室报修、活动报名、个人信息维护这几类学生端用微信小程序完成查询和提交管理端用 Java 写后台接口数据统一落在 MySQL。真正让这套系统显得“完整”的地方在于它同时具备两个视角学生看到的是轻量的小程序界面管理员看到的是能处理数据增删改查的 Web 服务。对这个题感兴趣的人多半是正在选毕设题目的计算机相关专业学生或者已经拿到源码但不知道怎么在本地把环境跑起来的人。下面从技术栈、运行步骤、核心链路和常见坑四个角度展开把这条线走通。2. 为什么是 java 小程序 mysql一套毕设源码的选型逻辑2.1 三个角色各管什么边界在哪小程序端负责界面渲染和用户交互Java 后端负责业务规则与接口校验MySQL 负责数据持久化。三者分工明确的好处是每一层都可以独立替换。小程序页面不好看改前端就行不影响接口接口返回字段不对改 Java 就行不碰数据库数据库表结构设计不合理只要接口层做兼容前端也不感知。这个选型在毕业设计里尤其合适。微信小程序天然适配移动端使用场景演示时用微信扫码就能打开比装一个 Android 或 Web 应用更有“落地感”。Java 后端配合 Spring Boot 这类框架Controller、Service、Mapper 三层结构清晰答辩时能对着架构图讲清楚请求怎么走。MySQL 则是所有数据类项目的基础哪怕不懂复杂调优建表、写 SQL、讲清楚表关系就足够应付提问。需要注意的是这套组合的边界不是绝对的。有的源码会把业务逻辑写进 Controller有的会为了省事直接用 JdbcTemplate 而不是 MyBatis。拿到包之后先别在代码风格上纠结而是确认一条主链路能不能跑通。2.2 解压后先认目录小程序端、服务端、数据库脚本和 LW 文档怎么区分一个典型的智慧校园毕设 zip 解压之后目录结构大致如下不同学校对文档命名要求不同但核心构件不会有太大差别smart-campus/ ├── frontend/ # 微信小程序工程 │ ├── pages/ │ ├── utils/ │ ├── app.js │ └── app.json ├── backend/ # Java 后端工程Maven 项目 │ ├── src/main/java │ ├── src/main/resources │ └── pom.xml ├── database/ │ └── smart_campus.sql └── LW/ # 论文与答辩相关文档frontend 目录对应小程序工程用微信开发者工具打开时选这个目录而不是整个 zip 解压根目录。backend 是 Java 后端需用 IDEA 或 Eclipse 以 Maven 项目方式导入pom.xml 里声明了依赖版本。database 下的 sql 文件是建库建表脚本导入 MySQL 后才能让后端连上。LW 目录里一般是论文正文、任务书和开题报告。这里容易犯的第一个低级错误是把整个解压目录直接拖进微信开发者工具。开发者工具要求导入的目录必须包含 app.json如果你选的目录不对会直接提示“未找到 app.json”。同理Java 后端导入 IDEA 时要选到 pom.xml 所在的层级而不是把整个 backend 当成普通文件夹打开。提示如果遇到源码是 uni-app 写的frontend 目录里应该能看到 src 子目录和 manifest.json这种情况需要先运行 npm install 再在 HBuilderX 或开发者工具中编译导入。原生小程序和 uni-app 工程的结构不能混用。3. 三分跑通MySQL 建库、Java 后端启动、小程序联调3.1 先导数据库常见命令和字符集参数后端连不上数据库是启动失败的第一大原因所以顺序上先处理 MySQL。拿到 sql 脚本后第一步是建库再导入不要直接双击打开 sql 文件执行那样容易因为默认字符集不对导致中文乱码。推荐用命令行完成mysql -u root -p -e CREATE DATABASE IF NOT EXISTS smart_campus DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -u root -p smart_campus database/smart_campus.sql第一条命令先创建数据库并指定 utf8mb4 字符集第二条命令把表结构和初始数据导入。注意两条命令都用了 -p 参数命令行会提示输入密码。如果本机没装 MySQL先装好服务再执行装好的标志是mysql --version能输出版本信息。为什么强调 utf8mb4 而不是 utf8因为 utf8 在 MySQL 里最多支持 3 字节字符像生僻字或部分 emoji 符号如果小程序端允许用户输入昵称里有表情会写入失败。utf8mb4 是完全覆盖 utf8 的兼容性更好。如果 sql 文件本身已经带了 CREATE DATABASE 语句可以直接省略第一条但导入前还是要确认字符集。导入完成后用mysql -u root -p smart_campus -e SHOW TABLES;验证是否有表生成。能看到表列表就说明数据库部分完成。看不到任何表时检查 sql 文件里是否混入了 CREATE DATABASE 语句如果建库语句里的库名和后端配置的库名不一致后面同样连不上。3.2 后端启动要改的三个配置项和启动结果怎么看Java 后端大多数是 Spring Boot 工程配置文件放在 src/main/resources 下常见文件名是 application.yml 或 application.properties。启动前必须确认三项配置数据库地址、数据库账号密码、服务端口。如果源码里默认配置和你的本地环境不一致启动必然报错。server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/smart_campus?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver端口默认 8080如果本机被其他程序占用改成 8081 或 9090 都行但后面小程序端请求地址也要同步换。数据库名 smart_campus 要和 3.1 中建的库完全一致。password 换成你自己 MySQL 的密码。url 参数里的 useSSLfalse 不是可有可无的MySQL 8.x 默认开启 SSL本地开发环境下驱动握手时经常因为证书校验失败抛异常显式关闭可以少踩一个坑。启动方式是在 IDEA 里找到带 main 方法的 Application 类右键运行。看到类似Tomcat started on port(s): 8080的日志就算成功。如果你没装 IDEA用命令行进到 backend 目录执行mvn spring-boot:run也行但前提是 Maven 已安装且配置过国内镜像源。这里常遇到的翻车现场是 Maven 依赖下载失败原因多半是初始 settings.xml 指向的中央仓库很慢换成阿里云镜像后基本能解决。3.3 小程序端联调关闭域名校验的一个开关和 wx.request 打通的标志后端起来了小程序要能调到接口。用微信开发者工具导入 frontend 目录以后最常见的现象是页面能打开但所有列表都是空的Console 里报request:fail或url not in domain list。这是因为微信小程序在生产环境要求请求地址必须是 HTTPS 且配置在后台的合法域名里但本地开发可以直接绕过这个限制。在开发者工具的右上角“详情 - 本地设置”里勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”。这是所有本地联调的开关不勾选的话请求 http://localhost:8080 一定会被拦。勾选之后小程序里发起请求的地址大致是这样写的// utils/api.js const BASE_URL http://localhost:8080 function request(path, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json }, success: res resolve(res.data), fail: err reject(err) }) }) } module.exports { request, BASE_URL }BASE_URL 有小程序前端和后端两个地方要对应。如果你后端端口改成了 8081这里也要改成 8081。如果你是把小程序放到真机上预览而不是在开发者工具里模拟BASE_URL 里的 localhost 需要换成电脑在局域网中的 IP例如 http://192.168.1.10:8080同时确保手机和电脑连同一个 WiFi。联调打通的标志很简单小程序页面上能看到数据库里的公告列表或个人信息而不是停留在空白或 loading 状态。打开开发者工具的 Network 面板能看到请求返回 200 且 response 里带 JSON 数据。注意真机调试时手机访问不到 localhost这是新手最容易反复折腾半小时的地方。提示如果后端接口地址是 HTTPS但证书是自签名的同样会在真机上被拦。本地联调阶段统一走 HTTP 关闭域名校验是最省事的方案等真正上线再考虑备案和域名配置。4. 看懂一条数据链路从 wx.request 到 MySQL 的完整读写4.1 小程序端最小请求写法wx.request 的参数和 loading 处理小程序端的逻辑集中在 page 里。一个常见的列表页页面加载时先显示 loading再请求后端接口数据回来后用 setData 更新渲染。以下是一段典型的公告列表请求写法// pages/notice/notice.js const api require(../../utils/api) Page({ data: { noticeList: [], loading: false }, onLoad() { this.fetchNotices() }, fetchNotices() { this.setData({ loading: true }) api.request(/api/notice/list, GET) .then(res { this.setData({ noticeList: res.data || [] }) }) .catch(err { console.error(公告列表加载失败, err) }) .finally(() { this.setData({ loading: false }) }) } })这里的关键点有两个。第一wx.request 是异步的不能用回调里的数据直接给外部变量赋值必须走 setData否则页面不会刷新。第二loading 状态需要手工维护接口慢的时候至少能让用户看到“正在加载”的反馈。页面模板里对应的渲染逻辑就是 wx:for 循环view wx:if{{loading}}加载中.../view view wx:for{{noticeList}} wx:keyid classnotice-item text{{item.title}}/text text{{item.publishTime}}/text /viewwx:key 建议用数据主键 id而不是 index。用了 index 的话列表做删除或排序操作时渲染容易错乱。4.2 后端三层链路Controller、Service、Mapper 各改哪一行后端接口需要配合前端路径来写。前端请求 /api/notice/list后端对应的 Controller 里必须有 GetMapping(/list) 且类上标了 RequestMapping(/api/notice)。三层结构里Controller 只负责接收参数和返回结果业务写在 Service 里数据库操作在 Mapper 里。以下是一个查询公告列表的最简实现// NoticeController.java RestController RequestMapping(/api/notice) public class NoticeController { Autowired private NoticeService noticeService; GetMapping(/list) public Result list() { return Result.success(noticeService.listNotices()); } }// NoticeService.java Service public class NoticeService { Autowired private NoticeMapper noticeMapper; public ListNotice listNotices() { return noticeMapper.selectList(null); } }// NoticeMapper.java Mapper public interface NoticeMapper extends BaseMapperNotice { }这里用了 MyBatis-Plus 的 BaseMapperselectList(null) 表示查询全部公告不需要手写 SQL。如果你的源码没有用 MyBatis-Plus而是原生 MyBatis那 Mapper 里会是 List selectAllNotice();对应的 XML 文件里有一条 select 语句。两种写法都能跑通改的时候别混。后端返回的统一结构 Result 也很重要。前端 res.data 拿到的其实是一整个 Result 对象里面可能包含 code、message 和 data 三个字段真正的数据在 data 里。前端代码里写 res.data 是取 data 字段但如果后端 Result 里把数据字段命名为 records 或者 rows这里就要对齐。最好通过 Network 面板直接看响应体结构再决定怎么写。4.3 分页与“加载更多”LIMIT 参数和小程序 onReachBottom 的配合智慧校园的公告、报修记录这类列表不会永远只有几条毕设做到分页是加分项。后端分页常见做法是用 MyBatis-Plus 的 Page 对象前端滚动到底部时再次请求下一页。前端 page 里需要维护一个页码变量// pages/notice/notice.js 追加部分 Page({ data: { pageNum: 1, pageSize: 10, hasMore: true }, onReachBottom() { if (!this.data.hasMore) return this.fetchNotices(this.data.pageNum 1) }, fetchNotices(pageNum) { api.request(/api/notice/page, GET, { pageNum, pageSize: this.data.pageSize }) .then(res { const records res.data.records || [] this.setData({ noticeList: this.data.noticeList.concat(records), pageNum: pageNum, hasMore: records.length this.data.pageSize }) }) } })后端 /api/notice/page 对应一个带分页参数的接口Mapper 层用 LIMIT #{offset}, #{pageSize} 实现。MySQL 分页的 offset 等于 (pageNum - 1) * pageSize这个换算容易写错通常在 Service 层用 Page 对象自动处理不需要手写。这个“加载更多”场景里最典型的 bug 是第二次请求回来后直接把新数据赋值给 noticeList而不是 concat。结果就是下拉到底部后列表没有变多只看到第一页数据在刷新。上面代码里的 concat 是关键动作演示的时候可以刻意让后端返回两页数据再把这段代码换回直接赋值对比给答辩老师看。5. 智慧校园源码导入与运行的 5 个常见坑现象、原因、解决5.1 Unknown database 和 Access denied检查建库语句和字符集现象启动后端时控制台报java.sql.SQLException: Unknown database smart_campus或者Access denied for user rootlocalhost。原因Unknown database 说明后端配置的库名和实际创建的库不一致或者 sql 文件根本没导入成功。Access denied 则通常是密码错误或账号权限不足。解决先执行 SHOW DATABASES 看库里是否存在。不存在就回到 3.1 重新建库。存在但连不上就确认配置文件中的 username 和 password 是不是 root 对应的密码。注意 MySQL 8.0 与 5.7 的默认认证插件不同如果你本机是 8.0 而源码依赖的驱动比较老可能抛Unable to load authentication plugin caching_sha2_password升级 mysql-connector-java 驱动版本即可。5.2 mysql ssl 连接错误MySQL 8 认证方式与驱动版本现象启动后端时抛异常日志里出现Communications link failure或SSL connection error。原因MySQL 8 系列默认启用 SSL 连接而本地数据库通常没有有效的服务端证书驱动握手失败。另一个常见诱因是驱动版本是 5.x连 MySQL 8 不受支持。解决在数据库连接 URL 后面追加useSSLfalseallowPublicKeyRetrievaltrue。前者关闭 SSL后者允许驱动在本地使用公钥检索方式完成认证。同时确认 pom.xml 里的 mysql-connector-java 版本是 8.0.20 或更新。不要只改其中一项两个参数组合出现频率很高。5.3 小程序请求不到数据域名校验、端口、局域网 IP 三处现象开发者工具里页面空白Console 报request:fail url not in domain list或timeout。原因前者是没勾选“不校验合法域名”。后者是请求地址写错或后端没起来或手机真机上访问了 localhost。解决开发者工具模拟器里先确认右上角本地设置勾选了跳过域名校验。再确认后端控制台确实在监听对应端口。真机预览时把 BASE_URL 改成电脑的局域网 IP。三处都检查后仍然超时可以先用电脑浏览器访问一下 http://localhost:8080/api/notice/list浏览器能通就说明后端没问题问题只在小程序端配置。5.4 分页重复加载更多时 list 被整体覆盖现象列表加载完第一页后滚动到底部数据没有增加而是停留在第一页或者第二页和第一页数据完全一样。原因前端把每次请求返回的数据直接 setData 到 noticeList没用 concat。另外一个原因是后端分页没有按页码计算 offset每次都查第一页。解决前端把赋值改成数组拼接同时在请求参数里带上当前页 pageNum。后端验证分页逻辑时可以在 MySQL 里手动执行两次带不同 LIMIT 的 SQL确认记录确实不同。这个坑在答辩演示时容易出现因为演示时下滑速度过快看起来像数据没加载其实是被覆盖了。5.5 LW 论文架构图和源码对不上单体项目别画微服务图现象论文里画了 Nginx 网关、注册中心、多个微服务模块但源码里就是一个单体 Spring Boot 项目加上一个小程序前端。答辩老师看完源码提问回答不上来。原因写论文时参考了网上的微服务架构模板没有按源码实际结构画图。解决LW 里的架构图必须和源码匹配。单体项目就画三层架构前端小程序、后端 Spring Boot分 Controller/Service/Mapper 三层、MySQL 数据库。如果需要体现“智慧校园”的完整性可以用功能模块图来补充而不是硬画部署拓扑。论文可以写得比源码完善但不能和源码矛盾。这个对照在答辩前必须逐图核对一遍。6. 答辩前一夜能做的四件验证让演示不翻车的具体检查项演示翻车通常不是功能缺失而是环境问题。答辩前按下面四个步骤过一遍能规避掉大部分意外。第一步用 Postman 直接调 5 个核心接口登录、获取公告列表、提交报修、修改个人信息、分页查询。把请求 URL、请求体、返回结果截图放在论文的测试章节里。这一步同时验证了后端是活的也避免了演示时在小程序端现场敲代码。第二步在开发者工具里模拟一次完整的“加载更多”操作确认列表确实在追加而不是覆盖。下拉触底的操作在模拟器里可以用鼠标滚轮或者手动拖动触发触发时注意 Network 面板里有没有发出包含 pageNum2 的请求。没有这个请求说明 onReachBottom 没有正确触发需要检查对应页面的配置。第三步用真机预览一次。开发者工具里正常不代表手机正常。生成体验版二维码拿你自己的手机扫一遍重点确认 BASE_URL 是否已从 localhost 换成局域网 IP以及后端电脑的防火墙是否放行了对应端口。这一步提前做能避免答辩当天换了一台新机器导致接口全部不通的尴尬。第四步对照 LW 论文的时序图把核心流程在源码里找出来。比如“学生提交报修”这个流程论文里画了三个实体源码里就要能对应找到页面、接口、数据表。很多老师会随手翻到时序图指着其中一个动作问“这个在哪实现”能现场指出来比背稿子有效得多。还有一个小技巧把数据库里的一些演示数据改成和你校园相关的真实内容比如把公告标题换成自己学院的名称。答辩时评委看到熟悉的名字认可度会明显不一样。这也侧面证明你确实理解这套系统的数据流而不只是把代码跑通了。我自己的教训是答辩那天不要现场连数据库、不要现场改配置所有环境在头一天晚上全部验证好甚至要把 MySQL 服务设置成开机自启。一个看似不起眼的服务没启动就能毁掉整场演示。希望帮到你。本文还有配套的精品资源点击获取
