1. 项目概述与核心需求拆解做医疗信息系统的开发其实是一件挺特殊的事。它和做电商、做内容管理完全不一样最大的差别在于——病历数据是受严格监管的敏感数据而且业务链条极长从门诊医生接诊到书写病历、开立医嘱再到护士执行、药房发药、检验检查回报最后到收费结算任何一个环节出问题都会直接影响医疗质量和患者安全。所以当我看到Spring Boot电子病历管理系统这个题目时第一反应是这不仅仅是一个简单的CRUD练习而是涵盖医疗核心业务场景的完整系统设计。通常这类项目在企业里归属于HIS医院信息系统中的EMRElectronic Medical Record电子病历子系统前端医生工作站通过它完成患者病历的创建、编辑、审阅、归档和质控。适合参考这个项目的人群很明确刚学完Spring Boot想找一个完整全栈实践项目的开发者需要做毕业设计或课程设计的在校学生以及刚进入医疗信息化领域、想快速了解业务模型的新人。这个系统解决的核心问题就是——让纸质病历电子化让病历书写从手写改为结构化录入同时提供权限控制、版本留痕和辅助质控能力。从技术角度讲Spring Boot是目前Java后端开发最主流的选择没有之一。它对繁琐的Spring配置做了大量自动化处理内嵌Tomcat、默认提供健康检查和生产级运维端点配合Spring Data JPA或MyBatis都能快速搭建一套可运行的服务。而电子病历系统选择Spring Boot还有一个产业层面的原因医疗信息化系统大多跑在医院内网的独立服务器上需要稳定、易维护、可独立部署Spring Boot打一个jar包扔到服务器上就能跑这种轻量级特性对医院运维非常友好。在功能维度上一个可用的电子病历系统通常至少包含这五块患者管理登记患者基本信息生成住院号/门诊号提供查询与关联操作病历文书管理包括门急诊病历、住院病历、病程记录、出院小结等支持按模板创建、编辑与归档医嘱管理长期医嘱与临时医嘱的新建、作废、停止关联计价与执行状态系统权限与审计基于角色的访问控制RBAC记录谁在什么时间改了什么内容数据统计基础的就诊量、病历完成率、归档率等指标的查询如果做的是毕业设计建议在此基础上再增加一个可视化数据面板展示历日就诊趋势、科室工作量排行等会明显提升项目的完整度和答辩亮点。2. 核心技术栈与整体架构设计2.1 后端技术选型为什么是Spring Boot MyBatis-Plus电子病历系统的技术选型需要考虑数据一致性和开发效率的平衡。我见过不少团队在医疗项目里盲目引入微服务、分布式事务结果把一个门诊病历保存流程拆成四五个服务调用最后光排查问题就花了一周。对于这样一个系统单体应用加模块化设计是完全够用的。后端我推荐这套组合组件选型说明核心框架Spring Boot 2.7.x稳定、社区资料多内嵌Tomcat打jar部署方便ORM框架MyBatis-Plus代码生成效率高内置分页插件避免写大量XML数据库MySQL 8.0支持JSON字段和窗口函数病历内容存储灵活权限方案Spring Security JWT无状态鉴权适合前后端分离架构缓存Redis验证码、token黑名单、高频字典数据缓存接口文档Knife4j基于Swagger的增强文档支持离线文档导出工具库Hutool日期解析、加密、Excel导出等实用工具减少重复代码MyBatis-Plus在简单CRUD场景下能省掉大量重复的Mapper方法自带逻辑删除和乐观锁插件刚好匹配病历系统中记录不能物理删除、修改要留痕的需求。实体类上加TableLogic注解删除操作就自动变成UPDATE这是一个很实用的细节。2.2 数据库设计病历数据怎么建模数据库模型是整个系统的地基医疗项目尤其讲究字段的完整性和溯源能力。核心表可以这样规划patient表患者主索引字段包括姓名、性别、出生日期、证件号、联系电话、血型、药物过敏史。过敏史一定要单独冗余存一份字符串写进病历的时候直接带出来不能靠联查这是从安全角度考虑的医生开处方时第一时间能看到。medical_record表病历文书主表包含患者ID、就诊类型门急诊/住院、就诊科室、主诉、现病史、既往史、体格检查、诊断结果、医生ID、病历状态草稿/提交/归档/驳回。关键点在于每个状态变更都要在record_status_log表中留一条轨迹。medical_record_detail表有些设计把病历大字段单独拆表用record_id关联存放完整的富文本内容。拆表的逻辑是——列表页只需要查主表只有打开详情时才加载大字段能有效减轻数据库IO压力。diagnosis表诊断信息关联ICD-10编码支持一条病历多个诊断需要设置主诊断标记。prescription表 / prescription_item表处方主表和明细表一对多设计明细记录药品名称、规格、单次剂量、频次、途径、天数、数量。sys_user表、sys_role表、sys_user_role表、sys_menu表标准的RBAC四件套。这里特别要强调create_time和update_time字段不要用数据库的DEFAULT CURRENT_TIMESTAMP简单带过。代码里通过MyBatis-Plus的MetaObjectHandler统一填充同时记录操作人。这样出了问题可以明确回答是谁、在什么时间、把这个字段从什么值改成了什么值。2.3 前端技术栈与前后端交互前端建议使用Vue3 Element Plus Pinia Axios。如果不想从零搭建工程可以直接使用现成的后台管理模板比如RuoYi-Vue这种开源脚手架也有不少医疗Demo但直接用模板有一个问题——大量代码不是你写的答辩问答环节容易被问住。我建议是搭好基础工程后核心的业务组件病历编辑器、处方录入、患者列表自己动手写一遍。接口交互走RESTful风格统一返回结构public class ResultT { private Integer code; private String message; private T data; }前端通过Axios拦截器统一处理401跳转和500错误提示请求头携带Authorization字段作为JWT令牌。3. 详细设计核心功能模块如何落地3.1 患者管理模块别小看了这个模块很多人觉得患者管理不就是增删改查嘛很简单的。但在实际医疗业务中患者主索引是有讲究的——同一个患者可能用不同证件号挂过好几次号也可能出生日期填错了。所以患者注册接口一定要加唯一性校验用一个id_card_no phone的组合去匹配已存在的记录查到就提示已存在患者请确认是否复用。在真实项目中还会引入主索引服务做相似度匹配这里先不展开。患者注册页建议校验的字段至少包括姓名不能为空长度2~20出生日期不能晚于当前日期证件号如果填写必须通过正则校验身份证18位或护照等联系方式必须为11位手机号或有效座机号3.2 病历文书管理让医生能写也能改电子病历最大的痛点就是书写效率。老医生的打字速度不一定快但如果让他用鼠标点几百个下拉框他更不乐意。比较务实的方案是——提供可配置的病历模板。比如首次病程记录模板把主诉、现病史、既往史、体格检查等段落排版好医生只需要填写具体内容必要时一键带入患者基本信息和历史诊断。这个模块在技术实现上有一个关键设计就是分段存储。病历正文不能简单存一个超长字符串而是拆成多个段落块每个段落块有独立的标识和排序值。这样做的目的有两个一是后续做病历质控时可以针对现病史这种特定段做内容完整性校验二是支持段落级别的修改留痕而不是整篇文档替换。一段简化版的段落数据存储结构CREATE TABLE record_segment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, record_id BIGINT NOT NULL COMMENT 病历主表ID, segment_key VARCHAR(50) NOT NULL COMMENT 段落标识如chief_complaint, segment_name VARCHAR(100) NOT NULL COMMENT 段落显示名称, content TEXT COMMENT 段落内容, sort_order INT DEFAULT 0, create_by BIGINT, create_time DATETIME, update_by BIGINT, update_time DATETIME );前端富文本编辑器我推荐使用WangEditor或TinyMCE不要再自己封装contenteditable了踩过的坑太多了——光标丢失、粘贴格式混乱、浏览器兼容性问题数都数不过来。WangEditor对Vue的支持相对友好可以在工具栏里只保留医学文书需要的功能加粗、字体、字号、标题、列表、表格、图片上传。3.3 病历审阅与质控这块属于系统的管理后台能力也是能在答辩中体现出业务思考的部分。系统内置两个角色住院医生书写病历和主治医生/科室主任审阅病历。审阅流程走状态机草稿DRAFT→ 提交待审SUBMITTED→ 审阅通过APPROVED→ 归档ARCHIVED审阅不通过则回到DRAFT状态并附带驳回意见状态流转在代码里建议用枚举封装public enum RecordStatus { DRAFT(0, 草稿), SUBMITTED(1, 待审阅), APPROVED(2, 已通过), ARCHIVED(3, 已归档), REJECTED(4, 已驳回); private final Integer code; private final String description; }每次状态变更写入record_status_log保证全链路可追溯。在病历归档之后要禁止再编辑。这一点在Controller层要通过状态校验拦截不能只靠前端隐藏按钮。3.4 医嘱管理数量、频次、剂量都不允许将就医嘱模块是医疗系统里面最容易出问题的地方因为它直接关系到患者用药安全。一个合格的医嘱录入接口至少要包含以下校验单次剂量必须大于0并且剂量单位不能为空频次必须从字典表中选择qd、bid、tid等不允许自由输入天数必须是正整数且不能超过系统限制作废医嘱必须填写作废原因保证用药过程有据可查这里还要说一个细节就是医嘱id和处方id的关系。一张处方可以包含多条医嘱每条医嘱关联到具体药品主数据。药品主数据表要有统一的规格和厂家信息录入时不能允许医生自己造药品。真实系统里药品字典是药房维护的这里简化为管理员后台维护即可。4. 实战编码从零搭建Spring Boot后端核心流程4.1 项目初始化与依赖配置用Spring Initializr或者直接在IDE里创建项目时推荐的Java版本是8或11。不是越新越好——很多医院客户的服务器运行的还是CentOS 7环境预装的JDK可能是1.8如果项目用Java 17的语法到了部署阶段就会发现自己给自己挖了个坑。Java 8 Spring Boot 2.7是稳妥到不能再稳妥的组合。pom.xml核心依赖示例dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.auth0/groupId artifactIdjava-jwt/artifactId version3.19.2/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这里特别提一下Lombok在医疗项目中的使用态度。实体类加上Data确实能少写很多getter/setter但有一个隐患——如果项目后续需要做大量字段级的操作审计IDE的getter和setter方法在断点调试时反而不直观。我的建议是简单DO类用LombokDTO/VO类上手动写构造方法这样日志输出的字段能精确控制。4.2 JWT鉴权与RBAC权限控制Spring Security的配置是整个项目安全性的地基。B站上很多教学视频教你把Spring Security整个关闭然后自己写拦截器这种方案在真实项目中是绝对不推荐的。正确的方式是使用Spring Security的过滤器链通过自定义OncePerRequestFilter解析令牌并把用户信息和权限列表放入SecurityContextHolder。核心配置类片段Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Resource private JwtAuthenticationFilter jwtAuthenticationFilter; Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) .and() .authorizeRequests() .antMatchers(/api/auth/login, /api/auth/captcha).permitAll() .antMatchers(/api/patient/**).hasAnyRole(DOCTOR, NURSE, ADMIN) .antMatchers(/api/medical-record/**).hasRole(DOCTOR) .antMatchers(/api/system/**).hasRole(ADMIN) .anyRequest().authenticated() .and() .exceptionHandling().authenticationEntryPoint(customAuthenticationEntryPoint); http.addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class); } }在前后端分离的架构下关闭CSRF并把会话策略改为STATELESS是必要的。但一定要补齐两件事一是自定义认证入口点返回JSON格式的401响应而不是Spring Security默认的HTML错误页二是配置CORS跨域否则前端请求会被浏览器拦截。4.3 自定义注解实现操作审计电子病历系统对安全审计有天然需求——谁在什么时候访问或修改了病历这些都不能靠自觉记录。用AOP做一个统一操作日志切面比在每个Service方法里手动调用日志工具类优雅得多。切面实现思路Aspect Component public class OperationLogAspect { Before(annotation(operationLog)) public void doBefore(JoinPoint joinPoint, OperationLog operationLog) { // 获取当前登录用户从SecurityContextHolder中取 // 解析Controller方法的请求参数提取患者ID、病历ID等关键业务字段 // 将操作日志写入sys_operation_log表 // 对于敏感操作额外发送到消息队列做异步存储 } }为操作日志加上查询条件操作人、操作时间范围、患者ID、操作类型这部分是病历溯源能力的有力补充。答辩时如果能主动提到这个设计说明对医疗系统的合规性有基本认知比干巴巴说我做了登录功能好太多。4.4 前端核心页面病历录入与患者列表患者列表页使用Element Plus的el-table配合分页组件。后端分页查询使用MyBatis-Plus的Page对象GetMapping(/patient/list) public ResultIPagePatientVO list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, PatientQueryDTO queryDTO) { PagePatient page new Page(pageNum, pageSize); LambdaQueryWrapperPatient wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(queryDTO.getName()), Patient::getName, queryDTO.getName()) .eq(StringUtils.hasText(queryDTO.getIdCardNo()), Patient::getIdCardNo, queryDTO.getIdCardNo()) .orderByDesc(Patient::getCreateTime); IPagePatient patientPage patientService.page(page, wrapper); // 转换为VO返回避免把敏感字段全部暴露给前端 return Result.success(patientPage.convert(patient - patientMapper.toVO(patient))); }病历编辑器页面是开发工作量最大的部分。建议把工具栏配置为粗体、斜体、下划线、字体字号、编号列表、项目符号、表格、插入图片、清除格式。图片上传接口要限制文件类型只接受jpg/png/webp这个校验必须做在后端前端限制一个accept属性挡不住有心的操作。5. 部署、测试与常见问题排查5.1 本地快速启动指南拿到源码之后不要着急改代码先按这个顺序跑起来本地安装MySQL 8.0创建数据库emr_system执行项目内的sql/init.sql脚本在application.yml里修改数据库账号密码注意把时区设置为serverTimezoneAsia/Shanghai启动Redis服务没有Redis环境可以先把验证码相关代码注释掉不影响主流程运行EmrApplication.java的主方法观察控制台日志看到Tomcat started on port(s): 8080后访问后端健康检查接口/actuator/health启动前端工程修改.env文件中的VITE_API_BASE_URL指向http://localhost:8080/api浏览器访问前端地址使用系统内置的管理员账号登录内置管理员账号建议设置为admin / admin123首次登录后强制修改密码——这是我在真实项目里坚持的习惯避免系统交付后弱口令风险。5.2 端口冲突与数据库连接超时端口占用是新手最常遇到的问题。启动时控制台报Port 8080 was already in use解决办法有三种杀掉占用进程Windows下用netstat -ano | findstr 8080找到PID再taskkill /PID或者修改application.yml里的server.port。MySQL连接超时的典型报错是Communications link failure排查思路确认MySQL服务是否启动systemctl status mysqld确认防火墙是否开放3306端口确认url中的serverTimezone参数没有问题用命令行工具试连一下排除代码问题一般来说先用你写在代码里的账号密码在命令行里连一次如果连不上问题基本不在Spring Boot而在MySQL侧。导入SQL失败则要注意MySQL版本差异。如果你本地是5.7版本但SQL脚本里用了JSON类型函数或utf8mb4_0900_ai_ci排序规则就会直接报错。建议统一用MySQL 8.0和项目的数据库版本保持一致。5.3 前后端联调时常见的疑难杂症登录成功后请求依然返回401大概率是JWT没有放进请求头。检查前端的Axios拦截器确认config.headers.Authorization Bearer token的写法后端则确认JwtAuthenticationFilter是否在Security过滤器链中执行。CORS跨域报错确认后端SecurityConfig里配置了CORS源并开启Spring MVC的跨域支持。注意allowCredentials(true)时不能同时设置allowedOrigins(*)这是浏览器的安全策略限制。返回给前端的日期格式是时间戳可以在application.yml中配置spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT85.4 医疗系统特有的注意事项这里有些经验是从真实医疗项目里总结的虽然写的是代码但背后都是业务约束。做电子病历系统不能只管代码能跑更要考虑数据安全与合规。第一敏感字段脱敏。患者信息接口返回前端时身份证号中间8位应该掩码处理比如110***********1234手机号也可以保留前3后4。前端展示时全部使用脱敏值只有获得更高授权或者特定操作如医生打开完整病历才返回完整数据。这个用JsonSerialize自定义脱敏序列化器就能统一实现。第二备份不能省。数据库要启用定时备份任务推荐方案是每天凌晨执行mysqldump保留最近7天的备份文件。真到了数据误操作恢复的那一天你会感谢这个习惯。病历数据的价值远超软件本身这个意识在医疗行业尤其重要。第三权限不能只在前端控制。后端接口必须做二次鉴权。前端只是用户体验问题后端是安全问题。一个用户可以直接跳过UI调用接口所以每个修改、删除、查询接口都要校验当前用户的角色和归属部门。6. 代码优化与答辩亮点6.1 性能优化一张表数量过千万怎么办如果真实医院环境中的病历数量达到千万级就必须考虑分表和索引优化了。按patient_id做哈希取模进行水平分表是一个常见方案比如medical_record_0、medical_record_1……但这个方案的查询逻辑复杂度会明显上升必须通过分库分表中间件处理。对于课程设计或演示项目来说这样一个H2标题的分享内容是了解性的但了解了不去实现也没问题。索引优化则是立刻可以做并且对性能影响非常大的patient表id_card_no字段加唯一索引medical_record表patient_id status加联合索引record_status_log表record_id加普通索引所有逻辑删除字段和其它高频查询条件加普通索引6.2 让代码更好维护的四个习惯第一个习惯是统一响应体。所有Controller返回值都用ResultT包裹不要有的返回Map、有的返回String、有的直接返回实体对象。对接前端的人是谁不重要规范一致比什么都重要。第二个习惯是异常收敛。全局异常处理器统一捕获BusinessException和Exception不要在每个Controller里写try-catch。医疗系统报了异常患者那边就等着一脸懵——所以异常文案要尽量清晰比如该病历已归档禁止编辑而不是系统异常。第三个习惯是参数校验前置。使用Validated配合NotNull、NotBlank、Size注解在DTO层做声明式校验不要在Service里写一连串的if (xxx null)。第四个习惯是日志里不打印敏感数据。身份证号、手机号必须打码后输出toString()方法也不要输出密码字段。这些习惯在代码审查时最容易暴露也是面试官最爱追问的点。6.3 电子病历系统的扩展建议如果时间和精力允许推荐给项目增加这两个方向一是病历质控规则引擎。比如定义一个简单的规则诊断结果填写了但没有对应检查检验记录标记为待完善。规则引擎可以是一组判断逻辑不必上Drools这种重框架但体现了对医疗逻辑的理解。二是数据大屏。用ECharts做一个医院运营驾驶舱展示今日门诊量、病历完成率、科室排行、药占比等指标。前端大屏后端聚合查询接口是很多毕业设计里最抢眼的部分医疗数据的可视化呈现本身就是一个独立的技能点。7. 写在最后这套系统让我学到的三件事做完这个Spring Boot电子病历管理系统后我的感觉是技术上没有特别难的点难的是把业务规则梳理清楚并且让代码结构能持续承接新的需求。三个心得体会分享一下。第一写出能跑的代码和写出能维护的代码是两码事。电子病历这类系统最大的风险不是功能不够多而是改一个字段要连带改七八个文件还没改全。所以在项目初期就花时间把VO、DTO、Entity分层划分清楚接口路径规划合理看起来多花了半天时间后面省下的时间远超过这些。第二医疗系统的开发必须重视留痕。纸质病历时代靠签字电子病历时代靠操作日志和数据版本。日志切面、状态记录表这些基础能力一定要搭好往后的所有功能都依赖这层地基。第三真实的开发流程永远是先理解业务再写代码。做患者列表之前先搞清楚什么是门诊号什么是住院号做医嘱模块之前先明白药品频次的含义。不要拿起代码就写这个习惯无论在哪个行业项目里都适用但医疗领域尤其不能犯。如果手上有这个源码建议不要只停留在能跑起来的程度。找一个真实的业务流程比如患者挂号→医生接诊→书写病历→开立医嘱→护士执行把整条链路的接口和数据流走一遍比单纯堆CRUD接口有用得多。这套系统还可以继续扩展护士工作站、药房管理、费用结算等模块每一个模块都可以独立成章整套做下来你对医院信息系统的理解就已经超过很多只做过后台管理系统的开发者了。 
长河君 · 2026/10/21 5:36:13 · 阅读 1.2k Spring Boot电子病历管理系统设计与实战：从架构到核心模块落地
1. 项目概述与核心需求拆解做医疗信息系统的开发其实是一件挺特殊的事。它和做电商、做内容管理完全不一样最大的差别在于——病历数据是受严格监管的敏感数据而且业务链条极长从门诊医生接诊到书写病历、开立医嘱再到护士执行、药房发药、检验检查回报最后到收费结算任何一个环节出问题都会直接影响医疗质量和患者安全。所以当我看到Spring Boot电子病历管理系统这个题目时第一反应是这不仅仅是一个简单的CRUD练习而是涵盖医疗核心业务场景的完整系统设计。通常这类项目在企业里归属于HIS医院信息系统中的EMRElectronic Medical Record电子病历子系统前端医生工作站通过它完成患者病历的创建、编辑、审阅、归档和质控。适合参考这个项目的人群很明确刚学完Spring Boot想找一个完整全栈实践项目的开发者需要做毕业设计或课程设计的在校学生以及刚进入医疗信息化领域、想快速了解业务模型的新人。这个系统解决的核心问题就是——让纸质病历电子化让病历书写从手写改为结构化录入同时提供权限控制、版本留痕和辅助质控能力。从技术角度讲Spring Boot是目前Java后端开发最主流的选择没有之一。它对繁琐的Spring配置做了大量自动化处理内嵌Tomcat、默认提供健康检查和生产级运维端点配合Spring Data JPA或MyBatis都能快速搭建一套可运行的服务。而电子病历系统选择Spring Boot还有一个产业层面的原因医疗信息化系统大多跑在医院内网的独立服务器上需要稳定、易维护、可独立部署Spring Boot打一个jar包扔到服务器上就能跑这种轻量级特性对医院运维非常友好。在功能维度上一个可用的电子病历系统通常至少包含这五块患者管理登记患者基本信息生成住院号/门诊号提供查询与关联操作病历文书管理包括门急诊病历、住院病历、病程记录、出院小结等支持按模板创建、编辑与归档医嘱管理长期医嘱与临时医嘱的新建、作废、停止关联计价与执行状态系统权限与审计基于角色的访问控制RBAC记录谁在什么时间改了什么内容数据统计基础的就诊量、病历完成率、归档率等指标的查询如果做的是毕业设计建议在此基础上再增加一个可视化数据面板展示历日就诊趋势、科室工作量排行等会明显提升项目的完整度和答辩亮点。2. 核心技术栈与整体架构设计2.1 后端技术选型为什么是Spring Boot MyBatis-Plus电子病历系统的技术选型需要考虑数据一致性和开发效率的平衡。我见过不少团队在医疗项目里盲目引入微服务、分布式事务结果把一个门诊病历保存流程拆成四五个服务调用最后光排查问题就花了一周。对于这样一个系统单体应用加模块化设计是完全够用的。后端我推荐这套组合组件选型说明核心框架Spring Boot 2.7.x稳定、社区资料多内嵌Tomcat打jar部署方便ORM框架MyBatis-Plus代码生成效率高内置分页插件避免写大量XML数据库MySQL 8.0支持JSON字段和窗口函数病历内容存储灵活权限方案Spring Security JWT无状态鉴权适合前后端分离架构缓存Redis验证码、token黑名单、高频字典数据缓存接口文档Knife4j基于Swagger的增强文档支持离线文档导出工具库Hutool日期解析、加密、Excel导出等实用工具减少重复代码MyBatis-Plus在简单CRUD场景下能省掉大量重复的Mapper方法自带逻辑删除和乐观锁插件刚好匹配病历系统中记录不能物理删除、修改要留痕的需求。实体类上加TableLogic注解删除操作就自动变成UPDATE这是一个很实用的细节。2.2 数据库设计病历数据怎么建模数据库模型是整个系统的地基医疗项目尤其讲究字段的完整性和溯源能力。核心表可以这样规划patient表患者主索引字段包括姓名、性别、出生日期、证件号、联系电话、血型、药物过敏史。过敏史一定要单独冗余存一份字符串写进病历的时候直接带出来不能靠联查这是从安全角度考虑的医生开处方时第一时间能看到。medical_record表病历文书主表包含患者ID、就诊类型门急诊/住院、就诊科室、主诉、现病史、既往史、体格检查、诊断结果、医生ID、病历状态草稿/提交/归档/驳回。关键点在于每个状态变更都要在record_status_log表中留一条轨迹。medical_record_detail表有些设计把病历大字段单独拆表用record_id关联存放完整的富文本内容。拆表的逻辑是——列表页只需要查主表只有打开详情时才加载大字段能有效减轻数据库IO压力。diagnosis表诊断信息关联ICD-10编码支持一条病历多个诊断需要设置主诊断标记。prescription表 / prescription_item表处方主表和明细表一对多设计明细记录药品名称、规格、单次剂量、频次、途径、天数、数量。sys_user表、sys_role表、sys_user_role表、sys_menu表标准的RBAC四件套。这里特别要强调create_time和update_time字段不要用数据库的DEFAULT CURRENT_TIMESTAMP简单带过。代码里通过MyBatis-Plus的MetaObjectHandler统一填充同时记录操作人。这样出了问题可以明确回答是谁、在什么时间、把这个字段从什么值改成了什么值。2.3 前端技术栈与前后端交互前端建议使用Vue3 Element Plus Pinia Axios。如果不想从零搭建工程可以直接使用现成的后台管理模板比如RuoYi-Vue这种开源脚手架也有不少医疗Demo但直接用模板有一个问题——大量代码不是你写的答辩问答环节容易被问住。我建议是搭好基础工程后核心的业务组件病历编辑器、处方录入、患者列表自己动手写一遍。接口交互走RESTful风格统一返回结构public class ResultT { private Integer code; private String message; private T data; }前端通过Axios拦截器统一处理401跳转和500错误提示请求头携带Authorization字段作为JWT令牌。3. 详细设计核心功能模块如何落地3.1 患者管理模块别小看了这个模块很多人觉得患者管理不就是增删改查嘛很简单的。但在实际医疗业务中患者主索引是有讲究的——同一个患者可能用不同证件号挂过好几次号也可能出生日期填错了。所以患者注册接口一定要加唯一性校验用一个id_card_no phone的组合去匹配已存在的记录查到就提示已存在患者请确认是否复用。在真实项目中还会引入主索引服务做相似度匹配这里先不展开。患者注册页建议校验的字段至少包括姓名不能为空长度2~20出生日期不能晚于当前日期证件号如果填写必须通过正则校验身份证18位或护照等联系方式必须为11位手机号或有效座机号3.2 病历文书管理让医生能写也能改电子病历最大的痛点就是书写效率。老医生的打字速度不一定快但如果让他用鼠标点几百个下拉框他更不乐意。比较务实的方案是——提供可配置的病历模板。比如首次病程记录模板把主诉、现病史、既往史、体格检查等段落排版好医生只需要填写具体内容必要时一键带入患者基本信息和历史诊断。这个模块在技术实现上有一个关键设计就是分段存储。病历正文不能简单存一个超长字符串而是拆成多个段落块每个段落块有独立的标识和排序值。这样做的目的有两个一是后续做病历质控时可以针对现病史这种特定段做内容完整性校验二是支持段落级别的修改留痕而不是整篇文档替换。一段简化版的段落数据存储结构CREATE TABLE record_segment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, record_id BIGINT NOT NULL COMMENT 病历主表ID, segment_key VARCHAR(50) NOT NULL COMMENT 段落标识如chief_complaint, segment_name VARCHAR(100) NOT NULL COMMENT 段落显示名称, content TEXT COMMENT 段落内容, sort_order INT DEFAULT 0, create_by BIGINT, create_time DATETIME, update_by BIGINT, update_time DATETIME );前端富文本编辑器我推荐使用WangEditor或TinyMCE不要再自己封装contenteditable了踩过的坑太多了——光标丢失、粘贴格式混乱、浏览器兼容性问题数都数不过来。WangEditor对Vue的支持相对友好可以在工具栏里只保留医学文书需要的功能加粗、字体、字号、标题、列表、表格、图片上传。3.3 病历审阅与质控这块属于系统的管理后台能力也是能在答辩中体现出业务思考的部分。系统内置两个角色住院医生书写病历和主治医生/科室主任审阅病历。审阅流程走状态机草稿DRAFT→ 提交待审SUBMITTED→ 审阅通过APPROVED→ 归档ARCHIVED审阅不通过则回到DRAFT状态并附带驳回意见状态流转在代码里建议用枚举封装public enum RecordStatus { DRAFT(0, 草稿), SUBMITTED(1, 待审阅), APPROVED(2, 已通过), ARCHIVED(3, 已归档), REJECTED(4, 已驳回); private final Integer code; private final String description; }每次状态变更写入record_status_log保证全链路可追溯。在病历归档之后要禁止再编辑。这一点在Controller层要通过状态校验拦截不能只靠前端隐藏按钮。3.4 医嘱管理数量、频次、剂量都不允许将就医嘱模块是医疗系统里面最容易出问题的地方因为它直接关系到患者用药安全。一个合格的医嘱录入接口至少要包含以下校验单次剂量必须大于0并且剂量单位不能为空频次必须从字典表中选择qd、bid、tid等不允许自由输入天数必须是正整数且不能超过系统限制作废医嘱必须填写作废原因保证用药过程有据可查这里还要说一个细节就是医嘱id和处方id的关系。一张处方可以包含多条医嘱每条医嘱关联到具体药品主数据。药品主数据表要有统一的规格和厂家信息录入时不能允许医生自己造药品。真实系统里药品字典是药房维护的这里简化为管理员后台维护即可。4. 实战编码从零搭建Spring Boot后端核心流程4.1 项目初始化与依赖配置用Spring Initializr或者直接在IDE里创建项目时推荐的Java版本是8或11。不是越新越好——很多医院客户的服务器运行的还是CentOS 7环境预装的JDK可能是1.8如果项目用Java 17的语法到了部署阶段就会发现自己给自己挖了个坑。Java 8 Spring Boot 2.7是稳妥到不能再稳妥的组合。pom.xml核心依赖示例dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-security/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdcom.auth0/groupId artifactIdjava-jwt/artifactId version3.19.2/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies这里特别提一下Lombok在医疗项目中的使用态度。实体类加上Data确实能少写很多getter/setter但有一个隐患——如果项目后续需要做大量字段级的操作审计IDE的getter和setter方法在断点调试时反而不直观。我的建议是简单DO类用LombokDTO/VO类上手动写构造方法这样日志输出的字段能精确控制。4.2 JWT鉴权与RBAC权限控制Spring Security的配置是整个项目安全性的地基。B站上很多教学视频教你把Spring Security整个关闭然后自己写拦截器这种方案在真实项目中是绝对不推荐的。正确的方式是使用Spring Security的过滤器链通过自定义OncePerRequestFilter解析令牌并把用户信息和权限列表放入SecurityContextHolder。核心配置类片段Configuration EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter { Resource private JwtAuthenticationFilter jwtAuthenticationFilter; Override protected void configure(HttpSecurity http) throws Exception { http.csrf().disable() .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) .and() .authorizeRequests() .antMatchers(/api/auth/login, /api/auth/captcha).permitAll() .antMatchers(/api/patient/**).hasAnyRole(DOCTOR, NURSE, ADMIN) .antMatchers(/api/medical-record/**).hasRole(DOCTOR) .antMatchers(/api/system/**).hasRole(ADMIN) .anyRequest().authenticated() .and() .exceptionHandling().authenticationEntryPoint(customAuthenticationEntryPoint); http.addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class); } }在前后端分离的架构下关闭CSRF并把会话策略改为STATELESS是必要的。但一定要补齐两件事一是自定义认证入口点返回JSON格式的401响应而不是Spring Security默认的HTML错误页二是配置CORS跨域否则前端请求会被浏览器拦截。4.3 自定义注解实现操作审计电子病历系统对安全审计有天然需求——谁在什么时候访问或修改了病历这些都不能靠自觉记录。用AOP做一个统一操作日志切面比在每个Service方法里手动调用日志工具类优雅得多。切面实现思路Aspect Component public class OperationLogAspect { Before(annotation(operationLog)) public void doBefore(JoinPoint joinPoint, OperationLog operationLog) { // 获取当前登录用户从SecurityContextHolder中取 // 解析Controller方法的请求参数提取患者ID、病历ID等关键业务字段 // 将操作日志写入sys_operation_log表 // 对于敏感操作额外发送到消息队列做异步存储 } }为操作日志加上查询条件操作人、操作时间范围、患者ID、操作类型这部分是病历溯源能力的有力补充。答辩时如果能主动提到这个设计说明对医疗系统的合规性有基本认知比干巴巴说我做了登录功能好太多。4.4 前端核心页面病历录入与患者列表患者列表页使用Element Plus的el-table配合分页组件。后端分页查询使用MyBatis-Plus的Page对象GetMapping(/patient/list) public ResultIPagePatientVO list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, PatientQueryDTO queryDTO) { PagePatient page new Page(pageNum, pageSize); LambdaQueryWrapperPatient wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(queryDTO.getName()), Patient::getName, queryDTO.getName()) .eq(StringUtils.hasText(queryDTO.getIdCardNo()), Patient::getIdCardNo, queryDTO.getIdCardNo()) .orderByDesc(Patient::getCreateTime); IPagePatient patientPage patientService.page(page, wrapper); // 转换为VO返回避免把敏感字段全部暴露给前端 return Result.success(patientPage.convert(patient - patientMapper.toVO(patient))); }病历编辑器页面是开发工作量最大的部分。建议把工具栏配置为粗体、斜体、下划线、字体字号、编号列表、项目符号、表格、插入图片、清除格式。图片上传接口要限制文件类型只接受jpg/png/webp这个校验必须做在后端前端限制一个accept属性挡不住有心的操作。5. 部署、测试与常见问题排查5.1 本地快速启动指南拿到源码之后不要着急改代码先按这个顺序跑起来本地安装MySQL 8.0创建数据库emr_system执行项目内的sql/init.sql脚本在application.yml里修改数据库账号密码注意把时区设置为serverTimezoneAsia/Shanghai启动Redis服务没有Redis环境可以先把验证码相关代码注释掉不影响主流程运行EmrApplication.java的主方法观察控制台日志看到Tomcat started on port(s): 8080后访问后端健康检查接口/actuator/health启动前端工程修改.env文件中的VITE_API_BASE_URL指向http://localhost:8080/api浏览器访问前端地址使用系统内置的管理员账号登录内置管理员账号建议设置为admin / admin123首次登录后强制修改密码——这是我在真实项目里坚持的习惯避免系统交付后弱口令风险。5.2 端口冲突与数据库连接超时端口占用是新手最常遇到的问题。启动时控制台报Port 8080 was already in use解决办法有三种杀掉占用进程Windows下用netstat -ano | findstr 8080找到PID再taskkill /PID或者修改application.yml里的server.port。MySQL连接超时的典型报错是Communications link failure排查思路确认MySQL服务是否启动systemctl status mysqld确认防火墙是否开放3306端口确认url中的serverTimezone参数没有问题用命令行工具试连一下排除代码问题一般来说先用你写在代码里的账号密码在命令行里连一次如果连不上问题基本不在Spring Boot而在MySQL侧。导入SQL失败则要注意MySQL版本差异。如果你本地是5.7版本但SQL脚本里用了JSON类型函数或utf8mb4_0900_ai_ci排序规则就会直接报错。建议统一用MySQL 8.0和项目的数据库版本保持一致。5.3 前后端联调时常见的疑难杂症登录成功后请求依然返回401大概率是JWT没有放进请求头。检查前端的Axios拦截器确认config.headers.Authorization Bearer token的写法后端则确认JwtAuthenticationFilter是否在Security过滤器链中执行。CORS跨域报错确认后端SecurityConfig里配置了CORS源并开启Spring MVC的跨域支持。注意allowCredentials(true)时不能同时设置allowedOrigins(*)这是浏览器的安全策略限制。返回给前端的日期格式是时间戳可以在application.yml中配置spring: jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT85.4 医疗系统特有的注意事项这里有些经验是从真实医疗项目里总结的虽然写的是代码但背后都是业务约束。做电子病历系统不能只管代码能跑更要考虑数据安全与合规。第一敏感字段脱敏。患者信息接口返回前端时身份证号中间8位应该掩码处理比如110***********1234手机号也可以保留前3后4。前端展示时全部使用脱敏值只有获得更高授权或者特定操作如医生打开完整病历才返回完整数据。这个用JsonSerialize自定义脱敏序列化器就能统一实现。第二备份不能省。数据库要启用定时备份任务推荐方案是每天凌晨执行mysqldump保留最近7天的备份文件。真到了数据误操作恢复的那一天你会感谢这个习惯。病历数据的价值远超软件本身这个意识在医疗行业尤其重要。第三权限不能只在前端控制。后端接口必须做二次鉴权。前端只是用户体验问题后端是安全问题。一个用户可以直接跳过UI调用接口所以每个修改、删除、查询接口都要校验当前用户的角色和归属部门。6. 代码优化与答辩亮点6.1 性能优化一张表数量过千万怎么办如果真实医院环境中的病历数量达到千万级就必须考虑分表和索引优化了。按patient_id做哈希取模进行水平分表是一个常见方案比如medical_record_0、medical_record_1……但这个方案的查询逻辑复杂度会明显上升必须通过分库分表中间件处理。对于课程设计或演示项目来说这样一个H2标题的分享内容是了解性的但了解了不去实现也没问题。索引优化则是立刻可以做并且对性能影响非常大的patient表id_card_no字段加唯一索引medical_record表patient_id status加联合索引record_status_log表record_id加普通索引所有逻辑删除字段和其它高频查询条件加普通索引6.2 让代码更好维护的四个习惯第一个习惯是统一响应体。所有Controller返回值都用ResultT包裹不要有的返回Map、有的返回String、有的直接返回实体对象。对接前端的人是谁不重要规范一致比什么都重要。第二个习惯是异常收敛。全局异常处理器统一捕获BusinessException和Exception不要在每个Controller里写try-catch。医疗系统报了异常患者那边就等着一脸懵——所以异常文案要尽量清晰比如该病历已归档禁止编辑而不是系统异常。第三个习惯是参数校验前置。使用Validated配合NotNull、NotBlank、Size注解在DTO层做声明式校验不要在Service里写一连串的if (xxx null)。第四个习惯是日志里不打印敏感数据。身份证号、手机号必须打码后输出toString()方法也不要输出密码字段。这些习惯在代码审查时最容易暴露也是面试官最爱追问的点。6.3 电子病历系统的扩展建议如果时间和精力允许推荐给项目增加这两个方向一是病历质控规则引擎。比如定义一个简单的规则诊断结果填写了但没有对应检查检验记录标记为待完善。规则引擎可以是一组判断逻辑不必上Drools这种重框架但体现了对医疗逻辑的理解。二是数据大屏。用ECharts做一个医院运营驾驶舱展示今日门诊量、病历完成率、科室排行、药占比等指标。前端大屏后端聚合查询接口是很多毕业设计里最抢眼的部分医疗数据的可视化呈现本身就是一个独立的技能点。7. 写在最后这套系统让我学到的三件事做完这个Spring Boot电子病历管理系统后我的感觉是技术上没有特别难的点难的是把业务规则梳理清楚并且让代码结构能持续承接新的需求。三个心得体会分享一下。第一写出能跑的代码和写出能维护的代码是两码事。电子病历这类系统最大的风险不是功能不够多而是改一个字段要连带改七八个文件还没改全。所以在项目初期就花时间把VO、DTO、Entity分层划分清楚接口路径规划合理看起来多花了半天时间后面省下的时间远超过这些。第二医疗系统的开发必须重视留痕。纸质病历时代靠签字电子病历时代靠操作日志和数据版本。日志切面、状态记录表这些基础能力一定要搭好往后的所有功能都依赖这层地基。第三真实的开发流程永远是先理解业务再写代码。做患者列表之前先搞清楚什么是门诊号什么是住院号做医嘱模块之前先明白药品频次的含义。不要拿起代码就写这个习惯无论在哪个行业项目里都适用但医疗领域尤其不能犯。如果手上有这个源码建议不要只停留在能跑起来的程度。找一个真实的业务流程比如患者挂号→医生接诊→书写病历→开立医嘱→护士执行把整条链路的接口和数据流走一遍比单纯堆CRUD接口有用得多。这套系统还可以继续扩展护士工作站、药房管理、费用结算等模块每一个模块都可以独立成章整套做下来你对医院信息系统的理解就已经超过很多只做过后台管理系统的开发者了。