Spring Boot社区康养管理系统：从数据库设计到健康预警全解析

做毕设选题目的时候，不少同学盯着“课程设计/毕业设计”这几个字，以为选一个后台管理模板改改界面就算完事，结果真正打开别人分享的“基于Spring Boot的社区康养管理系统”源码，才发现里面还藏着一整套老人档案、体检记录、用药提醒、健康评估的流程设计。这类项目最大的特点就是：业务线清晰，数据逻辑完整，技术栈又不会绕到看不懂的程度，对毕设来说是一个性价比极高的选题方向。我前后帮几个学弟学妹调过同款项目，遇到过数据库连不上、分页失效、Redis冲突、答辩现场被老师一个问题问住等各种状况，所以这篇就把这个项目的设计思路、核心模块、数据库建模、实际操作过程以及排坑经验一次性讲透，准备复现或者二次开发的同学可以直接抄作业。

这个系统本质上解决的是社区场景下的“人、健康数据、服务动作”三件事：社区里有哪些老人，他们最近身体状况如何，社区该安排体检、随访、用药提醒还是康养活动。搞清楚这层关系，后面所有表结构和代码逻辑都是围绕它展开的，也正因为核心关系不难，它才适合作为课程设计和毕业设计项目。

1. 先拆清楚这个项目到底在做什么

1.1 为什么“社区康养”是一个被反复选择的高频题目

春招秋招的简历上或者毕设选题库里，基于Spring Boot的社区康养管理系统出现频率极高，这不是没原因的。它踩中了当前社会对养老和健康管理的关注点，选题本身就有现实意义，答辩评审听到题目就能理解你做了什么，不需要花五分钟解释业务背景。

从技术角度说，这个项目具有一个优秀毕设必须具备的“中等复杂度”特征。它不像电商秒杀系统那样需要处理高并发、消息队列、分布式缓存，也不像图书管理系统那样只有几个简单单表CRUD。社区康养管理系统的业务链落在中间层：用户权限、健康档案、体检数据上报、异常指标预警、服务预约、活动报名，这些模块单独看都不难，但组合起来就有完整的前后端交互和数据库关系设计，正好能展示你对Spring Boot全家桶的掌握程度。

还有个实际原因是源码复现成本低。整套系统依赖的主要就是JDK、Maven、MySQL和一个IDE，不涉及第三方付费接口，也不依赖特殊的硬件环境。对大多数宿舍电脑来说，跑起来基本没有压力。

1.2 系统角色与功能模块是怎么划分的

我见过多个版本的这类系统，角色设计上大同小异，通常是三种角色：

• 系统管理员：负责老人档案管理、用户账号管理、活动发布、数据统计查看。
• 健康管理员/护理员：负责录入体检数据、健康随访记录、处理预约和用药提醒。
• 老人或家属端：查看个人健康档案、预约服务、报名活动。

功能模块一般围绕这几块展开：

• 老人健康档案管理：基本信息、既往病史、过敏史、家族病史、紧急联系人。
• 健康体检管理：身高体重、血压、心率、血糖、血脂等数据录入和历次数据查看。
• 健康评估与预警：根据体检数据判断指标是否异常，系统给出提醒。
• 用药提醒管理：药品信息维护、服药计划定时提醒。
• 预约与随访管理：健康管理员发起随访或者老人预约服务，双方都有记录。
• 康养活动管理：发布活动、用户报名、活动签到。
• 数据统计看板：按年龄段、高血压比例、活动参与率等维度做统计图表。

一个完整的社区康养系统，说白了下层是老人信息，中间层是各种健康记录，上层是服务动作和统计反馈。这个三层模型你可以写进系统架构图里，也可以直接作为文档里的业务流程图基础。

2. 核心技术点与数据库建模

2.1 为什么是Spring Boot而不是SSH或者SSM

