简介一套基于微信小程序与SSM架构的宿舍报修系统毕业设计源码面向计算机相关专业学生针对宿舍报修信息管理混乱、处理效率低等问题提供可运行的前后端完整方案。系统采用Java语言编写后端搭配MySQL数据库前端整合微信小程序原生页面与Vue管理后台能帮助读者理解从学生端报修到管理员处理、信息集中管理的完整流程。压缩包共664个文件大小约36MB主要包含Java后端源码、Vue后台页面、JavaScript逻辑、小程序页面文件、数据库脚本、启动脚本、演示视频以及SVG、PNG图标素材文件类型丰富且目录清晰可直接对照运行。目前已有391人学习下载。通过这份源码可以掌握SSM框架与微信小程序联调时的接口设计、数据表建模、部署排错等关键技能也为撰写毕业设计文档和准备答辩演示提供了扎实的实例基础。 临近毕设定题那段时间我见过太多人被“微信小程序宿舍报修系统”这类题目卡住——名字看起来直白但真的上手时问题一个接一个登录态怎么搞小程序怎么调后端接口SSM后端又该怎么分层其实这类题目本质并不复杂它就是一个典型的“信息管理系统”变体只是把操作端换成了微信小程序。这篇文章我就从选题拆解、SSM后端实现、小程序对接、联调排错到答辩准备完整复盘一套可落地的宿舍报修系统设计与实现方案给正在做这个课题或者打算拿它当毕业设计的同学一份能直接“抄作业”的参考。先说清楚这套系统能做什么学生用微信小程序提交报修单、拍照上传、查看维修进度维修工接单、填写处理结果宿管或管理员在后台看整体数据、分配人员。整个流程不复杂但足够覆盖业务系统的完整链路——用户端、管理端、后端接口、数据库设计都齐了。也正因为它的业务模式成熟、角色清晰非常适合用来做毕设也适合用来理解SSM框架在实际项目中是怎么运作的。1. 需求边界与功能拆解先想清楚“要做什么”再动手很多同学拿到题目之后第一反应是打开IDE建工程这是最要命的操作。写功能之前建议先把业务角色和状态流转画清楚。宿舍报修系统的核心角色就三类学生、维修工、管理员。学生关心的是“我的报修有没有人管、修得怎么样了”维修工关心的是“有哪些单子待处理、处理完怎么提交结果”管理员关心的是“能不能看到全部维修记录、谁还没处理”。1.1 三类角色与权限划分角色核心操作数据范围学生提交报修、查看自己的报修记录、评价维修结果仅本人数据维修工查看待接工单、接单、填写维修结果全部待处理及已处理工单管理员派单、查看所有工单、管理用户与楼栋信息全部数据这个表看起来简单但它是后面建表、写接口、设计小程序页面结构的根基。很多做崩了的项目就是因为没有在一开始把角色边界划清楚导致写接口时一会儿想着“这个查询要不要管理员权限”一会儿想着“学生能不能看别人单子”越写越乱。1.2 报修单状态流转设计报修单的状态字段是整个系统的灵魂。我的建议是设计一个状态机状态流转要单一方向不要允许任意乱跳。常见状态的流转是提交报修 - 管理员审核/派单 - 维修工接单开始维修 - 维修完成 - 学生确认并评价 - 关闭具体到字段上可以用int类型存状态也可以用String类型存语义化状态。我建议用int配合一个字典表或者在代码注释里写清楚状态含义。因为数据库里int类型排序、索引、查询都更高效而且后面做分类统计比如“待处理几单”“已完成几单”时写SQL非常方便。还有一个容易漏掉的设计点报修单和维修记录的关联。一张报修单可能被维修多次比如第一次没修好第二次返工所以不要只在报修单表上放一个“维修结果”字段就完事最好单独建一张维修流水表记录每次维修的操作人和处理内容。这个细节一旦做了答辩时老师问“如果你的系统遇到返工情况怎么办”你就能有理有据地回答。1.3 核心表结构设计思路这里我给出一个最小可用的表结构参考不是完整的建表SQL但足够说明设计思路用户表userid、openid小程序登录标识、role1学生、2维修工、3管理员、name、phone、create_time。用openid关联微信用户不需要让用户注册账号密码这是小程序端体验最顺滑的做法。报修单表repair_orderid、report_user_id报修人、building、room、description、image_url、status、assign_user_id指派的维修工、create_time、update_time。维修流水表repair_logid、order_id、handler_id、内容、处理时间、备注。楼栋宿舍表dormitoryid、building、room_number。这个表可以用来做表单里的宿舍选择器避免用户手输减少脏数据。2. 技术选型的现实考量为什么SSM反而能打满答辩得分点选SSM还是Spring Boot每年都有同学纠结。我的观点很直接如果是做毕业设计SSM不是劣势反而是优势。原因在于SSM的三层架构非常显式Controller、Service、Mapper层层分明每一个对象都由Spring容器管理MyBatis的Mapper代理机制也清晰可见。这在答辩现场是能展开讲出技术深度的——你可以讲IoC容器如何管理Bean、AOP如何切事务、Mapper如何通过动态代理生成实现类。换成Spring Boot的话很多配置被自动装配藏掉了反而不好讲。2.1 SSM和Spring Boot不是对立面SSM指的是Spring SpringMVC MyBatisSpring Boot则是建立在Spring生态之上的快速开发框架底层还是离不开Spring和MyBatis这类组件。用SSM手写配置你会被迫去理解web.xml、applicationContext.xml、spring-mvc.xml这些配置文件里每一项的作用。这个过程虽然麻烦但是值得。真正面试或答辩时被问“SpringMVC处理一个请求的完整流程”你能从DispatcherServlet开始一步一步说清楚这就是用SSM练出来的基本功。2.2 前端为什么非要选微信小程序宿舍报修的使用场景天然适合小程序因为学生不需要下载App扫码或者在微信里搜索就能用。从毕业设计角度说小程序端用原生语法开发WXML WXSS JS就好不需要引入uni-app或Taro这种跨端框架。原生框架的好处是语法贴近前端基础调试时直接看微信开发者工具的报错可控性强踩坑资料也多。更重要的是答辩时被问“为什么不用App”或“为什么不用H5”小程序在“轻量、免安装、即用即走、微信内天然传播”这几个点上都能给出充分理由。2.3 环境版本搭配建议这一节是容易踩坑的重灾区。我建议的组合是JDK 1.8、Maven 3.6.x、Tomcat 8.5、Spring 5.2.x、MyBatis 3.5.x。这套组合经过大量项目验证兼容性稳定网上资料也最齐全。不要一上来就用JDK 17或者Spring 6那些版本对毕设项目来说没有意义反而会因为依赖兼容问题浪费大量时间。数据库方面用MySQL 5.7或8.0都可以连接驱动注意适配版本。3. 后端接口设计与核心实现细节从“能跑”到“好改”接口设计直接决定了小程序端写起来是否顺畅。我先给一个核心接口清单然后挑重点详细展开。所有接口统一返回格式建议写一个Result类public class ResultT { private Integer code; // 200成功500失败 private String msg; private T data; public static T ResultT success(T data) { ... } public static T ResultT error(String msg) { ... } }统一返回格式最大的好处是小程序端只需要封装一个request工具函数根据code判断成功失败不需要针对每个接口单独处理异常。这是前后端联调效率的关键。3.1 核心接口清单模块接口路径作用登录POST /api/user/login用code换取openid并完成注册/登录报修POST /api/repair/submit提交报修单报修GET /api/repair/list?status0按状态查询报修单列表报修GET /api/repair/detail?id1报修单详情含维修流水维修POST /api/repair/handle维修工提交处理结果维修GET /api/stats/overview管理员查看统计信息3.2 状态流转的后端落法状态流转不要散落在Controller里而是应该收敛在Service层。以“提交维修结果”为例Service内部要做的事包括校验当前单子状态是否是“维修中”、更新报修单状态为“待确认”、插入一条维修流水记录。这三个操作必须放在同一个事务里。你可以用Spring的Transactional注解但要注意它默认只对RuntimeException回滚如果代码里catch住了异常而不重新抛出事务就不生效了。这是踩坑高发点我后面会细说。Service public class RepairService { Transactional(rollbackFor Exception.class) public void handleRepair(RepairHandleRequest request) { RepairOrder order repairOrderMapper.selectById(request.getOrderId()); // 状态机校验 if (order.getStatus() ! STATUS_REPAIRING) { throw new BusinessException(当前状态不可操作); } // 更新主单状态 RepairOrder update new RepairOrder(); update.setId(order.getId()); update.setStatus(STATUS_WAIT_CONFIRM); repairOrderMapper.updateById(update); // 添加维修流水 RepairLog log new RepairLog(); log.setOrderId(order.getId()); log.setHandlerId(request.getHandlerId()); log.setContent(request.getHandleContent()); repairLogMapper.insert(log); } }3.3 主键回显问题MyBatis默认插入数据后不会把数据库自增主键返回给Java对象。如果你插入报修单后马上要用这个id去插入图片表就会拿到空值。解决办法是insert语句里加上useGeneratedKeys和keyPropertyinsert idinsertRepairOrder useGeneratedKeystrue keyPropertyid INSERT INTO repair_order (report_user_id, building, room, description, image_url, status) VALUES (#{reportUserId}, #{building}, #{room}, #{description}, #{imageUrl}, #{status}) /insert3.4 图片上传的路径问题小程序端拍照拿到的是临时文件路径这个路径不能直接存数据库上传后服务端要返回一个可以访问的URL。后端处理上传时用MultipartFile接收文件保存到一个专门的上传目录。这里我踩过一个很深的坑如果把文件写到IDE的target目录下重启项目后文件可能会消失。建议把上传目录配置成绝对路径例如D:/uploadWindows或/opt/uploadLinux并配置静态资源映射让外部能访问。SpringMVC里开启静态资源映射mvc:resources mapping/upload/** locationfile:D:/upload/ /小程序端上传图片用wx.uploadFile需要注意它不是wx.request返回的数据是字符串不是对象需要手动JSON.parse。4. 微信小程序端登录、报修、进度跟踪的实现路径小程序端的核心页面可以规划为三个首页提交报修、报修记录列表、我的个人信息。登录是第一步也是容易写得稀烂的一步。4.1 登录态怎么设计微信小程序提供了wx.login接口调用后会拿到一个临时code这个code有效时间很短需要传给后端由后端调微信的接口code2Session换openid和session_key。openid是用户在小程序里的唯一标识。一个常见的做法是小程序把code传给后端后端查一下openid是否存在不存在就注册新用户存在就直接返回业务token。以后小程序每次请求都在header里带上这个token后端通过拦截器识别用户身份。有同学会问小程序里的wx.getUserProfile不是能拿用户头像昵称吗放在这行不行答案是可以但要注意获取头像昵称只是前端展示用用户没授权时这一步甚至可能弹出失败。真正的身份标识还是openid不要把登录逻辑依赖在用户授权上。4.2 报修表单的体验细节提交报修时宿舍楼栋和房间号不要用输入框建议用picker选择器数据可以从后端楼栋表拉取。描述问题用textarea图片用chooseMedia接口新版APItype选image。提交按钮要做防重复点击用一个submitting标志位控制防止用户手抖连点导致同一报修单提交多次。接口请求封装建议写成一个Promise风格的request方法baseURL单独放在一个config.js文件里方便切换测试环境和正式环境const BASE_URL http://localhost:8080/api; function request(url, method, data) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method: method || GET, data: data || {}, header: { Content-Type: application/json, token: wx.getStorageSync(token) || }, success: (res) { if (res.data.code 200) { resolve(res.data.data); } else { wx.showToast({ title: res.data.msg, icon: none }); reject(res.data); } }, fail: (err) reject(err) }); }); }4.3 状态展示与刷新策略报修记录列表要按不同状态展示建议用tab切换全部、待处理、维修中、已完成。小程序里的swiper或者自定义tab都行。每次从详情页返回列表页时在onShow生命周期里重新拉取数据这样用户提交完评价后回到列表页能立即看到状态更新。下拉刷新也要做因为维修进度是异步更新的用户需要主动刷新才能看到最新状态。5. 联调与填坑实录那些一眼没发现的隐蔽问题前后端分开开发时都很正常一联调各种问题就冒出来了。我把实际项目里遇到的高频问题整理一下这些问题如果等你答辩前才遇到心态容易崩。5.1 跨域问题小程序真机调试、开发者工具访问接口都可能遇到跨域。SSM后端处理跨域最简单的办法是写一个CORS过滤器或者直接在Controller类上加CrossOrigin注解。但要注意CrossOrigin在Spring 4.2以上版本才支持而且如果加了拦截器做token校验预检请求OPTIONS会被拦截器挡掉导致前端报“跨域请求失败”。解决办法是拦截器里对OPTIONS请求直接放行让CORS过滤器去处理。5.2 日期格式导致前端显示乱码后端的Date类型序列化成JSON时默认是时间戳小程序端拿到的是一长串数字还得自己转格式。建议在SpringMVC配置Jackson的时候统一日期格式mvc:annotation-driven mvc:message-converters bean classorg.springframework.http.converter.json.MappingJackson2HttpMessageConverter property nameobjectMapper bean classcom.fasterxml.jackson.databind.ObjectMapper property namedateFormat bean classjava.text.SimpleDateFormat constructor-arg valueyyyy-MM-dd HH:mm:ss/ /bean /property property nametimeZone valueGMT8/ /bean /property /bean /mvc:message-converters /mvc:annotation-driven5.3 数据库字符集和中文乱码插入数据带中文时如果变成问号大概率是数据库连接URL没有指定字符集。在jdbc.properties里加jdbc.urljdbc:mysql://localhost:3306/dorm_repair?useUnicodetruecharacterEncodingutf8mb4用utf8mb4而不是utf8是因为utf8在MySQL里存不了完整的emoji和某些生僻字。如果用户在小程序里输入了带emoji的备注你库是utf8直接报错。这是很多项目上线后才发现的问题。5.4 小程序真机访问不到本地接口开发工具里接口调通了一真机预览就请求失败。原因很简单手机访问不了localhost。解决办法是让手机和电脑连同一个局域网把baseURL里的localhost换成电脑的局域网IP。同时要注意微信公众平台对小程序的request域名有校验但开发调试阶段可以在开发者工具右上角“详情”里勾选“不校验合法域名”不用急着配置正式服务器域名。5.5 排查链路比报错本身重要联调出问题时我建议按这个顺序查先拿Postman直接调后端接口确认后端是不是好的再在小程序network面板看请求是否发出、返回什么最后看控制台报错。很多同学一报错就到处搜其实第一步就应该定位问题出在前端还是后端。用Postman验证接口正常后问题就缩小到小程序端排查效率高很多。6. 从代码到毕业答辩怎么把这套源码讲成你自己的代码写完只是第一步答辩才是最关键的临门一脚。有些同学代码是自己写的但一被问就紧张得说不清楚也有些同学是参考网上的源码改造的更需要提前把每个设计决策背后的理由想清楚。6.1 高频追问与应答思路老师最常问的几个问题“为什么用SSM框架不用Spring Boot”回答思路SSM分层清晰能更深入地理解Spring核心思想Spring Boot是在此基础上的自动化封装两者底层一脉相承。可以用这个回答展示你的底层理解。“同一个宿舍的住户同时报修怎么办”回答思路系统中的每张报修单是独立的如果需要对同一宿舍去重可以在数据库层面对buildingroomstatus加约束或者提交时做校验。“报修单状态是怎么维护的”回答思路用一个状态字段配合代码层面的状态机校验保证状态只能按固定流程流转并说明每个状态对应的用户操作。“图片存在哪里数据库还是文件服务器”回答思路数据库只存图片URL文件存本地磁盘或云存储数据库不存二进制文件。这个回答能体现你懂存储设计。6.2 源码扩展方向如果你想在这个题目上做得更出彩有这几个方向可以扩展给维修工和管理员增加微信订阅消息通知报修单提交后推送消息提醒给报修单增加紧急程度标记加急单有红色标识增加维修评分和评价标签让学生确认完成时打分管理后台用ECharts展示每月报修数量趋势和维修完成率。这些扩展不需要改系统的核心架构只需要在原基础上加字段、加接口、加页面但对评分的帮助非常明显因为老师会觉得你有设计能力而不只是实现了基本功能。6.3 源码阅读与二次开发的顺序建议如果你是参考别人的源码强烈建议按这个顺序读先读数据库脚本理解表结构和初始数据然后读Result、Controller层知道有哪些接口再读Service层理清业务逻辑最后读MyBatis的Mapper文件看SQL怎么写的。不要从工具类开始读更不要从配置类开始读那样容易先把自己绕晕。读源码的时候顺手把每个接口的请求参数和返回结果记录在一张表里后面做小程序对接时会非常省力。最后再分享一个我在实际辅导中反复强调的小技巧一定要在答辩前自己完整跑一遍业务流程——从学生提交报修到管理员派单到维修工处理再到学生确认评价全流程走通。你会发现很多平时没注意到的问题比如提交后没有跳转、状态文字显示不对、图片加载不出来。这些问题早发现早改留到答辩现场就是扣分项。如果时间允许在“我的”页面加一个“我的报修”列表的角标数字提醒用户当前有待处理或进行中的工单这个小功能做起来不难但用户体感会好很多。本文还有配套的精品资源点击获取