社区养老服务小程序+SSM毕设：从分层架构到联调踩坑全指南

简介一份基于微信小程序与SSM后端框架的社区养老服务系统毕业设计源码案例面向正在筹备毕业设计、课程设计或期末大作业的计算机专业学生也适合希望获得真实项目实战经验的学习者。系统围绕预约护理、健康管理、日常照料、文化娱乐等社区养老核心功能展开用完整业务场景串联后端逻辑与前端页面结构清晰、可复用性强。压缩包共1709个文件、88.39MB。源码主体为java后端、vue管理端页面、wxml与wxss小程序端页面配套json配置、png与jpg界面截图、mp4演示视频、sql数据库脚本以及bat安装运行脚本覆盖环境搭建、数据初始化、功能演示到二次开发的完整链路。已有79人学习下载。资料内含源码、数据库、演示视频、使用说明与环境安装说明同时提供构建与启动脚本可帮助快速还原可运行环境。项目经导师指导并获95分以上高分认可既能作为毕业设计参考模板也是学习微信小程序与SSM整合开发的有价值实战素材。1. 社区养老服务小程序SSM毕设先搞明白它凭什么拿到95分一个社区养老服务系统前端用微信小程序后端用SSM这是一套在毕业设计答辩里非常稳的组合。小程序负责老人家属端的使用与展示SSM负责业务接口和数据持久化中间通过JSON交互。这个题目的核心价值在于业务场景贴近民生、技术栈覆盖广、前后端分离的形态让评委容易看到工作量。它适合两类人一类是还没定题、想找一个稳妥方案的本科生另一类是已经有了雏形、但被框架配置和联调卡住的开发者。只要数据库设计不软、接口逻辑闭环、小程序页面能跑通登录和预约拿高分并不是运气而是工程习惯。2. SSM后端的分层设计和数据库建模评分老师最爱看的几个点2.1 三个端与功能边界先画清楚谁会点解手术社区养老和普通电商后台的最大区别是角色模型必须落在真实服务流程上。结合养老现场我把系统拆成三个端而不是两个老人家属使用的小程序端服务人员的接单端以及管理员的Web后台。小程序端承担预约服务、健康打卡、服务进度查询、紧急联系人服务人员端接单与提交服务记录后台管理端负责人工审核、排班和统计。这三个角色映射到权限上直接决定数据库和接口怎么设计。很多拿到中等分的毕设是「页面多、角色乱」——用户表里一个role字段写死普通用户和管理员服务人员的记录和服务工单混在一起答辩时一问业务流程就露怯。反过来角色边界画清楚表结构和接口路径都跟着变清晰。这里的约定是小程序端只通过后端接口取数据后台管理用SSM自带视图或单独JSP不和小程序共享页面这样前后端责任是干净的。2.2 SSM三层架构在项目里怎么落Controller只做分发不写SQLSSM是Spring、SpringMVC、MyBatis的组合。在养老项目里它的分层通常是这样的Controller层暴露REST接口比如/api/order/createService层写业务逻辑比如创建订单前校验老人档案是否完整Mapper层由MyBatis管理SQL只负责持久化。评分时老师会优先看Controller里有没有业务逻辑——如果Controller里直接拼SQL或者写了一大段if-else印象分会明显往下走。我写这个项目时采用一个简单约定Controller方法只做参数接收、调用Service、返回统一结果集所有业务判断放进Service所有SQL留在Mapper XML。这样每个类职责单一也方便后期加权限切面。下面是一个典型的接口写法RestController RequestMapping(/api/order) public class OrderController { Resource private OrderService orderService; PostMapping(/create) public Result create(RequestBody OrderRequest req) { // 参数合法性校验放到Service里Controller不处理业务细节 if (!orderService.createOrder(req)) { return Result.error(预约失败请检查服务时间); } return Result.success(预约成功); } }这段代码的关键是返回结构Result统一了成功与失败的格式小程序端解析时只需要看code、msg、data三个字段就行。Resource是Spring的注入方式比Autowired在毕设环境下更稳妥不容易出现多个实现类混淆。参数OrderRequest用对象接收而不是散装字段好处是前端传参结构稳定新增字段时不影响接口签名。如果项目里有多个业务模块每个模块一个Controller类名用XxxController结尾答辩翻代码时老师能一眼定位。2.3 为什么是SSM而不是Spring Boot不是情怀是评分点现在企业里Spring Boot是主流但毕业设计选SSM并不吃亏。一是大部分学校的软件工程课程还在教SSM用Spring Boot反而会被质疑是否理解底层组装逻辑二是SSM的配置全在XML里摊开数据源、事务、Mapper扫描都看得见老师在答辩时能顺着配置讲清楚依赖关系这是天然的讲解素材三是SSM项目打war包部署在Tomcat里最接近教材里「学生信息管理系统」的教学路径老师复查环境成本低。当然Spring Boot也有优势尤其在自动配置上省事。但结合养老系统这种规模的项目SSM的配置量不过三四个XML文件完全在可控范围内。如果目标只是快速跑起来参考若依这类框架反而把问题复杂化了。实用判断是开会的人是不是吃SSM这套的老教师是的话就顺着他的习惯来分数和心理预期都更稳。3. 本地跑通后端工程Maven、Tomcat、MySQL的半小时配置3.1 数据库最少需要这七张表关系先理清养老系统的业务闭环是管理员添加服务项目 → 家属为老人预约 → 服务人员接单 → 提交服务记录 → 老人在小程序确认。围绕这条链路我建议最少设计七张表多一张冗余、少一张缺闭环表用途核心字段t_user登录用户家属/管理员/服务人员共用id, username, password, rolet_elder老人档案id, user_id, name, age, health_status, contactt_service_item服务项目id, item_name, price, duration, statust_service_order预约订单id, elder_id, item_id, staff_id, order_status, appoint_timet_service_record服务完成记录id, order_id, content, rating, service_timet_health_check健康打卡id, elder_id, blood_pressure, blood_sugar, check_datet_announcement社区公告id, title, content, publish_time这个结构的特点是t_service_order和t_service_record分开因为「预约了但还没服务」和「服务完成」是两个状态后期做评价和统计都依赖这个区分。t_user里用role字段区分三类人不需要三张独立用户表减少登录时的表连接复杂度。老人档案独立成表是必要的因为一个家属账号下可以绑定多位老人这在实际社区场景非常常见。3.2 建表与初始化数据SQL要能保证第二次跑不报错给毕设写SQL有个血泪教训第一次建库成功第二次跑因为外键顺序不对报错。务实的做法是在建表语句前先DROP TABLE IF EXISTS并且后建的从表放在前面先删。初始化数据时至少要塞一个管理员账号、两个服务项目、一条公告否则小程序端没数据可看答辩演示时白屏最尴尬。DROP TABLE IF EXISTS t_service_record; DROP TABLE IF EXISTS t_service_order; DROP TABLE IF EXISTS t_health_check; DROP TABLE IF EXISTS t_service_item; DROP TABLE IF EXISTS t_elder; DROP TABLE IF EXISTS t_announcement; DROP TABLE IF EXISTS t_user; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, role VARCHAR(20) NOT NULL COMMENT admin / staff / family, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); INSERT INTO t_user (username, password, role) VALUES (admin, admin123, admin), (staff01, 123456, staff), (family001, 123456, family);DROP TABLE IF EXISTS的顺序反了会撞外键约束所以从子表往父表删。密码字段留VARCHAR(100)是为了兼容后续加盐加密不要用VARCHAR(20)限制死。role字段我直接写英文枚举值并加COMMENT这样MyBatis查询结果可读也方便答辩时演示不同角色的登录跳转。初始化数据只保证系统能转起来密码明文是开发期妥协正式验收前建议至少把管理员密码改为MD5或BCrypt加密这个细节可以放进第6章提分点。3.3 Spring配置的四个关键片段数据源、事务、Mapper扫描、编码过滤器很多SSM项目跑不起来问题不在代码而在配置文件。最少需要四个Spring相关文件pom.xml、applicationContext.xml、spring-mvc.xml、mybatis-config.xml。最容易踩坑的是数据源连接串写错以及Mapper接口扫描路径漏了。!-- applicationContext.xml 核心片段 -- context:component-scan base-packagecom.department.service/ bean iddataSource classorg.apache.commons.dbcp2.BasicDataSource property namedriverClassName valuecom.mysql.cj.jdbc.Driver/ property nameurl valuejdbc:mysql://localhost:3306/community_care?useSSLfalseamp;characterEncodingutf8amp;serverTimezoneAsia/Shanghai/ property nameusername valueroot/ property namepassword value123456/ /bean bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property namedataSource refdataSource/ property namemapperLocations valueclasspath:mapper/*.xml/ /bean tx:annotation-driven transaction-managertransactionManager/上面的配置里三个点必须注意base-package只扫Service层不让Controller重复装配url里的amp;是XML转义如果不转义Tomcat启动会直接报配置解析错误serverTimezoneAsia/Shanghai是MySQL 8必须带上的否则日期字段读写差八小时老人预约时间显示与真实时间不一致线上答辩时被问起来很难解释。如果你用的数据库是MySQL 5.7驱动类名可以退回到com.mysql.jdbc.DriverMySQL 8必须用com.mysql.cj.jdbc.Driver这两者兼容性差异是数据库连接失败最常见的翻车原因。3.4 打war包部署Tomcat一分钟验证后端是否活着SSM项目在IDEA里配好Tomcat后先在本地启动一次。启动后不要急着开小程序先用浏览器访问一个简单的接口确认后端活着比如http://localhost:8080/community_care/api/announcement/list。如果返回JSON而不是404说明SpringMVC路由和MyBatis查询都通了。mvn clean package -DskipTests # 构建产物位置target/community_care.war # 将war包复制到Tomcat的webapps目录后启动 cp target/community_care.war $TOMCAT_HOME/webapps/ $TOMCAT_HOME/bin/startup.sh首次打war包经常会失败在测试类-DskipTests跳过测试不是偷懒而是很多SSM老项目的测试依赖不完整硬跑反而报错。war包放进webapps后Tomcat会自动解压访问路径是http://localhost:8080/社区应用名/接口路径。这里的关键是应用名的上下文路径决定了小程序端请求地址的前缀前后端联调前必须先确认这个路径不要等小程序页面写完才发现404。后端启动完成后用浏览器或Postman直接调接口体验更直观Postman里可以顺便测一下POST请求的JSON格式方便后续和小程序端的请求参数对齐。4. 小程序端对接后端请求封装、token和联调配置4.1 小程序目录结构别写成一个page里面全塞code微信小程序的页面是四个文件一组wxml/wxss/js/json一开始就做好分包结构后面加功能不痛苦。常见做法是把「养老」相关的核心页面放在主包工具类和API层独立成目录pages/ index/ # 首页公告和服务项目列表 order/ # 预约下单 health/ # 老人健康打卡 profile/ # 我的登录、老人档案入口 utils/ request.js # wx.request 统一封装 api/ service.js # 业务接口路径管理新手最容易犯的错是把接口地址直接写在页面onLoad里后面接口一改要逐页找。把接口路径统一放到api/service.js页面只管调函数改后端地址时只动一个文件。另一个容易被忽略的点是app.json里的pages列表顺序第一项是启动页建议先放首页再放登录页因为家庭用户可能已经登录过直接进首页体验更顺。4.2 请求封装为什么必须统一 wx.requestwx.request底层能力不错但直接在页面里手动拼url、手动拼token会有大量重复代码而且出错位置不集中。统一封装的目的是所有接口自动带请求头、统一处理HTTP 401、统一解析后端返回的Result结构。// utils/request.js const BASE_URL http://localhost:8080/community_care; function request(path, method, data) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL path, method: method, data: data, header: { Content-Type: application/json, token: wx.getStorageSync(token) || }, success(res) { if (res.data.code 401) { // token过期清除本地登录态回到登录页 wx.removeStorageSync(token); wx.navigateTo({ url: /pages/login/login }); reject(res.data); return; } resolve(res.data); }, fail(err) { reject(err); } }); }); } module.exports { request, BASE_URL };BASE_URL放在封装文件顶部小程序真机调试时只需要把这个变量从localhost改成电脑的局域网IP。这里有个容易被忽略的点wx.getStorageSync(token)每次请求读一次本地缓存比在启动时存到全局变量更可靠因为小程序冷启动后全局变量会被重置而缓存不会丢。把code 401的统一处理放在拦截层好处是所有页面都不需要关心登录失效遇到过期自动跳转。Promise包裹是为了让页面层用async/await阅读起来更像同步代码出错时也能用try/catch捕获不用层层回调。4.3 登录与token的完整链路从wx.login到后端换会话微信小程序的登录不是传统账号密码家庭用户首次进入需要 「微信授权 绑定手机号」 两步。标准流程是用wx.login拿到临时code把code发到自建后端的/api/user/login后端通过该code向微信服务器换取openid然后在本地用openid查t_user表。// pages/login/login.js 片段 wx.login({ success: async (res) { const code res.code; const result await request(/api/user/login, POST, { code: code }); if (result.code 0) { wx.setStorageSync(token, result.data.token); wx.setStorageSync(userInfo, result.data.userInfo); wx.switchTab({ url: /pages/index/index }); } } });wx.login生成的code有效期只有五分钟而且只能用一次后端换取openid后必须立刻生成自己的token返回。token可以是一串UUID正式一点的做法是把openid存进Redis并设置过期时间但毕设项目用数据库t_token表也是及格方案。注意小程序端不需要自己维护登录状态只需要记着后端发的token每次请求带上即可所有会话有效性都由后端判断。这个链路是答辩时老师必问的一个点能讲清楚「code换openid、openid不暴露给前端」就证明你理解了小程序登录安全边界。4.4 联调配置三步走域名校验、CORS、局域网IP小程序开发工具默认禁止访问不合法域名本地联调时需要在「详情 → 本地设置」勾选「不校验合法域名」。后端同时要在SpringMVC配置里放开CORS否则浏览器请求会先被OPTIONS预检拦住。最后一步是把手机和电脑连同一个Wi-Fi把BASE_URL的localhost改成电脑IP真机才能抓到数据。!-- spring-mvc.xml 增加跨域支持 -- mvc:cors mvc:mapping path/api/** allowed-origins* allowed-methodsGET,POST,PUT,DELETE allowed-headersContent-Type,token/ /mvc:corsallowed-headers为什么要显式写上token因为跨域访问时自定义请求头会被浏览器标记为「非简单请求」如果后端不声明允许该请求头前端请求根本发不出去。这里path/api/**是必要的范围控制只让接口层支持跨域避免把权限无脑放大。如果你在开发阶段发现请求挂起或返回CORS error优先检查这一段。小程序真机调试还有个玄学问题有些手机对HTTP明文访问有限制本地开发可以用「不校验合法域名」绕开但上线发布时必须用HTTPS备案域名这是微信平台硬规定不是后端能解决的。5. 养老毕设最常见的6个翻车点现象、原因、解法一条条排5.1 后端启动成功但接口访问返回404现象Tomcat正常启动日志没有异常但浏览器访问/api/announcement/list返回404。原因排查顺序很有代表性多半不是代码错误而是SpringMVC拦截路径没匹配上或者web.xml里的DispatcherServlet映射写成了/*也可能是war包上下文路径与预期不一致。解决方法是在spring-mvc.xml确认启用了注解驱动并检查Controller类上是否缺少RestController注解。如果映射正常再看访问地址是否带上了项目上下文路径很多404其实是漏了应用名。5.2 小程序端请求报「无法连接服务器」而不是业务错误现象真机调试时点击登录按钮转圈十秒后提示「请求失败」。原因是手机访问的是localhost而localhost在手机上指向手机自己根本不指向开发电脑。解决把BASE_URL换成电脑的局域网IP并在系统防火墙放行8080端口。开发工具上能跑通真机一定测一遍这个改动答辩现场如果临时要换网络IP会变建议提前准备一个口袋Wi-Fi并固定手机热点的网段这算踩过坑的教训。5.3 MyBatis查出数据但字段全是null现象接口返回的JSON里对象存在但属性都是null。原因Java实体类字段是驼峰命名appointTime数据库字段是下划线命名appoint_timeMyBatis默认映射不对。解决在mybatis-config.xml开启下划线转驼峰配置。这是SSM年代最典型的配置遗漏点十个人里有三个人栽在这里。settings setting namemapUnderscoreToCamelCase valuetrue/ /settingsmapUnderscoreToCamelCase开启后appoint_time自动映射到实体的appointTime属性不需要手写一大堆resultMap。如果只开启后仍有个别字段对不上再去实体字段上单独列表但比例应该很小否则就要回头检查字段名是不是拼写不一致。5.4 控制台中文乱码老人姓名变成问号现象数据库存的是正常中文页面显示全是???。原因请求参数在Tomcat层默认用ISO-8859-1解码小程序端发来的UTF-8中文被转错了。解决方法是加Spring的编码过滤器并把数据库连接characterEncodingutf8同时保证。这两个缺一个都会乱码只看一半是不少人的误区——改了代码但数据库配置没改放上去继续乱。5.5 编译时提示程序包不存在或找不到类现象mvn clean package报「程序包org.mybatis不存在」。原因pom.xml里的依赖坐标没问题但本地Maven仓库没有下载完整或依赖scope配错。解决确认spring-context、spring-webmvc、mybatis-spring、mysql-connector-java四个依赖都写上网络不稳时删掉本地仓库的_remote.repositories后缀文件重新拉取这个操作算是Maven项目通用的后悔药。5.6 评分现场演示时功能正常但后台管理进不去现象小程序端预约、查询都正常但后台Web端登录页刷新后样式丢失。原因后台JSP页面引用的CSS路径写成了相对路径${pageContext.request.contextPath}漏加。解决后台所有静态资源路径用绝对上下文路径引用如果是纯接口模式直接建议演示不依赖后台静态页面用Postman或内置的管理页面即可。这个坑不算技术难度高但答辩现场很丢印象分。6. 答辩前还能补的三个细节注解鉴权、操作日志和统计看板到这一步项目已经能跑通但要拿95分往上就得补评委真正认可的工程细节。第一个细节是给后端接口加统一鉴权。SSM项目最简洁的做法是写一个拦截器在preHandle里校验小程序端传过来的token排除掉登录接口和白名单路径然后在SpringMVC配置文件里注册这个拦截器。这样能保证未登录用户访问不了预约接口而不是只在页面端做跳转这个前后端权限分离的意识很容易评成优秀。第二个细节是操作日志。养老场景里有敏感操作比如修改老人健康档案、删除服务记录这些动作如果什么都没留下评委会觉得系统不上心。一张t_operation_log就能解决操作人、操作类型、业务对象、操作时间、请求参数。把日志切面放在Service层而不是Controller层因为同一个Service方法可能被多个接口调用日志记录在业务层才完整。答辩时能主动说出「删除档案会留痕」比等老师问强很多。第三个细节是给首页加一个统计看板。小程序首页除了公告列表可以用echarts-for-weixin画一个近7天服务预约量的柱状图后端提供聚合查询接口SQL只需count(*) group by date(appoint_time)。评委看到页面里有数据可视化会下意识认为系统有数据分析能力这个印象分是从「能做系统」到「会做系统」的关键一步。实现上不必做复杂维度一个服务量趋势图加一个服务类型占比就足够。这块我最想说的是毕设评分的逻辑不是代码多花哨而是每个功能都能自圆其说。我见过太多小程序页面华丽、但一问「这个字段存在哪张表」就卡壳的案例反过来只要你把表关系、请求链路、权限处理讲成一个闭环分数自然不会低。愿你这份养老项目从跑通到答辩都顺顺利利希望帮到你。本文还有配套的精品资源点击获取