先回答一个很多同学纠结的问题：现在做Java类毕设，选框架到底选什么。Spring Boot已经是绝对主流，别再回头写Spring MVC加一堆XML配置。Spring Boot的核心价值是自动配置和开箱即用，它把Spring容器配置、数据源配置、Web MVC配置都收敛成一套约定俗成的默认行为，你只需要在pom.xml里加依赖，然后在application.yml里写几行配置，就能起飞。

对于康养管理系统来说，Spring Boot带来的好处特别具体：

• 内嵌Tomcat，打包成jar包后不需要单独部署Web服务器，答辩演示时最省心。
• 自动配置数据源，配合MyBatis-Plus使用后，数据库操作层代码量能减少一半。
• 自带监控指标和参数校验，后续扩展加功能时改造成本低。

这也就解释了为什么你在GitHub或者网盘下载的毕设源码里，十有八九是Spring Boot 2.x。目前看到比较稳妥的版本组合是Spring Boot 2.7.x配合JDK 1.8，少部分用3.x配合JDK 17的，但3.x对老代码兼容性有点坑，我不建议毕设阶段冒险。

2.2 数据库表设计：健康数据怎么存才不乱

数据库设计是这类系统的灵魂。很多下载的源码里自带init.sql或者database.sql脚本，但如果你要自己从零设计，下面这套表结构是最稳妥的模板。

以“老人档案”为根，围绕健康数据做扩展：

• older_patient老人信息表：id、姓名、性别、出生日期、身份证号、联系电话、住址、紧急联系人、既往病史、过敏史、状态。
• health_record健康档案表：id、老人id、建档时间、身高、体重、BMI、血型、既往病史、过敏史。
• health_check体检记录表：id、老人id、体检日期、收缩压、舒张压、心率、空腹血糖、总胆固醇、甘油三酯、低密度脂蛋白、体检机构。
• medication_reminder用药提醒表：id、老人id、药品名称、用法用量、提醒时间、开始日期、结束日期。
• appointment服务预约表：id、老人id、预约类型、预约时间、状态。
• visit_record随访记录表：id、老人id、随访人、随访日期、随访内容。
• activity康养活动表：id、标题、内容、活动时间、地点、名额、报名人数。
• activity_signup报名关系表：id、老人id、活动id、报名时间。
• sys_user系统用户表：id、用户名、密码、姓名、角色、状态。

这里要特别注意，体检数据不要和健康档案混在一张表里。我见过有同学图省事，把每次体检数据都update到老人信息表的血压字段里，结果历史体检记录全部丢失，后续做趋势分析就无从谈起。正确做法是“档案存静态信息，体检存动态记录”，一对多关系必须体现在表设计里。

主键我建议直接用自增id，简单可读，关联查询方便，不要上来就搞雪花算法或者UUID，除非你的系统真的需要分布式场景。

2.3 关键业务逻辑：体检数据预警和健康趋势分析怎么实现

这个系统的业务亮点是体检数据异常预警。现实中社区康养场景，最核心的就是及时发现指标异常并通知家属或健康管理员。代码层面上，这并不复杂，但需要你在Service层做业务判断。

一个典型的血压判断逻辑如下：

public void checkHealthData(HealthCheck check) { if (check.getSystolicPressure() >= 140 || check.getDiastolicPressure() >= 90) { healthAlertService.createAlert(check.getOlderId(), "血压偏高", "收缩压" + check.getSystolicPressure() + "mmHg"); } if (check.getFastingBloodGlucose() >= 7.0) { healthAlertService.createAlert(check.getOlderId(), "空腹血糖偏高", check.getFastingBloodGlucose() + "mmol/L"); } }

实际项目里，预警阈值最好是放在配置表或者枚举类里，而不是散落在代码各处判断条件里。这样后续医学标准调整时，只需要改配置，不用改编译后的代码。另外，预警别只存一条alert记录，要用“预警时间、预警类型、是否处理、处理人、处理结果”字段把全生命周期记录下来，因为答辩时老师很容易问“你这个预警功能除了弹个提示还有后续吗”，如果能说出完整的闭环，会加分不少。

