1. 先拆清楚：家庭医生服务系统到底在做什么
1.1 项目解决的现实问题
说句实在话，家庭医生服务系统这个题目，在Java课设和毕业设计里出现的频率非常高。很多人拿到的第一反应是去网上搜源码，搜到一个SpringBoot+SSM版本的项目，下载、解压、改数据库连接、启动，然后就开始发愁——这项目到底该怎么讲？老师要是问“你这个系统有什么价值”，总不能说“它是个增删改查”。
这个项目核心解决的其实是基层医疗场景下的一个闭环问题：居民签约家庭医生之后，健康管理这件事不能靠纸质档案和微信聊天记录来维持。系统要能支持居民建档、签约、在线咨询、预约随访、慢性病跟踪、用药提醒这些一连串动作。它跟医院挂号平台最大的区别在于，挂号平台解决的是“去哪个医院看”，家庭医生系统解决的是“我的健康长期由谁管、怎么管”。理解了这句话，你答辩和写文档时就有主线了。
1.2 三类用户角色与核心业务流程
家庭医生系统一般不会做成单用户系统，最少要拆成三个端：居民用户端、医生工作端、管理后台端。
居民用户端主要干这些事：注册登录、填写居民健康档案、申请签约某个医生团队、在线发起健康咨询、预约线下随访、查看自己的健康记录和医生回复。
医生工作端是核心，签入签出、查看已签约居民列表、处理咨询消息、安排随访计划、在随访后更新居民的健康档案、给慢性病患者开用药提醒。
管理后台管的是人：医生信息的入驻审核、科室/团队配置、预约规则设置、数据统计看板。业务流程上最典型的一条链路是：居民注册完先建档案，然后选定家庭医生团队发起签约，医生端确认签约，之后居民发起咨询或预约，医生处理并沉淀随访记录，整个链路闭环。
很多同学做的时候只做了居民和医生两端，管理员角色砍掉，结果答辩时评委问“平台怎么管理医生？”就卡住了。哪怕功能做得简单一点，这三个角色也尽量齐活。
1.3 为什么这类项目适合用 Java+SpringBoot+SSM 组合
先纠正一个误区：SpringBoot和SSM不是二选一的对立关系。SSM是Spring、SpringMVC、MyBatis三件套的组合叫法，SpringBoot本质上是Spring生态的快速开发框架，它把Spring、SpringMVC这些配置自动化了。所以“SpringBoot+SSM”比较准确的理解是：基于SpringBoot做基础框架，继承SpringMVC的请求处理模型，持久层用MyBatis操作MySQL。
选这个组合，最大的理由不是“它最先进”，而是“它最适合这种业务型系统”。家庭医生系统的核心是大量业务表之间的关联查询，比如居民、医生、签约、档案、预约，MyBatis手写SQL的灵活度在这一类复杂关联场景下非常舒服。SpringBoot把配置简化了，不用写一堆XML。而且这个技术栈的排查资料在社区里多到爆炸，随便找一个报错信息都有人踩过坑，对课设和毕设阶段的人来说，遇到问题能百度到解决方案，比“技术最酷”重要得多。
2. 技术选型背后的逻辑与关键细节
2.1 SpringBoot 和传统 SSM 的关系怎么理解
为了在答辩时讲清楚，我建议你把下面这个对比背下来：
| 维度 | 传统 SSM 搭建方式 | SpringBoot 集成方式 |
|---|---|---|
| 配置方式 | 大量 XML 配置，需要手写 web.xml、spring.xml、mybatis.xml | 自动装配 + application.yml 少量配置 |
| Web 容器 | 外置 Tomcat，打 war 包部署 | 内嵌 Tomcat，打 jar 包直接运行 |
| 依赖管理 | 手动导入一堆 jar，版本可能冲突 | starter 统一管理依赖版本 |
| MyBatis 集成 | 手动配置 SqlSessionFactory | mybatis-spring-boot-starter 自动装配 |
| 开发效率 | 环境搭建可能耗一天 | 几分钟初始化一个项目 |
答辩时如果老师问“你这个是SSM还是SpringBoot”，你可以回答：底层是SSM那一套，也就是Spring+SpringMVC+MyBatis，但是用SpringBoot做了整合，配置由繁到简，运行时依然是SpringMVC处理HTTP请求、MyBatis做SQL映射，整个项目结构是标准的Web分层架构。这个回答既专业又不会把自己绕进去。
2.2 前端方案：Thymeleaf 还是前后端分离
课设和毕设里，前端到底选什么，很多人纠结。我给你一个实际判断标准：如果项目要求里明确写了“前后端分离”“Vue”，那就老老实实用Vue；如果没写，优先用Thymeleaf模板引擎。
原因很简单，Thymeleaf把前端页面和后端Controller放在同一个工程里，页面直接通过Model传递数据，不需要处理跨域、不需要另起前端工程、不需要担心部署时静态资源路径问题。你自己一个人从头写，省事就是最大的优势。SpringBoot整合Thymeleaf只需要在pom里加一个依赖，再在application.yml里配一下前缀后缀，页面放src/main/resources/templates下，直接就能用。
如果非要选Vue，那建议不要用官方脚手架那一套复杂构建流程，直接在static目录下引入Vue的CDN或者本地js文件，配合axios做接口请求。这种半分离的做法，在课设里反而是最容易跑通的。
2.3 数据库选型与表结构设计
数据库就用MySQL，字符集选utf8mb4，排序规则utf8mb4_general_ci，不然存emoji和生僻字容易出问题。存储引擎InnoDB，支持事务。
核心表我给你列一下，基本上一个家庭医生系统跑不掉这些：
| 表名 | 说明 | 关键字段 |
|---|---|---|
| user | 用户表（居民） | id, username, password, real_name, phone, role |
| doctor | 医生表 | id, user_id, name, dept_id, title, intro |
| dept | 科室/团队表 | id, name, leader_id |
| family_contract | 签约关系表 | id, doctor_id, patient_id, status, start_time, end_time |
| health_record | 居民健康档案表 | id, patient_id, height, weight, blood_type, history, allergy |
| appointment | 预约/随访表 | id, patient_id, doctor_id, time, type, status |
| consultation | 在线咨询表 | id, patient_id, doctor_id, content, reply, status |
| medication_reminder | 用药提醒表 | id, patient_id, medicine_name, dose, remind_time, status |
这里有一个非常关键的细节：签约关系表不是简单挂一个doctor_id就完事。一个家庭医生团队可能管多个居民，一个居民也可能签约了某个团队，所以family_contract表里的状态字段要仔细设计，比如0待确认、1生效中、2已到期、3已解约。预约表的状态也类似，后面我会专门讲状态机。
3. 核心功能模块实现：从接口到页面
3.1 登录鉴权与用户角色控制
登录这块我不建议用太重的Shiro，也不建议用Spring Security，课设阶段一个简单的拦截器加Session完全够用，而且方便讲清楚。
基本做法是：登录接口校验用户名密码，成功后把用户对象写进Session。写一个拦截器类，实现HandlerInterceptor，在preHandle里判断Session里有没有用户，没有就重定向到登录页。然后在SpringBoot的配置类里实现WebMvcConfigurer，把拦截器注册进去，并放行登录接口、静态资源、注册接口。
public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); Object user = session.getAttribute("loginUser"); if (user == null) { // 未登录，重定向到登录页 response.sendRedirect("/login"); return false; } return true; } }注册拦截器的时候，注意放行这些路径，不然页面样式和登录操作全会被拦：
registry.addInterceptor(new LoginInterceptor()) .addPathPatterns("/**") .excludePathPatterns("/login", "/register", "/logout", "/css/**", "/js/**", "/images/**", "/error");角色控制可以在拦截器基础上加一层判断，比如医生端接口要求Session里的用户角色是doctor，管理员接口要求role是admin。不搞复杂的权限框架，把一个注解加自定义拦截器做过去就行，答辩时反而好讲。
3.2 预约与排期的状态机设计
业务里最容易翻车的是预约模块，因为状态多、关系复杂。我建议把预约状态用整数存，代码里定义常量，宁可牺牲一点“可读性”，也要保证数据库存储的统一性。
预约的流转我按这套规矩来：居民提交预约时状态为0（待确认），医生确认后为1（已确认），居民或医生可以取消，取消后为2（已取消），确认后按时到诊并记录完随访，改为3（已完成）。还有一个4（爽约），给那种预约了但没来的人。状态不是随便改的，写完接口后要自己验证一遍：已取消的不能直接改成已完成，未确认的不能跳到已完成。
public class AppointmentStatus { public static final int PENDING = 0; // 待确认 public static final int CONFIRMED = 1; // 已确认 public static final int CANCELED = 2; // 已取消 public static final int COMPLETED = 3; // 已完成 public static final int NO_SHOW = 4; // 爽约 }写预约接口时，一定要做“状态前置校验”，不要只写update。比如医生确认预约，SQL语句建议写成：
UPDATE appointment SET status = 1, confirm_time = #{confirmTime} WHERE id = #{id} AND status = 0这种写法比先select再update更安全，因为在并发情况下，一条语句原子性更新不会出现重复确认的问题。MyBatis里直接写这一条UPDATE，返回受影响行数，如果返回0说明状态不对，提示“该预约已被处理”。
3.3 健康档案与常见病记录
健康档案是最能体现“家庭医生”特色功能的模块。它不只是一张表，我建议拆成两部分：基础档案和随访记录。基础档案在居民注册后第一次填写，随访记录是每次跟进后医生追加的，两者一对多。
基础档案字段建议包含身高、体重、血型、既往病史、过敏史、家族病史、吸烟饮酒情况、医保类型等。随访记录要带时间点和健康评估，比如血压值、血糖值、主诉、当前用药、医生建议。每次随访都追加一条记录，形成居民的健康变化曲线，这是后面做数据统计的数据源。
这里要注意一个细节：档案的展示权限。居民自己可以看自己的档案，医生可以看他签约的所有居民档案，管理员原则上不能看具体医疗内容，只能看统计数字。这个权限控制在接口层实现，虽然麻烦一点，但答辩时是加分项。
3.4 消息通知与用药提醒
用药提醒是家庭医生系统里很有生活场景感的功能，实现起来也不难。核心是用SpringBoot的@Scheduled定时任务，每天扫描medication_reminder表，把当前时间需要提醒且提醒记录还没发的数据捞出来，然后模拟发通知。
@Component public class ReminderTask { @Scheduled(cron = "0 0/5 * * * ?") // 每5分钟执行一次 public void remind() { // 1. 查询到期未提醒的记录 // 2. 生成消息记录 // 3. 标记提醒状态为已发送 } }这里有个坑：@Scheduled默认是单线程串行执行，如果你的项目里有两个定时任务，它们的执行会互相阻塞。加上@EnableScheduling之后，建议在配置里加一个线程池，或者把定时任务搞得简单一点。课设项目一般不会遇到高并发，但万一你后续加了其他定时任务，记住这个坑就行。
通知记录不要直接只写一个“发送成功”，建议建一张message表，把消息内容、接收人、是否已读都存下来。因为页面要展示所有历史通知，没有表支撑就只能做假数据了。
3.5 登录后的数据仪表盘设计
给管理员端加一个数据统计页，把这个项目从“CRUD大礼包”提升到“有一定业务价值”的级别。统计指标主要用SQL聚合：家庭医生签约总数、各科室医生人数、每月预约量、随访完成率、咨询响应平均时长。
图表可以用ECharts，直接在页面里引入echarts.min.js，从后端接口拿JSON数据然后渲染。比如统计“近7天预约量趋势”，后端Controller返回一个日期和数量的Map列表，前端用柱状图展示。不用写复杂的前端框架，一个页面一个图表，妥妥够用。
4. 实操落地：从 idea 创建 SpringBoot 项目开始
4.1 项目初始化的两种方式
不管你是用IDEA还是用网页版，流程都一样。IDEA里选Spring Initializr，注意Server URL选默认的start.spring.io；网页版直接浏览器打开start.spring.io配置。
这里要重点提醒版本匹配问题。很多同学栽在版本上：SpringBoot 3.x要求JDK17，如果你电脑上装的是JDK8，创建项目时一定要把SpringBoot版本降级到2.7.x，同时Java版本选8。SpringBoot 2.x和3.x在API上有不少差异，比如javax.servlet和jakarta.servlet，很多老教程用的是javax，一旦用了Boot3就会报ClassNotFoundException。我的建议是：课设和毕设，统一用SpringBoot 2.7.x + JDK8，踩坑的人少，资料最多，够用且稳定。
依赖方面，勾这几个就够了：Spring Web、MyBatis Framework、MySQL Driver、Thymeleaf。其他如Lombok、Validation按需加，但Lombok加上后如果同学的JDK版本和IDEA版本不匹配会出编译问题，怕麻烦就别加。
4.2 标准目录结构与包分层
创建完项目后，先把包结构建出来，不要把所有类塞在一个包下面。我习惯这样分：
com.example.familydoctor ├── config // 配置类：拦截器注册、跨域配置、定时任务配置 ├── controller // 控制层：接收请求，返回页面或JSON ├── service // 业务层：接口 + impl实现类 ├── mapper // 持久层：MyBatis的Mapper接口 ├── entity // 实体类，对应数据库表 ├── dto // 传输对象：接收前端参数，避免用Map ├── common // 公共类：常量、统一返回结果Result、状态码 ├── task // 定时任务类 └── FamilyDoctorApplication.java // 启动类Controller只做参数接收和结果返回，不要在里面写业务SQL逻辑。Service组合多个Mapper方法。Entity类和数据库表字段要一一对应，如果用了驼峰转下划线配置，字段名也不要乱写。
4.3 关键配置与启动
application.yml是SpringBoot的核心配置文件，不必把每个模块都写在application.properties里。我给一个最小可用配置：
server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/family_doctor?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 123456 thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml configuration: map-underscore-to-camel-case: truemap-underscore-to-camel-case这个配置一定要开，不然数据库字段create_time映射不到实体的createTime，查出来全是null。如果你不喜欢写Mapper XML，也可以在Mapper接口上直接写@Select、@Update注解，但遇到复杂动态SQL时还是XML方便，所以建议保留mapper-locations配置。
启动方式就两种：IDEA里右键运行FamilyDoctorApplication类，或者在项目根目录执行mvn spring-boot:run。如果报错No active profile，说明你的配置文件名不是application.yml或者在resources没放对位置。
4.4 “调试文档”和“讲解视频”怎么看
标题里提到了“调试文档”和“讲解”，这是很多课程设计源码带的材料。拿到之后不要急着从头到尾看视频，先按三步走：
第一步，跑通。改好数据库账号密码，启动项目，把登录、注册、核心业务全点一遍。第二步，断点。在Controller进Service之前打断点，走一遍请求，就知道一个功能从浏览器到SQL的完整链路。第三步，对照文档。把启动步骤、表结构、核心流程和文档对照，标注出哪些页面对应哪些Controller方法。
这样20分钟就能把一套陌生源码啃完，比看两小时不知所云的视频强太多。
5. 常见问题与排查心得
5.1 启动失败：端口占用与版本冲突
启动报port already in use，八成是8080被占用。Windows下命令行执行netstat -ano | findstr 8080，查到PID后taskkill /PID 进程号 /F。如果不想杀进程，可以直接改application.yml里的server.port。还有一个常见情况是Maven仓库里依赖没下载完，IDEA的Maven面板会显示红色。解决办法是右击项目选择Maven → Reload Project，还不行就删掉本地仓库里对应文件夹重新下载。
一个容易被忽视的坑是：MySQL驱动版本和数据库版本不一致。SpringBoot 2.7默认引入mysql-connector-java 8.x，如果你的MySQL是5.x，连接会报SSL异常或Communications link failure。解决方案是显式指定驱动版本，或者降低datasource配置里的driver类名。
5.2 MyBatis 查询不出数据或字段为 null
这个问题的排查路径很固定。先看SQL执行完有没有返回行数，如果SQL在Navicat里查得到，但程序里查不到，先检查mapper的namespace写没写对，再检查resultType和entity的包路径。字段全是null优先检查驼峰配置。还有一种情况，多表联查时返回的字段在业务实体里没有对应属性，建议新建一个VO类，不要硬塞在entity里。
5.3 前端传参和后端接收对不上
页面表单提交常见几种方式：表单urlencoded、ajax JSON、GET参数。如果你用JS的XMLHttpRequest或者axios发送JSON数据，后端接收必须用@RequestBody，把JSON反序列化成实体。如果用表单提交，接收方式就变成了@RequestParam或直接实体类接收。两者混用是收不到参数的重灾区。
日期类型也总出问题。前端传“2025-06-01 10:00:00”给后端的LocalDateTime字段，默认反序列化会报格式错误。在application.yml或Jackson配置里加一段日期格式转换全局生效：
@Bean public Jackson2ObjectMapperBuilderCustomator jacksonCustomizer() { return builder -> builder.simpleDateFormat("yyyy-MM-dd HH:mm:ss"); }5.4 跨域与接口权限问题
用Thymeleaf不用处理跨域，但一旦用了前后端分离，跨域必炸。在后端配置一个CorsFilter或者实现WebMvcConfigurer的addCorsMappings方法即可，注意allowCredentials设为true时allowedOrigins不能用*。权限问题主要出现在静态资源被拦截，比如图片加载不出来，先看拦截器excludePathPatterns有没有把static目录放行。
5.5 数据安全问题别忘提
密码不能明文存，推荐用Spring Security的BCryptPasswordEncoder或者自己写MD5+盐。已过期的加密算法在答辩时要能说清楚为什么加盐：单纯MD5容易被彩虹表反查。SQL注入的预防直接说MyBatis的#{}预编译可以有效防注入，${}存在风险，如果你代码里用到了${}，赶紧换掉。
6. 答辩与项目演示的加分技巧
6.1 演示顺序：按角色讲故事
演示项目不要东点一下西点一下。我推荐的顺序是：先用居民账号注册登录，填健康档案，发起签约；切换到医生端，确认签约，回复咨询；再回到居民端预约随访；最后医生端录随访记录，更新档案。这一套走完，评委已经看懂你的业务闭环了。
每个页面停留5到10秒，说清楚当前页面解决什么问题，不要闷头操作不说话。演示过程中主动抛出设计点，比如“这里预约状态我做了前置校验，防止并发重复确认”，比最后总结十个亮点都管用。
6.2 把“项目亮点”提前埋好
亮点不一定要做成独立的炫酷功能。业务上的用心点同样能加分：健康档案敏感字段做了脱敏展示、预约状态流转是完整的五态、用药提醒用定时任务自动扫描、签约到期前自动提醒续签。这些功能量级不大，但每个都能讲出业务价值。
比较Low的“亮点”是：用了Redis、用了RabbitMQ。评委只要追问一个“你为什么要用Redis”，你就容易露馅。课设阶段用量合适的工具比用重量级框架更能自圆其说。
6.3 常见的答辩追问
我整理几个真题，你提前想好答案：
| 常见追问 | 怎么答 |
|---|---|
| 为什么用SpringBoot不用SSH | SpringBoot简化配置、内嵌容器、生态成熟，底层依然是SpringMVC+MyBatis |
| 预约状态怎么防超卖/重复预约 | 状态前置校验加数据库更新的原子性，同时同一时间段的预约唯一索引 |
| 密码是怎么存的 | BCrypt加盐哈希，未使用明文存储 |
| 项目有哪些可改进的地方 | 引入Redis做会话和缓存、数据库分页优化、基线上线体检报告上传功能 |
| 有哪些难点 | 前端把日期格式统一处理、多表联查时自定义resultMap等真实排坑经历 |
6.4 二次开发扩展方向
如果还有余力，我建议把项目往“更实用”方向扩展一个点：把PDF版本的体检报告上传功能加上去，用文件上传接口存到本地上传目录，健康档案页面里关联文件列表；或者把统计页面做成按月份筛选。这些功能改动小、演示直观，比再写十几个CRUD强。
我自己当年做类似系统时，最亏的一点就是前两周都在调框架版本和模板引擎，真正写业务只用了三天。你要是现在正陷在“项目启动报错”的坑里，我的建议只有一句：先把不相关的高级功能全部砍掉，等登录和一条核心链路跑通，其他模块只是工作量问题，不是技术问题。
