Spring Boot社区健康管理系统开发实战：从数据库设计到远程调试

最近帮学弟学妹看毕业设计被问得最多的就是基于Spring Boot的社区健康管理系统。这类题目看起来是标准的管理系统CRUD但真要把源码包、文档梳理清楚再配合远程调试把项目在自己电脑上跑起来隐藏的小坑多得超乎想象。这篇我就把社区健康管理系统的完整思路、关键实现和实操经验一次说透从需求拆解到数据库设计从前端联调到远程调试尽量让拿到源码的人能少走弯路也让想做类似系统的人有一条清晰的参考路径。先交代一句文章里的代码片段都是简化示例重点是讲清楚思路和坑不是让你直接复制就完事。每个模块我会尽量解释“为什么这么做”毕竟毕业设计答辩的时候老师问得最多的就是“你这个功能为什么用这个方案”。1. 项目概述与需求拆解1.1 系统定位与核心价值社区健康管理系统本质上是一个面向社区卫生服务中心、社区健康服务站等基层医疗机构的Web信息管理系统。它的核心目标不是做大医院的HIS而是解决基层慢病管理、居民健康档案、体检预约随访这些日常业务的信息化问题。举个例子社区居民老张今年55岁有高血压病史需要每季度随访一次。在没有系统的时候社区医生靠Excel表格记录随访数据不仅容易漏人统计“高血压规范管理率”这种指标时要手工翻表格效率很低。有了系统之后老张的健康档案建好了随访计划在数据库里躺着医生登录系统一看“今天需要随访谁”随访结束把血压值、用药情况、生活方式建议录入后台自动生成统计报表。这个价值点很具体写需求分析的时候也特别好展开因为业务场景就摆在你面前。所以这个题目天然适合做毕业设计一方面业务完整从居民端到医护端到管理端都有内容可做另一方面技术难度适中Spring Boot加Vue的常规组合既能展示CRUD基本功又能往文件存储、权限控制、数据统计这些方向延伸做亮点。1.2 角色划分与功能边界在做任何设计之前先把角色边界定清楚否则写着写着就乱。我把这个系统拆成三个核心角色再加一个系统管理员。先说居民端。居民是系统的服务对象他们需要注册登录、维护个人健康档案、在线预约体检、查看自己的体检报告。这里有个细节居民个人档案的数据来源是建档表格包含姓名、性别、出生日期、身份证号、手机号、既往病史、过敏史、慢性病情况、家族病史等。居民端的功能权限是“只能看自己的数据”不能越权查看他人档案。再看医护端。医务人员是系统的主要操作者负责居民档案的建立与更新、体检记录的录入、慢病随访过程记录、预约订单的确认与执行以及健康资讯的发布。医护端的数据权限比居民宽通常可以看到整个辖区范围内的居民信息但也要受角色限制。最后是管理端。管理员负责用户账号管理、角色权限分配、基础数据字典维护比如体检项目、随访方式的码表以及全局的数据统计。管理端一般不操作业务数据更多是“管人”和“看报表”。角色边界明确之后功能模块清单就呼之欲出了。我把核心模块整理成一张表后面设计数据库和接口时基本就按这张表来展开模块居民端医护端管理端健康档案查看、编辑本人档案新建、修改、查询居民档案数据维护与审核体检管理在线预约、查看报告预约确认、录入体检结果体检数据统计慢病随访查看随访记录新增随访记录、查看随访计划随访率统计健康资讯浏览资讯发布资讯审核与管理资讯系统管理修改密码无用户、角色、权限管理统计报表无基础统计全局统计报表1.3 场景延展与用户画像这个系统适合谁如果你是计算机类专业的毕业生尤其是Java技术栈方向的这个题目非常合适。它的业务复杂度刚好卡在一个“内容充实但不至于失控”的位置三个月左右能完成答辩时有故事可讲演示时功能点足够齐全。同时它也适合课程设计阶段想练手Spring Boot完整项目的人。社区健康管理系统的技术点覆盖了Maven构建、MyBatis-Plus持久层、RESTful接口、JWT权限控制、Vue管理后台、文件上传、远程调试等几乎把Java Web开发的常规武器都过了一遍。我在带学弟学妹调试时发现很多人的问题并不是“看不懂代码”而是“不知道怎么组织项目”。看到源码包里有几十个文件夹就懵了。所以接下来我必须先讲清楚技术栈选型和项目结构这是后面一切操作的地基。2. 技术选型与整体架构2.1 Spring Boot版本到底怎么选直接给结论我强烈推荐Spring Boot 2.7.18 JDK 1.8 MySQL 8.0或5.7 MyBatis-Plus Vue2 Element UI。这套组合我帮人调试过很多次是目前社区健康管理系统类项目里最稳、资料最全的搭配。说句掏心窝的话我知道现在Spring Boot 3.x已经出来很久了但毕设场景真不建议为了追新而给自己挖坑。Spring Boot 3.x要求JDK17以上很多同学的电脑上只装了JDK8换版本要改环境变量、改IDE配置中间任何一个细节出错都会让人崩溃。更麻烦的是Spring Boot 3.x里很多旧接口被移除原来的javax包名变成了jakarta网上大量旧博客代码直接复制过来编不过去。毕业设计阶段时间应该花在功能实现上而不是和版本兼容性死磕。MyBatis-Plus也是一个省心选项。它内置了通用Mapper和分页插件单表CRUD几乎不用写SQL能把开发节奏拉快不少。社区健康管理系统的几个核心表比如居民档案、体检记录、随访记录基本都是单表操作为主MyBatis-Plus的QueryWrapper就能覆盖绝大多数查询场景。前端选Vue2加Element UI的理由也很实在Element UI组件全表格、表单、日期选择器、树形控件都有现成封装管理后台开发效率极高。Vue3当然更好但配套的Element Plus有一些组件用法调整网上教程质量参差不齐对于追求“快速出成果”的毕设来说Vue2反而是最不容易出岔子的。2.2 前后端分离架构与项目分层项目采用前后端分离架构。后端只提供RESTful API不负责页面渲染前端用Vue开发开发时通过代理访问后端接口部署时可以将前端打包成静态文件交给后端托管或者单独扔到Nginx上。后端项目内部要严格分层。我见过很多毕设写法的Controller里塞满几百行业务代码能跑是能跑但答辩的时候老师一看代码质量就不太想给你高分。标准做法是这样Controller层只做接收请求、参数校验、调用Service、返回统一响应。Service层业务逻辑中心和事务边界业务判断都写在这里。Mapper层继承MyBatis-Plus的BaseMapper负责数据访问。Entity层与数据库表一一对应的实体类。DTO/VO层接口入参和出参对象避免直接把实体暴露给前端。分层还有一个隐藏好处远程调试的时候逻辑非常清楚。前端传了一个奇怪的参数进来先看Controller入参对不对再看Service里业务判断走的是哪条分支断点定位起来一目了然。如果代码都堆在Controller里断点打起来就是一行一行往下踩效率极低。2.3 Maven构建与依赖清单后端用Maven构建相信大家都知道但有两个细节我要单独强调。第一个是镜像配置。如果不在Maven的settings.xml里配置阿里云镜像第一次拉依赖会慢到怀疑人生尤其是网络环境不太好的时候整个下午都耗在下载依赖上。配置方法也很简单在settings.xml的mirrors节点里加一段mirror配置即可。第二个是依赖版本控制。社区健康管理系统的核心依赖其实不算多spring-boot-starter-web、spring-boot-starter-validation、mybatis-plus-boot-starter、mysql-connector-j、lombok、knife4jSwagger增强版、jwt相关库如果做文件上传还要引入MinIO的SDK。依赖宁缺毋滥不要看到什么功能都往pom.xml里加每加一个依赖就多一分版本冲突的风险。说个我见过的案例有学弟在网上找了一段“整合Redis”的代码照着加了spring-boot-starter-data-redis结果Redis没装启动日志报了一堆连接错误半天没排查出来。其实他的系统根本不需要Redis缓存。毕设项目要控制技术栈复杂度没有明确需求的功能就先不做。3. 数据库模型设计把业务落成表3.1 核心表结构与字段规划数据库是整个系统的地基我习惯按业务实体拆表。社区健康管理系统我拆成了这样几类用户与权限相关表、居民核心档案表、体检记录表、随访记录表、预约表、健康资讯表。给你一张表整体看一下数据表核心字段说明userid, username, password, real_name, phone, role_id, status登录账号表密码加密存储roleid, role_name, role_code角色表居民、医生、管理员residentid, user_id, name, gender, birth_date, id_card, phone, blood_type, medical_history, allergy, family_history居民健康档案主表exam_recordid, resident_id, exam_date, height, weight, blood_pressure, blood_sugar, blood_fat, ecg_result, conclusion, doctor_id体检记录表宽表设计follow_upid, resident_id, doctor_id, follow_date, follow_type, blood_pressure, blood_sugar, medication_compliance, advice, next_follow_date慢病随访表appointmentid, resident_id, doctor_id, appoint_date, appoint_type, status, remark预约表状态机articleid, title, summary, content, cover_url, author_id, create_time, view_count健康资讯表先说居民档案表。这个表是核心中的核心身份证号建议加唯一索引因为一个居民只能有一份有效档案。建档的时候会同时创建登录账号所以user表和resident表通过user_id关联。建档时涉及一个事务操作往user表插一条账号再往resident表插一条档案两步必须同时成功所以Service方法上必须加Transactional。再说体检记录表。很多正规系统会拆成“体检批次表”和“体检项目明细表”但对于毕设项目我建议先用宽表设计把身高、体重、血压、血糖、血脂这些常见指标做成独立字段。原因很简单页面展示和统计报表都直接查询这一张表代码量少很多逻辑也更直观。如果你希望答辩时多一个谈资可以再做一张exam_item_detail明细表说明“为了支持项目自定义扩展”但这属于锦上添花不是必选项。3.2 关键状态字段设计思路预约表和随访表里都有状态字段这是很容易被忽略的细节。预约状态我建议这样设计待确认、已确认、已完成、已取消。状态迁移逻辑要写清楚居民提交预约后状态为待确认医护端确认后变成已确认居民到现场完成体检后变成已完成如果因为个人原因取消置为已取消。状态字段用String存代码值比如0、1、2、3在代码里用枚举常量维护不要直接在业务代码里写魔法值。随访表的逻辑更简单但也更加体现“社区健康管理”的特色。随访记录每次生成后要有一个“下次随访日期”。系统里做一个“今日随访提醒”的查询其实就是在follow_up表里查next_follow_date小于等于今天、并且该居民还没有新随访记录的数据。这个需求看起来不难但是写SQL或者Java逻辑的时候要注意日期边界别把“正好今天”漏掉。3.3 初始化数据的重要性有一点我不吐不快很多源码包拿到手数据库导入后直接是空表登录页面输什么账号都进不去。这是初学者最常踩的坑。正确的做法是sql脚本里除了建表语句还要带一份初始化数据管理员账号admin、医生测试账号doctor、居民测试账号resident以及几条居民档案和预约数据。为什么要这样因为演示的时候你需要立刻看到效果而不是现场注册三个角色再慢慢造数据。空系统演示是最尴尬的。另外密码不要明文存储至少用MD5加盐或者BCrypt加密。初始化数据里插入的密码也要是加密后的密文不然登录校验永远通不过。我见过有源码把明文密码写进数据库然后用MD5工具加密比对结果登录总报错排查了半天是加密算法不匹配。4. 核心模块实现与关键代码4.1 登录认证JWT加拦截器简单可靠社区健康管理系统的权限控制我不建议直接上Spring Security理由很简单Spring Security的过滤器链配置对初学者过于复杂一个链配错所有接口全部403排查起来极其痛苦。JWT加拦截器是这个项目里性价比最高的方案。核心思路是用户登录成功后后端生成一个JWT令牌前端把令牌存到localStorage里每次请求在Header里带上Authorization后端写一个拦截器统一校验令牌合法性解析出用户信息和角色放行或者拦截。JWT工具类的关键代码大致长这样Component public class JwtUtil { Value(${jwt.secret}) private String secret; public String generateToken(Long userId, String roleCode) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(roleCode, roleCode) .setExpiration(new Date(System.currentTimeMillis() 7 * 24 * 3600 * 1000L)) .signWith(SignatureAlgorithm.HS256, secret) .compact(); } public Claims parseToken(String token) { return Jwts.parser() .setSigningKey(secret) .parseClaimsJws(token) .getBody(); } }然后写一个HandlerInterceptor实现类在preHandle方法里取出Header中的token解析失败返回401解析成功把userId和roleCode放到request上下文中。注册拦截器时注意排除登录接口、注册接口、资讯查询接口这几个白名单路径。这里有个实操细节经常被问到如果用户修改密码或者被管理员禁用账号旧的JWT还能不能用我的处理方式是在拦截器里先查一次用户状态如果status为禁用就直接拒绝。代价是多一次数据库查询但对这个项目来说完全可接受安全性更有保障。4.2 健康档案模块CRUD里的那些坑健康档案模块看起来是标准CRUD但有几个细节处理不好会被答辩老师放大追问。第一是身份证号唯一校验。新增居民档案时先按身份证号查一下resident表如果存在记录要返回友好提示“该居民已建档”而不是直接插入报主键冲突。第二是居民账号联动。建档时同时创建居民登录账号这一步我用事务处理。为了演示事务效果这里给出Service方法骨架Service public class ResidentServiceImpl implements ResidentService { Autowired private ResidentMapper residentMapper; Autowired private UserMapper userMapper; Override Transactional(rollbackFor Exception.class) public void createResident(ResidentCreateDTO dto) { // 1. 校验身份证唯一 Integer count residentMapper.selectCount( new LambdaQueryWrapperResident() .eq(Resident::getIdCard, dto.getIdCard())); if (count 0) { throw new BizException(该居民已建档); } // 2. 创建居民登录账号 User user new User(); user.setUsername(dto.getIdCard()); user.setPassword(passwordEncoder.encode(dto.getPassword())); user.setRoleCode(RESIDENT); userMapper.insert(user); // 3. 创建居民档案 Resident resident new Resident(); BeanUtils.copyProperties(dto, resident); resident.setUserId(user.getId()); residentMapper.insert(resident); } }第三是分页查询。医护端要能按姓名、身份证号、手机号模糊搜索还要能按建档时间范围筛选。MyBatis-Plus的分页插件配置好之后用Page对象加LambdaQueryWrapper就能实现这里不多赘述但分页插件配置漏了的话分页会失效——不报错但返回全量数据这是比较隐蔽的坑。4.3 体检预约与随访提醒的实现路径预约模块的时序是这样居民端提交预约单选择预约日期和预约类型医护端预约列表里看到新单点击确认居民按时间到场医护端录入体检结果居民端在“我的预约”里查看报告PDF或体检指标结论。这里最需要讲清楚的是状态流转。预约状态我用一个枚举在代码里维护public enum AppointmentStatus { PENDING(0, 待确认), CONFIRMED(1, 已确认), COMPLETED(2, 已完成), CANCELLED(3, 已取消); private final String code; private final String desc; // 构造方法、getter省略 }业务处理时医护端确认就执行“待确认改成已确认”录入体检结果时顺手把预约状态改成“已完成”居民端取消则置为“已取消”。每一次状态变更都要校验当前状态是否合法比如已完成状态就不能再取消这种小校验能体现出你考虑问题足够细致。随访提醒的实现相对简单但还是值得单独说一下。查询“今日需随访居民列表”SQL条件的核心就是SELECT r.real_name, f.next_follow_date FROM follow_up f JOIN resident r ON f.resident_id r.id WHERE DATE(f.next_follow_date) CURDATE() AND f.id ( SELECT MAX(f2.id) FROM follow_up f2 WHERE f2.resident_id f.resident_id )这个SQL的核心逻辑是“找到每个居民最近一次随访记录并且下次随访日期已到”。如果同一个居民有多个随访记录要用子查询取最新一条。很多初学者会漏掉这个点导致历史随访记录也被当成“今天要随访”展示出来。4.4 文件上传本地存储还是接MinIO体检报告和健康资讯封面会涉及文件上传。我给两个方案按你的实际情况选。方案一也是我推荐毕设采用的本地磁盘存储。后端配置一个上传路径文件保存到该目录数据库里存文件访问的相对路径再通过一个静态资源映射接口把文件暴露出来。Spring Boot里加一段WebMvcConfigurer配置就能实现Configuration public class WebConfig implements WebMvcConfigurer { Value(${file.upload-dir}) private String uploadDir; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**) .addResourceHandler(/files/**); } }注意啊我这段故意写重复了实际代码只保留一行就行。这也算一个提醒网上代码复制过来看的时候要过脑子别一眼都不看直接贴。方案二如果想给简历加分可以引入MinIO对象存储。MinIO是一个开源的对象存储服务接口兼容Amazon S3部署很简单一条docker命令就能跑起来。接入时后端引入minio依赖配置MinioClient封一个FileStorageService提供upload和getUrl方法。桶名、endpoint、密钥都放application.yml里。但这里有个隐蔽的坑MinIO的访问策略。如果你没有把桶设置为公开读那么通过URL访问文件会返回403。临时解决方法是用presignedGetObject生成带签名的临时访问URL正式做的话要在MinIO控制台配置桶策略。很多人在这个环节卡住明明文件上传成功了前端图片显示不出来。5. 部署与远程调试实战5.1 拿到源码后从0到1跑起来如果你拿到的是一个完整的源码包第一件事一定不要急着改代码。我整理一个固定的启动顺序照着做可以避免百分之八十的环境问题安装JDK8并配置JAVA_HOME命令行输入java -version确认版本。安装Maven 3.6.3以上版本配置阿里云镜像仓库。安装MySQL新建数据库health_community导入项目里的sql文件。如果有Redis相关配置先启动Redis服务没有就跳过。用IDE打开后端项目等待Maven依赖全部下载完修改application.yml里的数据库账号密码。启动后端主类看到“Started Application”字样表示成功。前端项目执行npm install如果下载慢就配置淘宝镜像源。执行npm run dev浏览器访问前端地址验证登录。这里每一步都有“翻车”点但概率最高的是数据库导入。SQL脚本经常因为字符集或排序规则不一致导致导入失败。我的建议是统一使用utf8mb4字符集排序规则用utf8mb4_general_ci。MySQL8默认的utf8mb4_0900_ai_ci是从别的环境导出的SQL脚本里带过来的话会跟你的数据库默认值冲突报一堆“Unknown collation”错误。还有一个容易忽略的点前端npm install在国内网络环境下经常超时。解决方案是设置npm的registry为淘宝镜像然后删除node_modules目录重新安装。我在调试时见过不下十次因为node_modules残留导致前端启动白屏的情况。5.2 远程调试到底是在做什么“远程调试”这个词在毕业设计交付语境里通常指两种情况。第一种是服务商或学长远程帮你把项目跑起来排查环境问题第二种是利用IDEA的远程调试功能让本地代码连接远程服务器上运行中的Java进程实现断点调试。第二种才是技术人员该掌握的姿势。它的原理不复杂JVM支持JPDA调试协议只要启动Java进程时开启调试端口本地IDEA就能以Debug模式连接上去打断点、看变量。我现在把这个操作步骤写清楚第一步服务器上以调试模式启动jar包。命令大致是这样java -jar -Xdebug -Xrunjdwp:transportdt_socket,servery,suspendn,address5005 health-system.jar注意address5005就是调试端口可以按需修改。suspendn的意思是启动时不暂停等待调试连接这样即使没有人连上来程序也能正常运行。第二步确认服务器防火墙放行5005端口。如果是云服务器还要在安全组里增加入方向规则放行该端口。这一步经常被遗漏本地IDEA一直显示“Connection refused”其实是防火墙拦住了。第三步本地IDEA配置Remote JVM Debug。操作路径是Run - Edit Configurations - 左上角加号 - Remote JVM Debug然后填远程服务器IP和端口5005。IDEA会生成一长串JVM参数建议直接复制服务器启动命令中对应的参数保证两端一致。第四步本地代码里被打断点启动调试连接访问远程服务接口断点就会生效。这个技能在真实开发中非常实用尤其是“本地能跑、服务器起不来”的经典场景。远程调试一开服务器端运行时到底是哪一行报错一目了然。5.3 部署方案后端jar包加前端静态文件演示或答辩阶段项目总是要部署到一个稳定的环境里。最简单的方案是用一台Linux服务器后端打成jar包用java -jar方式启动前端npm run build打包成dist目录然后把dist里的静态文件放到Nginx的html目录配置一个反向代理把/api路径转发到后端服务端口。Nginx的关键配置我简单列一下server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html; } location /api/ { proxy_pass http://127.0.0.1:8081/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }注意proxy_pass后面的URL最后要不要带斜杠这个细节很影响转发效果。带斜杠表示把location匹配到的/api前缀替换掉不带斜杠则保留原路径。社区健康管理系统的后端接口如果统一是/api开头通常要带斜杠。6. 常见问题与避坑指南6.1 数据库连接报错集锦数据库相关的报错是毕设阶段第一大类高频问题我按现象整理了一份速查表报错现象常见原因处理方式Communications link failureMySQL服务没启动或端口不是3306命令行确认mysql服务状态Unknown database库名写错或没有执行建库语句创建数据库并导入SQLAccess denied for user账号密码错误或账号不允许当前主机登录检查application.yml配置Unknown collation: utf8mb4_0900_ai_ciSQL脚本排序规则与本地MySQL不兼容替换成utf8mb4_general_ciThe server time zone valueJDBC连接串没设置时区URL加serverTimezoneAsia/Shanghai数据库连接串我通常建议这么写spring: datasource: url: jdbc:mysql://localhost:3306/health_community?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver我这里再加一个容易被忽略的点如果你的MySQL还是5.7驱动类名和8.0有区别。8.0的驱动类是com.mysql.cj.jdbc.Driver5.7是老驱动com.mysql.jdbc.Driver。如果你用Spring Boot 2.7默认的8.0驱动连接MySQL5.7一般是兼容的但反过来就会报错。6.2 前端跨域与代理配置开发环境下前端跑在8080端口后端跑在8081端口浏览器直接请求后端接口会因为跨域被拦截。有两个解决方案后端加CrossOrigin或者前端配置代理。我更推荐前端代理方式。在Vue2项目的vue.config.js里这样配置module.exports { devServer: { port: 8080, proxy: { /api: { target: http://localhost:8081, changeOrigin: true, pathRewrite: { ^/api: } } } } }这样前端请求/api/login的时候开发服务器会把请求自动转发到http://localhost:8081/login浏览器看到的请求地址是同源的不会触发跨域策略。后端就不用到处写CrossOrigin了。pathRewrite这里很多人会配置错。如果后端接口本来就是/login前端请求写成/api/login那代理转发时要把/api前缀重写掉不然后端收到的是/api/login就会报404。如果后端接口本身就是/api/login那pathRewrite可以不加或者直接不重写。6.3 Spring Boot版本太高引发的连锁问题搜索热词里有人问“springboot版本太高”这个我非常有发言权。Spring Boot 3.x和2.x相比不仅仅是JDK版本要求变了很多底层依赖的包名也变了。举个例子Spring Boot 2.x里的javax.servlet到3.x变成了jakarta.servlet。如果你从网上复制一段旧代码里面import的是javax开头在3.x项目里直接编译不过。所以我的建议还是那句话毕设默认用2.7.18。如果导师要求必须用Spring Boot 3.x那你要做好三件事JDK升级到17、所有javax依赖换成jakarta对应版本、MyBatis-Plus要用适配3.x的starter版本。多出来的这些时间成本本来可以用来打磨功能。6.4 时间字段、序列化与更新自动填充实体类里有LocalDateTime类型的字段时后端直接返回JSON给前端可能出现“数组形式的时间”或者格式不对的问题。解决办法是每个时间字段上标注JsonFormat(timezone GMT8, pattern yyyy-MM-dd HH:mm:ss) private LocalDateTime createTime;另外创建时间和更新时间这类字段不要每次插入手动set值。用MyBatis-Plus的自动填充功能更省心TableField(fill FieldFill.INSERT) private LocalDateTime createTime; TableField(fill FieldFill.INSERT_UPDATE) private LocalDateTime updateTime;然后写一个MetaObjectHandler实现类在insertFill和updateFill方法里统一给字段赋值。这样所有新增和修改操作都会带时间字段代码统一、不会漏。6.5 启动失败快速自查清单最后我列一个启动失败自查顺序按照这个顺序排查大多数项目启动问题都能解决端口被占用后端启动报Port already in use换端口或者杀掉占用进程。数据库连不上看日志里有没有Connection拒绝或者数据库相关异常。依赖下载不完整本地仓库里有没有对应jar包有异常就先mvn clean。前端node_modules损坏删除重装不要试图修。配置文件缩进错误YAML对缩进敏感报错一眼能看出来。7. 文档与答辩准备要点7.1 毕业论文的大纲结构怎么搭很多同学代码写得不错论文不知道怎么组织。这里我分享一个直接能用的结构第一章绪论写选题背景、国内外研究现状、研究内容第二章相关技术介绍Spring Boot、MyBatis-Plus、Vue、MySQL以及为什么选它们第三章需求分析写业务流程、角色分析、功能需求、非功能需求第四章系统设计写总体架构、功能模块设计、数据库设计第五章系统实现按核心模块逐个展示核心代码和界面截图第六章系统测试用测试用例表说明功能测试和性能测试最后是总结和致谢。这里最容易被老师挑毛病的是第三章和第四章。需求分析要有用例图或者用例描述数据库设计要附ER图。页面截图要统一浏览器分辨率代码不要贴得过长建议选最关键的方法贴。7.2 演示时的操作顺序建议演示顺序建议按“居民预约 - 医护处理 - 管理员统计”这条业务主线走逻辑非常顺。第一步用居民账号登录打开健康档案页面展示档案信息然后提交一个体检预约。第二步切换医护人员账号登录进入预约管理列表确认刚才的预约再进入随访管理展示今日随访提醒列表录入一条随访记录。第三步切换到管理员账号进入统计报表页面展示随访率、体检完成率等图表。整个演示过程展示三个角色覆盖了系统最主要的业务闭环。我在帮学弟模拟答辩时发现演示过程中最怕出现“数据对不上”的尴尬。比如预约列表是空的或者随访提醒日期都是乱的。所以演示前一定要提前准备好数据库里要有几个居民、几条预约记录、几条随访记录让页面看起来充实。不要用空表演示。7.3 答辩老师爱问的几个技术问题根据我的经验答辩老师对Spring Boot毕设项目常问的问题集中在这几个方向Spring Boot自动装配的原理是什么MyBatis-Plus和MyBatis有什么区别为什么选PlusJWT和Session登录有什么区别各自的优缺点为什么使用前后端分离架构数据库表设计如何保证数据一致性这些问题的答案其实在你做项目的过程中就能沉淀出来前提是每个技术选型都要在脑子里过一遍“为什么”。所以我反复强调文章里的每个“为什么不选另一个方案”不是废话是你答辩时的弹药。关于社区健康管理系统我最后再啰嗦一句做毕设最忌贪多嚼不烂把基础功能做扎实把一两个亮点做出来比堆砌一堆半吊子功能要强得多。我实际调试过太多“功能列表洋洋洒洒跑起来一堆bug”的项目最后都返工重做了。稳扎稳打把居民档案、体检预约、慢病随访这条主线走通你的系统已经比大部分同学完整了。