健康趋势分析则是读取该老人最近N次体检记录，把血压、血糖等数据按时间画成折线图。ServiceImpl里先按老人id和时间分组查询，再返回给前端ECharts渲染。核心SQL是：

SELECT DATE_FORMAT(check_date, '%Y-%m-%d') AS checkDate, AVG(systolic_pressure) AS avgSystolic, AVG(diastolic_pressure) AS avgDiastolic FROM health_check WHERE older_id = #{olderId} GROUP BY DATE_FORMAT(check_date, '%Y-%m-%d') ORDER BY checkDate

这类数据聚合查询是体现你SQL功底的加分项。

3. 从环境搭建到功能落地

3.1 环境准备与项目初始化清单

拿到源码后，第一步不是急着改代码，而是把环境对齐。我给学弟学妹排坑的经验就是：环境版本不一致，会让一半的报错看起来莫名其妙。

建议环境版本如下：

项目初始化有两种方式。如果源码已经提供，直接用IDEA的open打开pom.xml，等Maven加载完依赖。如果是自己新建，就去Spring Initializr选依赖：Web、MySQL Driver、MyBatis-Plus（手动加jar包或选MyBatis Framework再自己替换）、Thymeleaf、Lombok。

注意IDEA中Lombok可能带来编译报错，如果你的pom.xml里确实引入了Lombok但运行时提示找不到getter和setter，那么先在本机IDEA安装Lombok插件并启用注解处理器，具体位置是Settings → Build, Execution, Deployment → Compiler → Annotation Processors → Enable annotation processing。

3.2 核心代码结构与关键实现细节

下面结合项目源码结构来说代码实现，典型分包如下：

com.xxx.communityhealth ├── config ├── controller ├── service │ ├── impl ├── mapper ├── entity ├── common │ ├── result │ ├── exception └── utils

用户登录和权限控制是第一个要看明白的地方。部分版本用了Spring Security，部分版本直接用了拦截器加Session。对毕设来说，拦截器方案更容易讲清楚，代码量也更少。核心逻辑是：定义一个LoginInterceptor实现HandlerInterceptor，preHandle里检查Session里有没有user对象，没有就重定向到登录页；再把拦截器注册到WebMvcConfigurer里，并且添加排除路径，比如/login、/register以及静态资源路径。

健康档案管理Controller层通常风格如下：

@Controller @RequestMapping("/health") public class HealthRecordController { @Autowired private HealthRecordService healthRecordService; @GetMapping("/list") public String list(Model model, @RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize) { Page<HealthRecord> page = healthRecordService.queryPage(pageNum, pageSize); model.addAttribute("page", page); return "health/list"; } @PostMapping("/save") public String save(HealthRecord record) { healthRecordService.saveWithCheck(record); return "redirect:/health/list"; } }

这里稍微普及一下分页，因为很多同学在这块容易写错。MyBatis-Plus分页需要单独配置分页插件：

@Configuration public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); PaginationInnerInterceptor pagination = new PaginationInnerInterceptor(DbType.MYSQL); pagination.setMaxLimit(500L); interceptor.addInnerInterceptor(pagination); return interceptor; } }

这个配置属于“不加就分页失效”的经典坑，放在后面排查部分再细讲。

3.3 数据库脚本、源码和万字文档到底怎么配合使用

网盘或者资源站下载的项目压缩包里一般包含三个核心内容：源码文件夹、数据库脚本和文档。有的同学拿到手后，直接拿数据库脚本右键source执行，报了一堆错就开始慌，其实大概率是没看脚本头部的版本说明。

正确顺序是先按需修改数据库脚本。如果你的MySQL是8.0，脚本里如果有ENGINE=InnoDB DEFAULT CHARSET=utf8mb4这类语句，理论上可以兼容5.7和8.0；但若脚本里面出现了lake等字段，就要注意版本。更稳妥的操作是直接用Navicat创建一个新数据库，比如community_health，字符集选utf8mb4，排序规则选utf8mb4_general_ci，再把sql文件运行进去。

