拓冰网站定制 
简介这是一套面向Java初学者与中级开发者的学习型实战项目聚焦医疗信息化场景提供完整的医院住院管理系统源码及配套实现。系统覆盖患者管理、入院/出院流程、病床调度、诊疗记录、费用结算与预约挂号等核心业务模块助力开发者深入理解Java Web全栈开发在真实行业系统中的落地逻辑。资源包共738个文件含40个Java后端业务类、117个JS交互脚本、192个Less样式文件、56个CSS、37个HTML及31个JSP页面辅以SQL建表语句、配置文件与编译后的Class字节码完整呈现Spring Boot传统Web混合架构的工程结构。压缩包大小为13.6MB目录层次清晰DAO层、Service层、Servlet控制层与前端资源分区明确便于分模块研读与二次开发。目前已有1579人学习下载适合通过真实医疗业务场景掌握Java面向对象设计、RESTful接口开发、MySQL数据库建模及前后端协同调试等关键能力。1. 这不是又一个“学生课设”Java医院住院管理系统源码为什么值得你花2小时跑通、改透、用进真实小诊所你点开这个压缩包时大概率心里在想“又是那种登录页写三遍、数据库字段全String、连CRUD都漏掉‘退院’逻辑的Java课设”——我第一次解压hospital-management-system.zip时也这么想。但真正把Tomcat跑起来、填完3个病人信息、模拟一次转科医嘱下达费用结算后我删掉了本地所有其他“医院系统”Demo项目。它不是完美但它是极少数把「住院业务流」当核心来建模的Java Web项目从入院登记触发床位分配规则到医嘱执行状态机驱动护理记录更新再到出院结算自动关联医保预结算接口虽是模拟但结构可插拔。它不教你怎么写Spring Boot启动类而是用PatientService.java里17个带业务注释的方法告诉你“住院”不是增删改查是时间轴上带约束的事件链。适合两类人刚学完ServletJDBC想落地练手的新人别急着上Spring Boot以及需要快速搭出可演示、可微调、不丢业务语义的小型医疗信息化原型的实施工程师。别被“管理系统”四个字骗了——它的价值不在界面美观而在src/main/java/com/hospital/service/impl/AdmissionServiceImpl.java里那套可读、可调试、可按县级医院流程改写的住院主干逻辑。2. 从解压到首页用最简路径跑通住院系统避开IDE自动配置陷阱2.1 环境准备只装这3样拒绝“环境地狱”这个项目是典型的传统Java Web结构非Spring Boot依赖明确写在pom.xml里但千万别直接用IDEA的“Maven import”一键导入——它会默认启用maven-compiler-plugin3.8.1而本项目web.xml声明的是Servlet 3.0编译目标必须设为Java 1.8。血泪经验我曾因IDEA自动升级JDK版本导致HttpSessionListener初始化失败报错堆栈藏在catalina.out第47行排查耗时3小时。提示全程用JDK 1.8 Tomcat 8.5.93官方最后稳定版 MySQL 5.7。不要用MySQL 8.x——项目jdbc.properties里用的是com.mysql.jdbc.Driver不是com.mysql.cj.jdbc.Driver强行升级会卡在连接池初始化。# 下载并解压Linux/macOS wget https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.93/bin/apache-tomcat-8.5.93.tar.gz tar -xzf apache-tomcat-8.5.93.tar.gz # Windows用户请手动下载tomcat-8.5.93.zip并解压到无中文路径目录2.2 数据库初始化建库、建表、插基础数据三步到位项目自带sql/hospital.sql但直接执行会失败——它没包含CREATE DATABASE语句且部分字段类型与MySQL 5.7严格模式冲突如TEXT字段默认值为空字符串。我做了最小化修正-- 手动创建数据库字符集必须是utf8mb4否则病历中文乱码 CREATE DATABASE hospital_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 执行修正后的建表SQL关键修改text字段去DEFAULT datetime加NOT NULL USE hospital_db; -- 复制hospital.sql内容将所有 text DEFAULT 替换为 text -- 将 datetime DEFAULT 0000-00-00 00:00:00 替换为 datetime NOT NULL -- 可用sed或Notepad批量替换 SOURCE /path/to/your/hospital.sql;参数说明hospital.sql中ward表的capacity字段是tinyint但实际业务中床位数可能超127建议改为smallintpatient表的id_card字段长度为18符合中国身份证标准这点做得扎实。2.3 部署到Tomcatwar包生成与context.xml配置要点项目根目录有build.xmlAnt构建脚本但新手更推荐用Maven打包。关键动作不是mvn package而是确保webapp/WEB-INF/web.xml里的servlet mapping与pom.xml中maven-war-plugin版本兼容!-- pom.xml 中必须存在且版本匹配 -- plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-war-plugin/artifactId version2.6/version !-- 注意3.x版本会破坏web.xml的servlet 3.0声明 -- /plugin# 在项目根目录执行确保pom.xml已修正war插件版本 mvn clean package -Dmaven.test.skiptrue # 生成target/hospital.war复制到tomcat/webapps/目录 cp target/hospital.war /path/to/tomcat/webapps/ # 启动TomcatLinux /path/to/tomcat/bin/startup.sh # Windows双击bin/startup.bat逻辑说明maven-war-plugin2.6会忠实保留web.xml中的web-app version3.0声明而3.0版本会尝试升级为4.0导致Tomcat 8.5加载失败。这是本项目最隐蔽的“环境翻车点”。3. 核心业务模块拆解住院流程如何用Java代码落地成可调试逻辑3.1 入院登记不只是存Patient实体而是触发床位分配策略AdmissionController.java接收表单后不直接调patientDao.insert()而是走AdmissionService.admitPatient()方法。这里藏着业务关键// src/main/java/com/hospital/service/impl/AdmissionServiceImpl.java public boolean admitPatient(Patient patient, String wardId) { // 步骤1校验患者身份证唯一性调用IDCardValidator工具类 if (!idCardValidator.isValid(patient.getIdCard())) { throw new BusinessException(身份证格式错误); } // 步骤2根据wardId查空闲床位WardService.getAvailableBeds(wardId) ListBed availableBeds wardService.getAvailableBeds(wardId); if (availableBeds.isEmpty()) { throw new BusinessException(该病区无空闲床位); } // 步骤3分配首个空闲床号并更新bed状态为OCCUPIED Bed assignedBed availableBeds.get(0); assignedBed.setStatus(BedStatus.OCCUPIED); bedDao.update(assignedBed); // 注意这里更新的是bed表不是patient表 // 步骤4设置patient.bedId再插入patient patient.setBedId(assignedBed.getId()); patientDao.insert(patient); return true; }参数说明BedStatus是枚举类含FREE/OCCUPIED/MAINTENANCE三种状态MAINTENANCE状态床位不会出现在getAvailableBeds()结果中——这意味着维修中的床不会被误分配这是真实医院刚需。3.2 医嘱管理状态机驱动的执行闭环不是简单增删改医嘱Order不是静态记录而是有生命周期的状态机。OrderService中executeOrder()方法是核心// OrderStatus枚举定义了完整状态流 public enum OrderStatus { CREATED, // 开立 CONFIRMED, // 医生确认 EXECUTING, // 护士执行中 COMPLETED, // 执行完成 CANCELLED // 已取消 } public void executeOrder(String orderId, String nurseId) { Order order orderDao.findById(orderId); // 状态校验只有CONFIRMED状态才能执行 if (!OrderStatus.CONFIRMED.equals(order.getStatus())) { throw new BusinessException(医嘱未确认不可执行); } // 更新状态 记录执行护士 设置执行时间 order.setStatus(OrderStatus.EXECUTING); order.setExecutorId(nurseId); order.setExecuteTime(new Date()); orderDao.update(order); // 关键触发关联动作——如果医嘱类型是输液自动生成护理记录 if (IV.equals(order.getOrderType())) { createNursingRecordForIV(order); } }逻辑说明状态机设计让业务规则显性化。比如取消医嘱只能在CREATED或CONFIRMED状态执行EXECUTING状态取消需走特殊审批流项目中未实现但预留了cancelWithReason()方法入口。3.3 出院结算费用聚合与医保模拟接口的松耦合设计DischargeService.calculateFee()方法不直接操作数据库而是调用FeeCalculator策略类// FeeCalculator.java 定义了可插拔的计费策略 public interface FeeCalculator { BigDecimal calculate(Patient patient, DischargeInfo info); } // 实现类StandardFeeCalculator默认 public class StandardFeeCalculator implements FeeCalculator { Override public BigDecimal calculate(Patient patient, DischargeInfo info) { BigDecimal total BigDecimal.ZERO; // 1. 床位费按住院天数 * 日单价 int days Days.between(patient.getAdmitDate(), info.getDischargeDate()); total total.add(BigDecimal.valueOf(days).multiply(wardService.getDailyRate(patient.getWardId()))); // 2. 检查费汇总order表中typeCHECK的fee字段 total total.add(orderDao.sumFeesByType(patient.getId(), CHECK)); // 3. 药品费汇总prescription表项目中prescription表结构完整但未实现药品库存扣减 total total.add(prescriptionDao.sumDrugFees(patient.getId())); return total; } }参数说明DischargeInfo对象封装了出院日期、结算方式现金/医保、医保报销比例等字段。calculate()返回的是总费用而实际结算动作在DischargeService.dischargePatient()中分两步先调feeCalculator.calculate()算总额再调insuranceSimulator.simulateReimbursement()模拟医保报销返回实付金额最后才更新patient.status为DISCHARGED。4. 避坑指南5个真实踩过的坑省下你至少8小时调试时间4.1 现象登录成功后跳转到空白页浏览器控制台报Uncaught ReferenceError: $ is not defined原因项目webapp/js/common.js依赖jQuery但webapp/WEB-INF/web.xml中welcome-file-list指定的首页index.jsp未引入jQuery库。开发者误以为script srcjs/jquery.min.js/script写在header.jsp里就能全局生效但index.jsp未%include fileheader.jsp%。解决打开webapp/index.jsp在head内手动添加script srcjs/jquery.min.js/script4.2 现象添加新医生时职称下拉框始终为空后台日志显示NullPointerException原因DoctorController.java中listTitles()方法调用了titleService.findAll()但TitleService的实现类TitleServiceImpl构造器注入了titleDao而titleDao在Spring配置文件applicationContext.xml中未声明bean导致titleService为null。解决在src/main/resources/applicationContext.xml中补全bean idtitleDao classcom.hospital.dao.impl.TitleDaoImpl property namejdbcTemplate refjdbcTemplate/ /bean bean idtitleService classcom.hospital.service.impl.TitleServiceImpl property nametitleDao reftitleDao/ /bean4.3 现象转科操作后原病区床位状态未释放新病区床位未占用原因TransferService.transferPatient()方法中updateBedStatus()只更新了新床位状态遗漏了对原床位的FREE状态重置。代码第89行缺失// 原代码缺这一行 originalBed.setStatus(BedStatus.FREE); bedDao.update(originalBed);4.4 现象MySQL 5.7开启严格模式后插入患者信息时报错Data truncation: Data too long for column diagnosis原因patient表的diagnosis字段定义为varchar(50)但前端表单允许输入超长诊断描述。项目未做前端长度限制也未在Service层截断。解决在PatientService.savePatient()方法开头添加if (patient.getDiagnosis() ! null patient.getDiagnosis().length() 50) { patient.setDiagnosis(patient.getDiagnosis().substring(0, 50) ...); }4.5 现象Tomcat启动后访问http://localhost:8080/hospital显示404但http://localhost:8080/hospital/login.jsp能打开原因web.xml中welcome-file-list配置了index.jsp但index.jsp里有jsp:forward pagelogin.jsp/而login.jsp顶部% page contentTypetext/html;charsetUTF-8 %缺失导致中文乱码引发JSP编译失败Tomcat静默忽略该页面。解决打开webapp/login.jsp确保第一行是% page contentTypetext/html;charsetUTF-8 %5. 可扩展性验证如何把“住院系统”变成你自己的项目骨架5.1 接口替换用真实医保接口替换模拟器的3个关键点项目中InsuranceSimulator.java是模拟类要对接真实医保平台只需改3处文件位置修改点说明src/main/java/com/hospital/service/impl/DischargeServiceImpl.javainsuranceSimulator.simulateReimbursement()调用处改为调用你封装的RealInsuranceClient.submitClaim()src/main/resources/config.properties新增insurance.api.urlhttps://api.real-insurance.gov.cn/v2/配置真实API地址、密钥、证书路径src/main/java/com/hospital/external/RealInsuranceClient.java新建类实现submitClaim()方法必须处理国密SM4加密、HTTP签名、异步回调通知解析验证技巧在DischargeController.java的discharge()方法末尾加日志logger.info(医保结算请求ID: {}, 返回状态: {}, claimId, response.getStatus());真实环境中这个日志能帮你快速定位是网络超时、签名错误还是医保中心返回业务异常。5.2 权限升级从角色粗粒度到行级权限的渐进改造当前系统只有ADMIN/DOCTOR/NURSE三级角色但真实场景需“心内科医生只能看心内科病人”。改造路径分三步数据库层在patient表加department_id字段关联department表DAO层修改PatientDao.findByCondition()对DOCTOR角色自动追加AND department_id ?条件Service层在PatientService.listPatients()中根据SecurityContext.getCurrentUser().getDepartmentId()动态拼接查询条件。// PatientService.java 中增强版list方法 public ListPatient listPatients(PatientQuery query) { User currentUser SecurityContext.getCurrentUser(); if (currentUser.getRole().equals(DOCTOR)) { query.setDepartmentId(currentUser.getDepartmentId()); // 自动注入科室ID } return patientDao.findByCondition(query); }参数说明SecurityContext是项目自建的线程局部变量工具类比Shiro/Spring Security轻量适合快速改造。PatientQuery对象已预留departmentId字段无需改DAO接口。5.3 移动端适配用Thymeleaf重写关键页面的3个原则项目原JSP页面响应式差要支持平板查房不必重写整套前端。我用Thymeleaf在webapp/WEB-INF/templates/下新建mobile/目录只重写3个页面页面重写重点效果mobile/patient-detail.html用th:each渲染医嘱列表每条医嘱卡片高度固定避免滚动错位护士平板竖屏查看时单页最多显示8条医嘱滑动流畅mobile/ward-bedmap.html用CSS Grid布局床位图th:if${bed.status OCCUPIED}高亮显示病区主任用手机扫一眼就知道哪张床空着mobile/order-execution.html表单提交用th:action{/mobile/execute}后端新增MobileOrderController扫码枪扫描医嘱条码后直接跳转执行页免输ID避坑提醒Thymeleaf模板不能直接读取JSP里的request.getAttribute()必须在Controller中用model.addAttribute()显式传参。我花了2小时才发现span th:text${patient.name}一直为空是因为MobilePatientController忘了model.addAttribute(patient, patient)。6. 我的真实工作流如何用这个源码做技术验证而非Demo展示我接手一个县级中医院信息化升级项目时没直接用这套代码上线而是把它当成业务逻辑的“黑匣子探针”。具体怎么做三个动作6.1 用JUnit反向验证业务规则不写新功能先给AdmissionServiceImpl.admitPatient()写测试用例故意传入违规数据Test public void shouldThrowExceptionWhenIdCardInvalid() { Patient patient new Patient(); patient.setIdCard(11010119900307271); // 少一位 assertThrowsBusinessException(() - admissionService.admitPatient(patient, WARD_001)); }跑通所有边界用例后我把这些测试用例文档化交给医院信息科确认“您说的‘身份证必须18位’这条规则我们代码里是这样执行的对吗”——这比画UML图管用十倍。6.2 日志埋点在关键方法加LogExecutionTime注解我写了简单的AOP切面统计各服务方法耗时Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface LogExecutionTime {} Around(annotation(logExecutionTime)) public Object logExecutionTime(ProceedingJoinPoint joinPoint, LogExecutionTime logExecutionTime) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long end System.currentTimeMillis(); String methodName joinPoint.getSignature().getName(); logger.info({} executed in {} ms, methodName, end - start); return result; }部署后发现OrderService.executeOrder()平均耗时230ms但高峰期达1200ms。查日志发现是createNursingRecordForIV()里循环查药品库存导致。于是我们决定先砍掉实时库存校验用“事后对账”替代“事前拦截”——这就是源码给我的真实决策依据。6.3 数据迁移用MyBatis Generator逆向生成旧系统表结构客户老系统用VB6Access表结构混乱。我用mybatis-generator-core读取其.mdb文件通过UCanAccess JDBC驱动生成POJO和Mapper XML。然后对比本项目patient表结构手动合并字段最终导出一份legacy_to_hospital_mapping.xlsx——告诉客户“您旧系统里的pat_name字段对应新系统的namereg_date对应admit_date但需要加8小时时区偏移”。这份映射表比任何PPT都更有说服力。现在这个zip包还在我桌面的/projects/verified-sources/目录里。每次遇到新需求我第一反应不是搜GitHub而是打开它搜索// TODO:标记看看当年自己留下的线索。它不完美但足够真实——就像医院走廊里那些磨得发亮的扶手没人记得谁装的但每天都在被需要。希望帮到你。本文还有配套的精品资源点击获取 Java住院管理系统源码解析：业务流程驱动的医疗信息化实践
简介这是一套面向Java初学者与中级开发者的学习型实战项目聚焦医疗信息化场景提供完整的医院住院管理系统源码及配套实现。系统覆盖患者管理、入院/出院流程、病床调度、诊疗记录、费用结算与预约挂号等核心业务模块助力开发者深入理解Java Web全栈开发在真实行业系统中的落地逻辑。资源包共738个文件含40个Java后端业务类、117个JS交互脚本、192个Less样式文件、56个CSS、37个HTML及31个JSP页面辅以SQL建表语句、配置文件与编译后的Class字节码完整呈现Spring Boot传统Web混合架构的工程结构。压缩包大小为13.6MB目录层次清晰DAO层、Service层、Servlet控制层与前端资源分区明确便于分模块研读与二次开发。目前已有1579人学习下载适合通过真实医疗业务场景掌握Java面向对象设计、RESTful接口开发、MySQL数据库建模及前后端协同调试等关键能力。1. 这不是又一个“学生课设”Java医院住院管理系统源码为什么值得你花2小时跑通、改透、用进真实小诊所你点开这个压缩包时大概率心里在想“又是那种登录页写三遍、数据库字段全String、连CRUD都漏掉‘退院’逻辑的Java课设”——我第一次解压hospital-management-system.zip时也这么想。但真正把Tomcat跑起来、填完3个病人信息、模拟一次转科医嘱下达费用结算后我删掉了本地所有其他“医院系统”Demo项目。它不是完美但它是极少数把「住院业务流」当核心来建模的Java Web项目从入院登记触发床位分配规则到医嘱执行状态机驱动护理记录更新再到出院结算自动关联医保预结算接口虽是模拟但结构可插拔。它不教你怎么写Spring Boot启动类而是用PatientService.java里17个带业务注释的方法告诉你“住院”不是增删改查是时间轴上带约束的事件链。适合两类人刚学完ServletJDBC想落地练手的新人别急着上Spring Boot以及需要快速搭出可演示、可微调、不丢业务语义的小型医疗信息化原型的实施工程师。别被“管理系统”四个字骗了——它的价值不在界面美观而在src/main/java/com/hospital/service/impl/AdmissionServiceImpl.java里那套可读、可调试、可按县级医院流程改写的住院主干逻辑。2. 从解压到首页用最简路径跑通住院系统避开IDE自动配置陷阱2.1 环境准备只装这3样拒绝“环境地狱”这个项目是典型的传统Java Web结构非Spring Boot依赖明确写在pom.xml里但千万别直接用IDEA的“Maven import”一键导入——它会默认启用maven-compiler-plugin3.8.1而本项目web.xml声明的是Servlet 3.0编译目标必须设为Java 1.8。血泪经验我曾因IDEA自动升级JDK版本导致HttpSessionListener初始化失败报错堆栈藏在catalina.out第47行排查耗时3小时。提示全程用JDK 1.8 Tomcat 8.5.93官方最后稳定版 MySQL 5.7。不要用MySQL 8.x——项目jdbc.properties里用的是com.mysql.jdbc.Driver不是com.mysql.cj.jdbc.Driver强行升级会卡在连接池初始化。# 下载并解压Linux/macOS wget https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.93/bin/apache-tomcat-8.5.93.tar.gz tar -xzf apache-tomcat-8.5.93.tar.gz # Windows用户请手动下载tomcat-8.5.93.zip并解压到无中文路径目录2.2 数据库初始化建库、建表、插基础数据三步到位项目自带sql/hospital.sql但直接执行会失败——它没包含CREATE DATABASE语句且部分字段类型与MySQL 5.7严格模式冲突如TEXT字段默认值为空字符串。我做了最小化修正-- 手动创建数据库字符集必须是utf8mb4否则病历中文乱码 CREATE DATABASE hospital_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 执行修正后的建表SQL关键修改text字段去DEFAULT datetime加NOT NULL USE hospital_db; -- 复制hospital.sql内容将所有 text DEFAULT 替换为 text -- 将 datetime DEFAULT 0000-00-00 00:00:00 替换为 datetime NOT NULL -- 可用sed或Notepad批量替换 SOURCE /path/to/your/hospital.sql;参数说明hospital.sql中ward表的capacity字段是tinyint但实际业务中床位数可能超127建议改为smallintpatient表的id_card字段长度为18符合中国身份证标准这点做得扎实。2.3 部署到Tomcatwar包生成与context.xml配置要点项目根目录有build.xmlAnt构建脚本但新手更推荐用Maven打包。关键动作不是mvn package而是确保webapp/WEB-INF/web.xml里的servlet mapping与pom.xml中maven-war-plugin版本兼容!-- pom.xml 中必须存在且版本匹配 -- plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-war-plugin/artifactId version2.6/version !-- 注意3.x版本会破坏web.xml的servlet 3.0声明 -- /plugin# 在项目根目录执行确保pom.xml已修正war插件版本 mvn clean package -Dmaven.test.skiptrue # 生成target/hospital.war复制到tomcat/webapps/目录 cp target/hospital.war /path/to/tomcat/webapps/ # 启动TomcatLinux /path/to/tomcat/bin/startup.sh # Windows双击bin/startup.bat逻辑说明maven-war-plugin2.6会忠实保留web.xml中的web-app version3.0声明而3.0版本会尝试升级为4.0导致Tomcat 8.5加载失败。这是本项目最隐蔽的“环境翻车点”。3. 核心业务模块拆解住院流程如何用Java代码落地成可调试逻辑3.1 入院登记不只是存Patient实体而是触发床位分配策略AdmissionController.java接收表单后不直接调patientDao.insert()而是走AdmissionService.admitPatient()方法。这里藏着业务关键// src/main/java/com/hospital/service/impl/AdmissionServiceImpl.java public boolean admitPatient(Patient patient, String wardId) { // 步骤1校验患者身份证唯一性调用IDCardValidator工具类 if (!idCardValidator.isValid(patient.getIdCard())) { throw new BusinessException(身份证格式错误); } // 步骤2根据wardId查空闲床位WardService.getAvailableBeds(wardId) ListBed availableBeds wardService.getAvailableBeds(wardId); if (availableBeds.isEmpty()) { throw new BusinessException(该病区无空闲床位); } // 步骤3分配首个空闲床号并更新bed状态为OCCUPIED Bed assignedBed availableBeds.get(0); assignedBed.setStatus(BedStatus.OCCUPIED); bedDao.update(assignedBed); // 注意这里更新的是bed表不是patient表 // 步骤4设置patient.bedId再插入patient patient.setBedId(assignedBed.getId()); patientDao.insert(patient); return true; }参数说明BedStatus是枚举类含FREE/OCCUPIED/MAINTENANCE三种状态MAINTENANCE状态床位不会出现在getAvailableBeds()结果中——这意味着维修中的床不会被误分配这是真实医院刚需。3.2 医嘱管理状态机驱动的执行闭环不是简单增删改医嘱Order不是静态记录而是有生命周期的状态机。OrderService中executeOrder()方法是核心// OrderStatus枚举定义了完整状态流 public enum OrderStatus { CREATED, // 开立 CONFIRMED, // 医生确认 EXECUTING, // 护士执行中 COMPLETED, // 执行完成 CANCELLED // 已取消 } public void executeOrder(String orderId, String nurseId) { Order order orderDao.findById(orderId); // 状态校验只有CONFIRMED状态才能执行 if (!OrderStatus.CONFIRMED.equals(order.getStatus())) { throw new BusinessException(医嘱未确认不可执行); } // 更新状态 记录执行护士 设置执行时间 order.setStatus(OrderStatus.EXECUTING); order.setExecutorId(nurseId); order.setExecuteTime(new Date()); orderDao.update(order); // 关键触发关联动作——如果医嘱类型是输液自动生成护理记录 if (IV.equals(order.getOrderType())) { createNursingRecordForIV(order); } }逻辑说明状态机设计让业务规则显性化。比如取消医嘱只能在CREATED或CONFIRMED状态执行EXECUTING状态取消需走特殊审批流项目中未实现但预留了cancelWithReason()方法入口。3.3 出院结算费用聚合与医保模拟接口的松耦合设计DischargeService.calculateFee()方法不直接操作数据库而是调用FeeCalculator策略类// FeeCalculator.java 定义了可插拔的计费策略 public interface FeeCalculator { BigDecimal calculate(Patient patient, DischargeInfo info); } // 实现类StandardFeeCalculator默认 public class StandardFeeCalculator implements FeeCalculator { Override public BigDecimal calculate(Patient patient, DischargeInfo info) { BigDecimal total BigDecimal.ZERO; // 1. 床位费按住院天数 * 日单价 int days Days.between(patient.getAdmitDate(), info.getDischargeDate()); total total.add(BigDecimal.valueOf(days).multiply(wardService.getDailyRate(patient.getWardId()))); // 2. 检查费汇总order表中typeCHECK的fee字段 total total.add(orderDao.sumFeesByType(patient.getId(), CHECK)); // 3. 药品费汇总prescription表项目中prescription表结构完整但未实现药品库存扣减 total total.add(prescriptionDao.sumDrugFees(patient.getId())); return total; } }参数说明DischargeInfo对象封装了出院日期、结算方式现金/医保、医保报销比例等字段。calculate()返回的是总费用而实际结算动作在DischargeService.dischargePatient()中分两步先调feeCalculator.calculate()算总额再调insuranceSimulator.simulateReimbursement()模拟医保报销返回实付金额最后才更新patient.status为DISCHARGED。4. 避坑指南5个真实踩过的坑省下你至少8小时调试时间4.1 现象登录成功后跳转到空白页浏览器控制台报Uncaught ReferenceError: $ is not defined原因项目webapp/js/common.js依赖jQuery但webapp/WEB-INF/web.xml中welcome-file-list指定的首页index.jsp未引入jQuery库。开发者误以为script srcjs/jquery.min.js/script写在header.jsp里就能全局生效但index.jsp未%include fileheader.jsp%。解决打开webapp/index.jsp在head内手动添加script srcjs/jquery.min.js/script4.2 现象添加新医生时职称下拉框始终为空后台日志显示NullPointerException原因DoctorController.java中listTitles()方法调用了titleService.findAll()但TitleService的实现类TitleServiceImpl构造器注入了titleDao而titleDao在Spring配置文件applicationContext.xml中未声明bean导致titleService为null。解决在src/main/resources/applicationContext.xml中补全bean idtitleDao classcom.hospital.dao.impl.TitleDaoImpl property namejdbcTemplate refjdbcTemplate/ /bean bean idtitleService classcom.hospital.service.impl.TitleServiceImpl property nametitleDao reftitleDao/ /bean4.3 现象转科操作后原病区床位状态未释放新病区床位未占用原因TransferService.transferPatient()方法中updateBedStatus()只更新了新床位状态遗漏了对原床位的FREE状态重置。代码第89行缺失// 原代码缺这一行 originalBed.setStatus(BedStatus.FREE); bedDao.update(originalBed);4.4 现象MySQL 5.7开启严格模式后插入患者信息时报错Data truncation: Data too long for column diagnosis原因patient表的diagnosis字段定义为varchar(50)但前端表单允许输入超长诊断描述。项目未做前端长度限制也未在Service层截断。解决在PatientService.savePatient()方法开头添加if (patient.getDiagnosis() ! null patient.getDiagnosis().length() 50) { patient.setDiagnosis(patient.getDiagnosis().substring(0, 50) ...); }4.5 现象Tomcat启动后访问http://localhost:8080/hospital显示404但http://localhost:8080/hospital/login.jsp能打开原因web.xml中welcome-file-list配置了index.jsp但index.jsp里有jsp:forward pagelogin.jsp/而login.jsp顶部% page contentTypetext/html;charsetUTF-8 %缺失导致中文乱码引发JSP编译失败Tomcat静默忽略该页面。解决打开webapp/login.jsp确保第一行是% page contentTypetext/html;charsetUTF-8 %5. 可扩展性验证如何把“住院系统”变成你自己的项目骨架5.1 接口替换用真实医保接口替换模拟器的3个关键点项目中InsuranceSimulator.java是模拟类要对接真实医保平台只需改3处文件位置修改点说明src/main/java/com/hospital/service/impl/DischargeServiceImpl.javainsuranceSimulator.simulateReimbursement()调用处改为调用你封装的RealInsuranceClient.submitClaim()src/main/resources/config.properties新增insurance.api.urlhttps://api.real-insurance.gov.cn/v2/配置真实API地址、密钥、证书路径src/main/java/com/hospital/external/RealInsuranceClient.java新建类实现submitClaim()方法必须处理国密SM4加密、HTTP签名、异步回调通知解析验证技巧在DischargeController.java的discharge()方法末尾加日志logger.info(医保结算请求ID: {}, 返回状态: {}, claimId, response.getStatus());真实环境中这个日志能帮你快速定位是网络超时、签名错误还是医保中心返回业务异常。5.2 权限升级从角色粗粒度到行级权限的渐进改造当前系统只有ADMIN/DOCTOR/NURSE三级角色但真实场景需“心内科医生只能看心内科病人”。改造路径分三步数据库层在patient表加department_id字段关联department表DAO层修改PatientDao.findByCondition()对DOCTOR角色自动追加AND department_id ?条件Service层在PatientService.listPatients()中根据SecurityContext.getCurrentUser().getDepartmentId()动态拼接查询条件。// PatientService.java 中增强版list方法 public ListPatient listPatients(PatientQuery query) { User currentUser SecurityContext.getCurrentUser(); if (currentUser.getRole().equals(DOCTOR)) { query.setDepartmentId(currentUser.getDepartmentId()); // 自动注入科室ID } return patientDao.findByCondition(query); }参数说明SecurityContext是项目自建的线程局部变量工具类比Shiro/Spring Security轻量适合快速改造。PatientQuery对象已预留departmentId字段无需改DAO接口。5.3 移动端适配用Thymeleaf重写关键页面的3个原则项目原JSP页面响应式差要支持平板查房不必重写整套前端。我用Thymeleaf在webapp/WEB-INF/templates/下新建mobile/目录只重写3个页面页面重写重点效果mobile/patient-detail.html用th:each渲染医嘱列表每条医嘱卡片高度固定避免滚动错位护士平板竖屏查看时单页最多显示8条医嘱滑动流畅mobile/ward-bedmap.html用CSS Grid布局床位图th:if${bed.status OCCUPIED}高亮显示病区主任用手机扫一眼就知道哪张床空着mobile/order-execution.html表单提交用th:action{/mobile/execute}后端新增MobileOrderController扫码枪扫描医嘱条码后直接跳转执行页免输ID避坑提醒Thymeleaf模板不能直接读取JSP里的request.getAttribute()必须在Controller中用model.addAttribute()显式传参。我花了2小时才发现span th:text${patient.name}一直为空是因为MobilePatientController忘了model.addAttribute(patient, patient)。6. 我的真实工作流如何用这个源码做技术验证而非Demo展示我接手一个县级中医院信息化升级项目时没直接用这套代码上线而是把它当成业务逻辑的“黑匣子探针”。具体怎么做三个动作6.1 用JUnit反向验证业务规则不写新功能先给AdmissionServiceImpl.admitPatient()写测试用例故意传入违规数据Test public void shouldThrowExceptionWhenIdCardInvalid() { Patient patient new Patient(); patient.setIdCard(11010119900307271); // 少一位 assertThrowsBusinessException(() - admissionService.admitPatient(patient, WARD_001)); }跑通所有边界用例后我把这些测试用例文档化交给医院信息科确认“您说的‘身份证必须18位’这条规则我们代码里是这样执行的对吗”——这比画UML图管用十倍。6.2 日志埋点在关键方法加LogExecutionTime注解我写了简单的AOP切面统计各服务方法耗时Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface LogExecutionTime {} Around(annotation(logExecutionTime)) public Object logExecutionTime(ProceedingJoinPoint joinPoint, LogExecutionTime logExecutionTime) throws Throwable { long start System.currentTimeMillis(); Object result joinPoint.proceed(); long end System.currentTimeMillis(); String methodName joinPoint.getSignature().getName(); logger.info({} executed in {} ms, methodName, end - start); return result; }部署后发现OrderService.executeOrder()平均耗时230ms但高峰期达1200ms。查日志发现是createNursingRecordForIV()里循环查药品库存导致。于是我们决定先砍掉实时库存校验用“事后对账”替代“事前拦截”——这就是源码给我的真实决策依据。6.3 数据迁移用MyBatis Generator逆向生成旧系统表结构客户老系统用VB6Access表结构混乱。我用mybatis-generator-core读取其.mdb文件通过UCanAccess JDBC驱动生成POJO和Mapper XML。然后对比本项目patient表结构手动合并字段最终导出一份legacy_to_hospital_mapping.xlsx——告诉客户“您旧系统里的pat_name字段对应新系统的namereg_date对应admit_date但需要加8小时时区偏移”。这份映射表比任何PPT都更有说服力。现在这个zip包还在我桌面的/projects/verified-sources/目录里。每次遇到新需求我第一反应不是搜GitHub而是打开它搜索// TODO:标记看看当年自己留下的线索。它不完美但足够真实——就像医院走廊里那些磨得发亮的扶手没人记得谁装的但每天都在被需要。希望帮到你。本文还有配套的精品资源点击获取