简介这是一套面向计算机专业本科生的毕业设计实战资源聚焦设备故障报修场景完整交付微信小程序前端SSM后台MySQL数据库的全栈解决方案适用于课程设计、毕设开题与系统开发能力训练。资源包共1255个文件49.98MB涵盖172个JS/WXML/WXSS小程序源码、138个Vue组件含BreadCrumbs、IndexHeader等管理端页面、127个Java后端业务类、232张PNG/SVG图标资源及2个MP4演示视频结构清晰体现前后端分离架构与角色权限体系。已有131人学习下载提供可直接运行的源码、建库SQL脚本、完整毕业论文文档及管理员/用户/维修员三端功能演示覆盖报修提交、经验分享、维修报告生成与实验室管理等核心业务流程助读者快速理解微信生态下轻量级运维系统的落地逻辑与工程组织方式。1. 这不是“又一个毕设模板”微信小程序SSMMySQL故障报修系统为什么能跑通、能交付、还能真用你手头那份标着“设备故障报修小程序-毕业设计”的压缩包解压后看到2048-小程序.zip、ssm_backend/、db_backup.sql和一堆.docx文件时第一反应可能是“又一个套壳毕设”——但真正跑起来过的人知道这恰恰是最接近工业级轻量运维场景的最小可行闭环微信端用户扫码报修带图片定位语音描述后台用 SSM 框架做业务编排与工单流转MySQL 存下设备台账、报修记录、处理日志和维修人员排班。它不追求高并发但必须稳一次图片上传失败不能丢工单一条 MySQL 更新没回滚会导致维修状态错乱SSM 的事务边界稍一模糊就可能让“已派单”变成“未处理”。这不是玩具项目而是把微信小程序的前端交互能力、SSM 的分层治理能力和 MySQL 的事务可靠性在一个 300 行核心逻辑内拧成一股绳。适合正在写毕设、需要答辩演示、又怕线上翻车的同学也适合刚入职的 Java 工程师拿它当练手靶子补全“从前端请求到数据库落盘”的全链路肌肉记忆。2. 从零搭起可运行骨架微信小程序前端 SSM 后端 MySQL 数据库三件套落地实操2.1 微信小程序端别碰app.json里的tabBar先搞定project.config.json和sitemap.json很多同学卡在第一步开发者工具打开2048-小程序.zip页面一片空白控制台报fail network error。这不是代码问题而是环境配置没对齐。微信小程序不是网页它依赖本地开发工具的 project 配置和网络代理策略。重点改两处// project.config.json关键 { description: 设备故障报修, packOptions: { ignore: [] }, setting: { urlCheck: false, // 必开否则本地调试无法调用 localhost 后端 es6: true, postcss: true, minified: false, newFeature: true, enhance: true, compileHotReLoad: true, lazyLoad: true, autoAudits: false }, compileType: miniprogram, libVersion: 2.29.4, appid: wx1234567890abcdef, // 此处填你自己的测试 AppID非必须但建议填 projectname: device-repair-miniapp, condition: {} }提示urlCheck: false是生死线。微信默认禁止访问http://localhost关掉它才能让小程序前端连上你本机跑的 SSM 后端如http://localhost:8080/api/repair/submit。若仍报错检查sitemap.json是否存在且内容为{desc:用于搜索,rules:[{action:allow,page:*}]}—— 没这个文件部分基础 API如wx.chooseImage会静默失效。2.2 SSM 后端用spring-boot-starter-web替换原始web.xml省掉 80% 配置坑原始毕设工程大概率是传统 XML 配置的 Spring MVCweb.xmlspring-mvc.xmlapplicationContext.xml启动慢、报错晦涩、IDEA 识别差。我直接重构成 Spring Boot 风格保留 SSM 核心能力Spring IoC SpringMVC MyBatis但用注解驱动!-- pom.xml 关键依赖 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId version2.7.18/version !-- 与 JDK8 兼容性最好避免用 3.x -- /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency对应主启动类加SpringBootApplication和MapperScan(com.example.repair.mapper)Controller 层用RestControllerRequestMapping(/api/repair)不再写web.xml。这样做的好处是启动日志清晰报错直接定位到哪行Autowired失败application.yml里配数据库只需三行spring: datasource: url: jdbc:mysql://localhost:3306/device_repair?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_passwordMyBatis 自动生成 SQL 日志加logging.level.com.example.repair.mapperDEBUG查不到数据时一眼看出是 SQL 写错还是参数没传。2.3 MySQL 数据库用utf8mb4字符集建库别信utf8能存 emojidb_backup.sql导入失败十有八九是字符集惹的祸。微信小程序用户拍照上传的文件名、语音转文字的描述、甚至维修人员手写的备注都可能含 emoji 或生僻汉字如「 manoeuvre」、「」。MySQL 的utf8实际只支持最多 3 字节字符而 emoji 需要 4 字节 —— 必须用utf8mb4-- 创建数据库时指定字符集 CREATE DATABASE device_repair CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入前确保表结构也用了 utf8mb4 ALTER TABLE repair_record CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE device_info CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意光改表不够还要改 MySQL 配置文件my.cnfLinux或my.iniWindows[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake true重启 MySQL 后执行SHOW VARIABLES LIKE character_set%;确认全部为utf8mb4再导入db_backup.sql。否则中文变???emoji 直接报错Incorrect string value。3. 报修流程闭环打通从微信端提交 → SSM 接收 → MySQL 落库 → 状态更新的四步链路验证3.1 微信端提交用wx.uploadFile传图 wx.getLocation传定位别用wx.request传 base64原始代码常把图片转成 base64 字符串塞进 JSON 发给后端这是大忌一张 2MB 图片 base64 后膨胀到 ~2.7MB微信小程序wx.request默认限制 10MB但实际超过 2MB 就开始丢包、超时。正确做法是用微信原生wx.uploadFile// pages/submit/submit.js wx.chooseImage({ count: 3, success(res) { const tempFilePaths res.tempFilePaths; wx.getLocation({ // 获取当前定位 type: wgs84, success(locRes) { // 逐张上传每张生成一个 file_id 存库 tempFilePaths.forEach((path, idx) { wx.uploadFile({ url: http://localhost:8080/api/repair/upload, filePath: path, name: file, // 后端 RequestParam(file) MultipartFile file 对应的 name formData: { latitude: locRes.latitude, longitude: locRes.longitude, deviceId: this.data.deviceId, index: idx // 区分多图顺序 }, success: uploadRes { const data JSON.parse(uploadRes.data); if (data.code 200) { this.setData({ uploadedFiles: [...this.data.uploadedFiles, data.data.fileId] }); } } }) }) } }) } })逻辑说明wx.uploadFile本质是 multipart/form-data 提交后端用RequestParam接收文件流比 JSON 传 base64 稳定 10 倍。formData里塞定位和设备 ID避免后端再查一次设备表。index字段保证多图顺序可还原。3.2 SSM 接收用Transactional包裹整个报修创建防“图片入库成功但工单没建”报修流程本质是分布式事务简化版先存图片路径file_info表再建工单repair_record表最后关联repair_file_rel表。三步缺一不可否则出现“用户看到提交成功后台查不到工单”。Service public class RepairService { Transactional(rollbackFor Exception.class) // 关键异常时自动回滚所有操作 public Result submitRepair(RepairSubmitDTO dto) { // 1. 保存图片信息假设已由 upload 接口存好此处只存关联 ListString fileIds dto.getFileIds(); // 2. 创建主工单 RepairRecord record new RepairRecord(); record.setDeviceId(dto.getDeviceId()); record.setDescription(dto.getDescription()); record.setStatus(RepairStatus.WAITING); // 初始状态待处理 record.setCreateTime(new Date()); repairRecordMapper.insert(record); // MyBatis 插入返回自增 id // 3. 关联图片 for (String fileId : fileIds) { RepairFileRel rel new RepairFileRel(); rel.setRepairId(record.getId()); rel.setFileId(fileId); repairFileRelMapper.insert(rel); } return Result.success(提交成功); } }参数说明Transactional(rollbackFor Exception.class)是底线。若repairFileRelMapper.insert报错如外键repairId不存在整个方法回滚repair_record行被撤销用户端收到失败提示不会留下脏数据。3.3 MySQL 落库给repair_record.status加索引否则 1000 条数据后列表页就卡微信小程序“我的报修”页面要按状态筛选待处理/处理中/已完成SQL 是SELECT * FROM repair_record WHERE status ? ORDER BY create_time DESC LIMIT 10。如果status字段没索引MySQL 会全表扫描 —— 数据量一过千列表加载就明显卡顿。-- 执行一次即可 ALTER TABLE repair_record ADD INDEX idx_status (status); -- 若还需按设备状态查如“某设备所有待处理工单”建联合索引 ALTER TABLE repair_record ADD INDEX idx_device_status (device_id, status);血泪经验毕设答辩现场演示时导师点开“我的报修”列表等了 5 秒才出数据当场质疑“性能不行”。加完索引响应降到 80ms。索引不是越多越好但WHERE条件里的字段尤其是枚举型status必须建。3.4 状态更新用UpdateProvider动态 SQL 更新避免硬编码 SQL 字符串维修人员在后台处理工单时要更新状态、填写处理意见、上传处理后照片。原始代码可能写死 SQL// 危险SQL 注入风险 难维护 String sql UPDATE repair_record SET status status , handle_desc desc WHERE id id;正确做法是 MyBatis 的UpdateProviderMapper public interface RepairRecordMapper { UpdateProvider(type RepairRecordSqlProvider.class, method updateStatusAndDesc) int updateStatusAndDesc(Param(id) Long id, Param(status) String status, Param(handleDesc) String handleDesc, Param(handleTime) Date handleTime); } public class RepairRecordSqlProvider { public String updateStatusAndDesc(MapString, Object params) { return new SQL(){{ UPDATE(repair_record); if (params.get(status) ! null) { SET(status #{status}); } if (params.get(handleDesc) ! null) { SET(handle_desc #{handleDesc}); } if (params.get(handleTime) ! null) { SET(handle_time #{handleTime}); } WHERE(id #{id}); }}.toString(); } }好处动态拼 SQL空字段不更新参数化防注入SQL 逻辑和 Java 逻辑分离改状态字段不用动 XML。毕设答辩时导师问“如果增加‘处理人’字段怎么改”你指指updateStatusAndDesc方法里加一行if (xxx) SET(...)就行比改 XML 或硬编码体面十倍。4. 避坑指南微信小程序SSMMySQL 故障报修系统上线前必踩的 5 个坑4.1 现象小程序上传图片成功但后台MultipartFile为空原因wx.uploadFile的name参数和后端RequestParam(file)的字符串不一致或formData里传了file字段但后端没接收。解决前端name: file后端RequestParam(file) MultipartFile file二者必须完全一致若传多图后端用RequestParam(file) MultipartFile[] files接收。4.2 现象SSM 启动报Failed to bind properties提示spring.datasource.url无效原因application.yml中url值没用单引号包裹且含特殊字符如、:未转义。MySQL 连接串里的密码含时URL 解析会截断。解决url: jdbc:mysql://localhost:3306/device_repair?useUnicodetrue...所有连接串用单引号包住密码含特殊字符时用 URL 编码如→%40。4.3 现象MySQL 导入db_backup.sql报错ERROR 1067 (42000): Invalid default value for create_time原因MySQL 5.7 以上严格模式默认禁用0000-00-00时间默认值设为CURRENT_TIMESTAMP时旧 SQL 可能写DEFAULT 0000-00-00 00:00:00。解决临时关闭严格模式仅开发环境在my.cnf加sql_modeSTRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION删掉NO_ZERO_DATE或直接改db_backup.sql把DEFAULT 0000-00-00 00:00:00改成DEFAULT CURRENT_TIMESTAMP。4.4 现象微信小程序真机调试报request:fail ssl hand shake error原因后端用http://localhost:8080真机无法解析localhost且微信强制要求 HTTPS开发版可例外但需在小程序管理后台加request合法域名。解决开发阶段用 ngrok 或 localtunnel 映射本地端口如https://abc123.ngrok.io小程序request地址改为该域名或使用微信开发者工具的“真机调试”功能勾选“不校验合法域名”。4.5 现象SSM 返回 JSON 中文乱码显示为??原因Spring Boot 默认字符集是ISO-8859-1未显式设为 UTF-8。解决application.yml加spring: http: encoding: charset: UTF-8 enabled: true force: true web: resources: static-locations: classpath:/static/并确保 Controller 返回对象用ResponseBody不要手动response.getWriter().write()。5. 让毕设不止于“能跑”三个真实可用的进阶技巧答辩时让导师眼前一亮5.1 微信小程序端加“离线缓存”用wx.setStorageSync存草稿断网也能填一半用户填完设备 ID、描述正要选图时地铁进隧道没信号 —— 传统毕设直接白屏。加个草稿箱体验立刻不同// pages/submit/submit.js Page({ data: { deviceId: , description: }, onInputDeviceId(e) { this.setData({ deviceId: e.detail.value }); this.saveDraft(); // 实时存 }, onInputDesc(e) { this.setData({ description: e.detail.value }); this.saveDraft(); }, saveDraft() { const draft { deviceId: this.data.deviceId, description: this.data.description, timestamp: Date.now() }; wx.setStorageSync(repair_draft, draft); }, onLoad() { const draft wx.getStorageSync(repair_draft); if (draft Date.now() - draft.timestamp 24 * 60 * 60 * 1000) { // 24小时内有效 this.setData({ deviceId: draft.deviceId, description: draft.description }); } } })价值点不增加后端负担纯前端实现答辩时演示“断网填单→联网提交”导师会点头——这叫用户思维不是代码堆砌。5.2 SSM 后端加“工单超时预警”用Scheduled每 5 分钟扫一次发微信服务通知毕设常缺“闭环验证”。加个定时任务让系统自己发现问题Component public class TimeoutWarningTask { Autowired private RepairRecordMapper repairRecordMapper; Autowired private WxService wxService; // 封装微信模板消息发送 Scheduled(fixedRate 300000) // 每5分钟执行 public void checkTimeout() { // 查找创建超30分钟、状态仍是 WAITING 的工单 ListRepairRecord timeoutRecords repairRecordMapper.selectTimeoutRecords( new Date(System.currentTimeMillis() - 30 * 60 * 1000) ); for (RepairRecord r : timeoutRecords) { // 发微信服务通知给管理员需提前在公众号后台配置模板 wxService.sendTimeoutWarning(r.getId(), r.getDeviceId(), r.getCreateTime()); } } }参数说明fixedRate 300000是毫秒即 5 分钟selectTimeoutRecords是自定义 Mapper 方法SQL 为SELECT * FROM repair_record WHERE status WAITING AND create_time ?。微信模板消息需提前申请但毕设用测试号发给自己看足够。5.3 MySQL 加“维修耗时统计视图”一条 SQL 算出各维修员平均响应时间答辩常被问“数据有什么用”。建个视图让数据自己说话-- 创建视图维修员平均响应时长从报修到首次处理的时间差 CREATE VIEW v_maintainer_avg_response AS SELECT u.name AS maintainer_name, COUNT(*) AS total_repairs, AVG(TIMESTAMPDIFF(MINUTE, r.create_time, r.handle_time)) AS avg_response_minutes FROM repair_record r JOIN sys_user u ON r.handler_id u.id WHERE r.handle_time IS NOT NULL GROUP BY u.name;验证方法在 MySQL 客户端执行SELECT * FROM v_maintainer_avg_response ORDER BY avg_response_minutes;结果直接贴进毕业论文“数据分析”章节。比写“系统提高了效率”有力一万倍。我带过 7 届毕设学生最常后悔的不是代码写得丑而是没在答辩前 3 天加一个“离线草稿”或“超时预警”——这些小功能不难但能让导师觉得你真把系统当产品在打磨而不是交差。现在就把wx.setStorageSync那段代码抄进你的submit.js跑一遍断网再联网你会看到那种踏实感。希望帮到你。本文还有配套的精品资源点击获取 微信小程序+SSM+MySQL故障报修系统实战指南
简介这是一套面向计算机专业本科生的毕业设计实战资源聚焦设备故障报修场景完整交付微信小程序前端SSM后台MySQL数据库的全栈解决方案适用于课程设计、毕设开题与系统开发能力训练。资源包共1255个文件49.98MB涵盖172个JS/WXML/WXSS小程序源码、138个Vue组件含BreadCrumbs、IndexHeader等管理端页面、127个Java后端业务类、232张PNG/SVG图标资源及2个MP4演示视频结构清晰体现前后端分离架构与角色权限体系。已有131人学习下载提供可直接运行的源码、建库SQL脚本、完整毕业论文文档及管理员/用户/维修员三端功能演示覆盖报修提交、经验分享、维修报告生成与实验室管理等核心业务流程助读者快速理解微信生态下轻量级运维系统的落地逻辑与工程组织方式。1. 这不是“又一个毕设模板”微信小程序SSMMySQL故障报修系统为什么能跑通、能交付、还能真用你手头那份标着“设备故障报修小程序-毕业设计”的压缩包解压后看到2048-小程序.zip、ssm_backend/、db_backup.sql和一堆.docx文件时第一反应可能是“又一个套壳毕设”——但真正跑起来过的人知道这恰恰是最接近工业级轻量运维场景的最小可行闭环微信端用户扫码报修带图片定位语音描述后台用 SSM 框架做业务编排与工单流转MySQL 存下设备台账、报修记录、处理日志和维修人员排班。它不追求高并发但必须稳一次图片上传失败不能丢工单一条 MySQL 更新没回滚会导致维修状态错乱SSM 的事务边界稍一模糊就可能让“已派单”变成“未处理”。这不是玩具项目而是把微信小程序的前端交互能力、SSM 的分层治理能力和 MySQL 的事务可靠性在一个 300 行核心逻辑内拧成一股绳。适合正在写毕设、需要答辩演示、又怕线上翻车的同学也适合刚入职的 Java 工程师拿它当练手靶子补全“从前端请求到数据库落盘”的全链路肌肉记忆。2. 从零搭起可运行骨架微信小程序前端 SSM 后端 MySQL 数据库三件套落地实操2.1 微信小程序端别碰app.json里的tabBar先搞定project.config.json和sitemap.json很多同学卡在第一步开发者工具打开2048-小程序.zip页面一片空白控制台报fail network error。这不是代码问题而是环境配置没对齐。微信小程序不是网页它依赖本地开发工具的 project 配置和网络代理策略。重点改两处// project.config.json关键 { description: 设备故障报修, packOptions: { ignore: [] }, setting: { urlCheck: false, // 必开否则本地调试无法调用 localhost 后端 es6: true, postcss: true, minified: false, newFeature: true, enhance: true, compileHotReLoad: true, lazyLoad: true, autoAudits: false }, compileType: miniprogram, libVersion: 2.29.4, appid: wx1234567890abcdef, // 此处填你自己的测试 AppID非必须但建议填 projectname: device-repair-miniapp, condition: {} }提示urlCheck: false是生死线。微信默认禁止访问http://localhost关掉它才能让小程序前端连上你本机跑的 SSM 后端如http://localhost:8080/api/repair/submit。若仍报错检查sitemap.json是否存在且内容为{desc:用于搜索,rules:[{action:allow,page:*}]}—— 没这个文件部分基础 API如wx.chooseImage会静默失效。2.2 SSM 后端用spring-boot-starter-web替换原始web.xml省掉 80% 配置坑原始毕设工程大概率是传统 XML 配置的 Spring MVCweb.xmlspring-mvc.xmlapplicationContext.xml启动慢、报错晦涩、IDEA 识别差。我直接重构成 Spring Boot 风格保留 SSM 核心能力Spring IoC SpringMVC MyBatis但用注解驱动!-- pom.xml 关键依赖 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId version2.7.18/version !-- 与 JDK8 兼容性最好避免用 3.x -- /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency对应主启动类加SpringBootApplication和MapperScan(com.example.repair.mapper)Controller 层用RestControllerRequestMapping(/api/repair)不再写web.xml。这样做的好处是启动日志清晰报错直接定位到哪行Autowired失败application.yml里配数据库只需三行spring: datasource: url: jdbc:mysql://localhost:3306/device_repair?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: your_passwordMyBatis 自动生成 SQL 日志加logging.level.com.example.repair.mapperDEBUG查不到数据时一眼看出是 SQL 写错还是参数没传。2.3 MySQL 数据库用utf8mb4字符集建库别信utf8能存 emojidb_backup.sql导入失败十有八九是字符集惹的祸。微信小程序用户拍照上传的文件名、语音转文字的描述、甚至维修人员手写的备注都可能含 emoji 或生僻汉字如「 manoeuvre」、「」。MySQL 的utf8实际只支持最多 3 字节字符而 emoji 需要 4 字节 —— 必须用utf8mb4-- 创建数据库时指定字符集 CREATE DATABASE device_repair CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 导入前确保表结构也用了 utf8mb4 ALTER TABLE repair_record CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE device_info CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;注意光改表不够还要改 MySQL 配置文件my.cnfLinux或my.iniWindows[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake true重启 MySQL 后执行SHOW VARIABLES LIKE character_set%;确认全部为utf8mb4再导入db_backup.sql。否则中文变???emoji 直接报错Incorrect string value。3. 报修流程闭环打通从微信端提交 → SSM 接收 → MySQL 落库 → 状态更新的四步链路验证3.1 微信端提交用wx.uploadFile传图 wx.getLocation传定位别用wx.request传 base64原始代码常把图片转成 base64 字符串塞进 JSON 发给后端这是大忌一张 2MB 图片 base64 后膨胀到 ~2.7MB微信小程序wx.request默认限制 10MB但实际超过 2MB 就开始丢包、超时。正确做法是用微信原生wx.uploadFile// pages/submit/submit.js wx.chooseImage({ count: 3, success(res) { const tempFilePaths res.tempFilePaths; wx.getLocation({ // 获取当前定位 type: wgs84, success(locRes) { // 逐张上传每张生成一个 file_id 存库 tempFilePaths.forEach((path, idx) { wx.uploadFile({ url: http://localhost:8080/api/repair/upload, filePath: path, name: file, // 后端 RequestParam(file) MultipartFile file 对应的 name formData: { latitude: locRes.latitude, longitude: locRes.longitude, deviceId: this.data.deviceId, index: idx // 区分多图顺序 }, success: uploadRes { const data JSON.parse(uploadRes.data); if (data.code 200) { this.setData({ uploadedFiles: [...this.data.uploadedFiles, data.data.fileId] }); } } }) }) } }) } })逻辑说明wx.uploadFile本质是 multipart/form-data 提交后端用RequestParam接收文件流比 JSON 传 base64 稳定 10 倍。formData里塞定位和设备 ID避免后端再查一次设备表。index字段保证多图顺序可还原。3.2 SSM 接收用Transactional包裹整个报修创建防“图片入库成功但工单没建”报修流程本质是分布式事务简化版先存图片路径file_info表再建工单repair_record表最后关联repair_file_rel表。三步缺一不可否则出现“用户看到提交成功后台查不到工单”。Service public class RepairService { Transactional(rollbackFor Exception.class) // 关键异常时自动回滚所有操作 public Result submitRepair(RepairSubmitDTO dto) { // 1. 保存图片信息假设已由 upload 接口存好此处只存关联 ListString fileIds dto.getFileIds(); // 2. 创建主工单 RepairRecord record new RepairRecord(); record.setDeviceId(dto.getDeviceId()); record.setDescription(dto.getDescription()); record.setStatus(RepairStatus.WAITING); // 初始状态待处理 record.setCreateTime(new Date()); repairRecordMapper.insert(record); // MyBatis 插入返回自增 id // 3. 关联图片 for (String fileId : fileIds) { RepairFileRel rel new RepairFileRel(); rel.setRepairId(record.getId()); rel.setFileId(fileId); repairFileRelMapper.insert(rel); } return Result.success(提交成功); } }参数说明Transactional(rollbackFor Exception.class)是底线。若repairFileRelMapper.insert报错如外键repairId不存在整个方法回滚repair_record行被撤销用户端收到失败提示不会留下脏数据。3.3 MySQL 落库给repair_record.status加索引否则 1000 条数据后列表页就卡微信小程序“我的报修”页面要按状态筛选待处理/处理中/已完成SQL 是SELECT * FROM repair_record WHERE status ? ORDER BY create_time DESC LIMIT 10。如果status字段没索引MySQL 会全表扫描 —— 数据量一过千列表加载就明显卡顿。-- 执行一次即可 ALTER TABLE repair_record ADD INDEX idx_status (status); -- 若还需按设备状态查如“某设备所有待处理工单”建联合索引 ALTER TABLE repair_record ADD INDEX idx_device_status (device_id, status);血泪经验毕设答辩现场演示时导师点开“我的报修”列表等了 5 秒才出数据当场质疑“性能不行”。加完索引响应降到 80ms。索引不是越多越好但WHERE条件里的字段尤其是枚举型status必须建。3.4 状态更新用UpdateProvider动态 SQL 更新避免硬编码 SQL 字符串维修人员在后台处理工单时要更新状态、填写处理意见、上传处理后照片。原始代码可能写死 SQL// 危险SQL 注入风险 难维护 String sql UPDATE repair_record SET status status , handle_desc desc WHERE id id;正确做法是 MyBatis 的UpdateProviderMapper public interface RepairRecordMapper { UpdateProvider(type RepairRecordSqlProvider.class, method updateStatusAndDesc) int updateStatusAndDesc(Param(id) Long id, Param(status) String status, Param(handleDesc) String handleDesc, Param(handleTime) Date handleTime); } public class RepairRecordSqlProvider { public String updateStatusAndDesc(MapString, Object params) { return new SQL(){{ UPDATE(repair_record); if (params.get(status) ! null) { SET(status #{status}); } if (params.get(handleDesc) ! null) { SET(handle_desc #{handleDesc}); } if (params.get(handleTime) ! null) { SET(handle_time #{handleTime}); } WHERE(id #{id}); }}.toString(); } }好处动态拼 SQL空字段不更新参数化防注入SQL 逻辑和 Java 逻辑分离改状态字段不用动 XML。毕设答辩时导师问“如果增加‘处理人’字段怎么改”你指指updateStatusAndDesc方法里加一行if (xxx) SET(...)就行比改 XML 或硬编码体面十倍。4. 避坑指南微信小程序SSMMySQL 故障报修系统上线前必踩的 5 个坑4.1 现象小程序上传图片成功但后台MultipartFile为空原因wx.uploadFile的name参数和后端RequestParam(file)的字符串不一致或formData里传了file字段但后端没接收。解决前端name: file后端RequestParam(file) MultipartFile file二者必须完全一致若传多图后端用RequestParam(file) MultipartFile[] files接收。4.2 现象SSM 启动报Failed to bind properties提示spring.datasource.url无效原因application.yml中url值没用单引号包裹且含特殊字符如、:未转义。MySQL 连接串里的密码含时URL 解析会截断。解决url: jdbc:mysql://localhost:3306/device_repair?useUnicodetrue...所有连接串用单引号包住密码含特殊字符时用 URL 编码如→%40。4.3 现象MySQL 导入db_backup.sql报错ERROR 1067 (42000): Invalid default value for create_time原因MySQL 5.7 以上严格模式默认禁用0000-00-00时间默认值设为CURRENT_TIMESTAMP时旧 SQL 可能写DEFAULT 0000-00-00 00:00:00。解决临时关闭严格模式仅开发环境在my.cnf加sql_modeSTRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION删掉NO_ZERO_DATE或直接改db_backup.sql把DEFAULT 0000-00-00 00:00:00改成DEFAULT CURRENT_TIMESTAMP。4.4 现象微信小程序真机调试报request:fail ssl hand shake error原因后端用http://localhost:8080真机无法解析localhost且微信强制要求 HTTPS开发版可例外但需在小程序管理后台加request合法域名。解决开发阶段用 ngrok 或 localtunnel 映射本地端口如https://abc123.ngrok.io小程序request地址改为该域名或使用微信开发者工具的“真机调试”功能勾选“不校验合法域名”。4.5 现象SSM 返回 JSON 中文乱码显示为??原因Spring Boot 默认字符集是ISO-8859-1未显式设为 UTF-8。解决application.yml加spring: http: encoding: charset: UTF-8 enabled: true force: true web: resources: static-locations: classpath:/static/并确保 Controller 返回对象用ResponseBody不要手动response.getWriter().write()。5. 让毕设不止于“能跑”三个真实可用的进阶技巧答辩时让导师眼前一亮5.1 微信小程序端加“离线缓存”用wx.setStorageSync存草稿断网也能填一半用户填完设备 ID、描述正要选图时地铁进隧道没信号 —— 传统毕设直接白屏。加个草稿箱体验立刻不同// pages/submit/submit.js Page({ data: { deviceId: , description: }, onInputDeviceId(e) { this.setData({ deviceId: e.detail.value }); this.saveDraft(); // 实时存 }, onInputDesc(e) { this.setData({ description: e.detail.value }); this.saveDraft(); }, saveDraft() { const draft { deviceId: this.data.deviceId, description: this.data.description, timestamp: Date.now() }; wx.setStorageSync(repair_draft, draft); }, onLoad() { const draft wx.getStorageSync(repair_draft); if (draft Date.now() - draft.timestamp 24 * 60 * 60 * 1000) { // 24小时内有效 this.setData({ deviceId: draft.deviceId, description: draft.description }); } } })价值点不增加后端负担纯前端实现答辩时演示“断网填单→联网提交”导师会点头——这叫用户思维不是代码堆砌。5.2 SSM 后端加“工单超时预警”用Scheduled每 5 分钟扫一次发微信服务通知毕设常缺“闭环验证”。加个定时任务让系统自己发现问题Component public class TimeoutWarningTask { Autowired private RepairRecordMapper repairRecordMapper; Autowired private WxService wxService; // 封装微信模板消息发送 Scheduled(fixedRate 300000) // 每5分钟执行 public void checkTimeout() { // 查找创建超30分钟、状态仍是 WAITING 的工单 ListRepairRecord timeoutRecords repairRecordMapper.selectTimeoutRecords( new Date(System.currentTimeMillis() - 30 * 60 * 1000) ); for (RepairRecord r : timeoutRecords) { // 发微信服务通知给管理员需提前在公众号后台配置模板 wxService.sendTimeoutWarning(r.getId(), r.getDeviceId(), r.getCreateTime()); } } }参数说明fixedRate 300000是毫秒即 5 分钟selectTimeoutRecords是自定义 Mapper 方法SQL 为SELECT * FROM repair_record WHERE status WAITING AND create_time ?。微信模板消息需提前申请但毕设用测试号发给自己看足够。5.3 MySQL 加“维修耗时统计视图”一条 SQL 算出各维修员平均响应时间答辩常被问“数据有什么用”。建个视图让数据自己说话-- 创建视图维修员平均响应时长从报修到首次处理的时间差 CREATE VIEW v_maintainer_avg_response AS SELECT u.name AS maintainer_name, COUNT(*) AS total_repairs, AVG(TIMESTAMPDIFF(MINUTE, r.create_time, r.handle_time)) AS avg_response_minutes FROM repair_record r JOIN sys_user u ON r.handler_id u.id WHERE r.handle_time IS NOT NULL GROUP BY u.name;验证方法在 MySQL 客户端执行SELECT * FROM v_maintainer_avg_response ORDER BY avg_response_minutes;结果直接贴进毕业论文“数据分析”章节。比写“系统提高了效率”有力一万倍。我带过 7 届毕设学生最常后悔的不是代码写得丑而是没在答辩前 3 天加一个“离线草稿”或“超时预警”——这些小功能不难但能让导师觉得你真把系统当产品在打磨而不是交差。现在就把wx.setStorageSync那段代码抄进你的submit.js跑一遍断网再联网你会看到那种踏实感。希望帮到你。本文还有配套的精品资源点击获取