随后修改application.yml：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/community_health?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: mapper-locations: classpath:mapper/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

这里url里的参数每一个都有存在意义：useSSL=false是避免MySQL 8.0默认开SSL后的连接警告，serverTimezone是解决时区报错，allowPublicKeyRetrieval=true是解决MySQL 8.0连接时提示Public Key Retrieval not allowed的报错。这三个是我调这个项目时最常帮人补的参数。

万字文档的使用建议是：不要直接打印提交，老师见过太多“同款”文档了。你至少要做三步：把文档里的系统名称替换成你自己的；补充你自己实际运行时的截图，特别是数据库表截图和页面效果图；把原本PDF格式的文档导入Word重新排版。当然，如果你的课程设计有查重要求，该人工润色一部分内容也跑不掉。

4. 实操现场：常见问题与排查记录

4.1 环境类问题：端口占用、Maven依赖和数据库连接故障

端口被占用是这个项目最常见的启动失败原因。打开IDEA控制台如果看到Port 8080 was already in use，别慌，在cmd里执行：

netstat -ano | findstr :8080

找到占用8080的PID后，再执行：

taskkill /PID 进程号 /F

或者更省事的方案，直接改application.yml端口为8081。

Maven依赖下载慢或者直接失败是另一个高频问题。源码里的pom.xml往往因为原始作者用的是中央仓库而下载缓慢。解决办法是在maven的settings.xml里配置阿里云镜像：

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

配置完成后刷新Maven项目，你会发现下载速度提升非常明显。

数据库连接失败时，控制台常见报错有两类：第一类是Access denied for user 'root'@'localhost'，说明用户名或密码不对；第二类是不带明确access denied但有Public Key Retrieval is not allowed，这就是我之前说的url缺少参数导致。把allowPublicKeyRetrieval=true加进去，这类连接问题基本能解决。

4.2 代码类问题：分页失效和总页数始终为1

分页失效是最有鉴别度的问题。很多同学写完分页查询，发现数据确实查出来了，但Page对象总页数一直是1，或者List里装的是全表数据。出现这种情况十有八九是MyBatis-Plus分页插件没有注册，或者说你在网上搜代码的时候只写了new Page<>(pageNum, pageSize)，却没有配置MybatisPlusInterceptor。解决办法就是按照前面小节里的MybatisPlusConfig把拦截器注册上。

Lombok裸奔问题：如果一运行就报java.lang.NoSuchMethodError: com.baomidou.mybatisplus.core.toolkit.CollectionUtils.isNotEmpty之类，或者实体类调getter方法报错，那Lombok插件没生效的味道就很重了。检查IDEA那边是否启用了annotation processing，检查pom里Lombok依赖的scope是否为provided并行排列正确。

前后端数据对不上：有时候你改了一个字段后，前端全是null。这通常是实体类属性名和数据库字段名驼峰映射问题。例如数据库字段是emergency_name，实体类可能是emergencyName，MyBatis-Plus开了驼峰映射后能自动转换，但如果你手动写了resultMap又没配正确，就会查出空值。调试时把mybatis-plus.configuration.log-impl设为StdOutImpl，看SQL输出，就能看清查询出来的列名。

4.3 运行与部署问题：页面加载慢和跨域

项目用的前端是Thymeleaf模板，默认和后端在同一个服务下，不存在跨域问题。但如果把前后端分离了，比如把Vue或React部署在8081端口，后端Spring Boot在8080端口，那就要在后端加跨域配置：

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns("*") .allowedMethods("GET", "POST", "PUT", "DELETE") .allowCredentials(true) .maxAge(3600); } }

页面加载慢这种情况大概率不是代码问题，而是你想访问localhost:8080时IDEA还在冷启动Spring容器。Spring Boot 2.x第一次启动时要做大量自动配置，在普通教学宿舍电脑上耗时10到20秒都很正常。你可以观察控制台输出，如果出现Started xxxApplication in 15.815 seconds就说明启动成功了。

这里还有个小经验：如果你改前端模板后浏览器一直不生效，可能是浏览器缓存了老页面，按Ctrl+F5强制刷新就好。Thymeleaf如果配置了cache，还需要在application.yml里设置spring.thymeleaf.cache=false。

5. 答辩与二次扩展的实操建议

5.1 演示和答辩时最容易翻车的三个细节

项目跑通不是终点，课程设计或答辩现场还有一关要过。我见过好几次翻车场景，基本可以总结为三个细节：

第一，演示前先清空数据库里的测试库表数据，保留两条干净样例数据。展示时从登录开始一步一步走，别直接点开一个记录密集的列表页，数据太多反而显得系统“乱”。

第二，把数据库设计表打印出来或者放在答辩PPT的备用页，老师问“老人和体检记录是什么关系”这类问题的时候，可以直接说“older_patient和health_check是一对多关系，老人表主键是id，体检表用older_id关联”，一句话说清楚远比支支吾吾翻代码要好。

第三，准备好一页纸的“项目技术架构图”。手写也行，图上画出前端模板、Controller、Service、Mapper、MySQL五层结构，标注每个业务模块在哪一层处理，就能应对绝大多数框架类提问。

5.2 低成本扩展方向：从毕设到真正的作品

如果你不满足于仅仅跑通代码，想在答辩环节或者复试简历里加一点亮点，下面几个扩展方向都适合在一个星期内完成：

引入MinIO做健康档案图片存储。原来的老人头像或体检报告附件如果只是存在服务器本地，换成MinIO对象存储后，图片和文档统一走OSS调用，系统结构一下子就从“作业”变成“作品”了。你还能顺理成章在文档里写上“本系统使用MinIO实现轻量级非结构化数据存储”，技术层次会高很多。

用定时任务实现真正的用药提醒。把原来简单的页面提醒升级为@Scheduled(cron = "0 0 8 * * ?")每天八点扫描当天需要服药的用户，然后把待办消息写入消息表。为了验证效果，你可以故意造一条今天需要提醒的测试数据，演示时在首页醒目标红，效果很直观。

补充数据可视化看板。原有系统的统计页面往往只是简单表格，引入ECharts后图表展示社区老人年龄段比例、近三个月血压超标率、活动报名趋势，答辩时这一页会让老师有眼前一亮的感觉。

把用户登录密码做加密改造。源码里很多版本直接明文存密码，虽然方便演示，但被问到安全问题很容易噎住。用加密算法对密码做加密存储，并把改造过程写进文档，属于典型的“低成本高汇报”改动。

5.3 如何应对二次开发时的未知Bug

实话实说，别人分享的源码不可能完全适配你自己的电脑，总会遇到一两个让人头秃的问题。我的建议是遵循三个步骤排查：第一步看控制台异常栈的顶部和最底部，80%的错误在堆栈前半段就说了原因，比如空指针、绑定异常；第二步去查数据库表里字段名和实体属性名是否一致；第三步网络检索时直接搜“Spring Boot + 具体异常关键文字”，不要搜“社区康养系统报错”，大概率能找到同类问题的解决方案。

真遇到完全改不动的报错，还有一个笨但有效的办法：回到项目刚下载时的状态，先别做主分支上的任何修改，在副本上试着一步步改配置文件，每改一步启动一次，定位到底哪一步引入的问题。很多二次开发的坑是自己一次改了好几处地方，出错了不知道是哪个环节导致的，分批改动是最笨也最稳的定位法。

最后说一个我做这个项目时最深刻的体会：社区康养管理系统看着像是一个“普通的CRUD项目”，但它把业务从“信息记录”一步步延伸到“健康预警”和“服务闭环”，这种业务感才是答辩时真正值钱的东西。如果你只是把源码跑通然后呼呼交差，那就浪费了这个题目的价值。顺着本文的思路把数据库关系背下来，把几个核心业务逻辑的代码位置标出来，再挑一个扩展方向实际动手改一改，这个课程设计/毕业设计就不只是扣一个Spring Boot标签，而是真的能说明自己会做项目了。