简介这是一套基于SpringBoot、Jpa与Thymeleaf开发的Java医院信息管理系统源码面向中小型医疗机构信息化建设需求也适合Java学习者深入理解企业级项目实战。系统整合患者管理、医生排班、药品库存、财务管理、预约挂号、住院管理、权限控制等核心业务模块覆盖医院日常运营的主要流程。压缩包共3973个文件约15.37MB以2982个svg图标、254个scss样式、129个java源码、136个js脚本、56个html页面及100个css文件为主另含sql建表脚本、yml配置与maven构建文件前端资源与后端逻辑分层清晰。目前已有2522人学习下载。读者可从中获得完整的项目目录结构、实体与业务层实现范例、数据库脚本以及前后端整合思路既能作为课程设计或二次开发的起点也便于对照学习SpringBoot与Jpa在实际医疗场景中的落地方式。1. 一套 Java 医院信息管理系统源码到底能拿来干什么如果你手上正躺着一份 Java 医院信息管理系统源码或者正在搜「医院 HIS 源码」想找一套能跑起来、能改、能交付的东西那这篇就是写给你的。HIS 是 Hospital Information System 的缩写落到代码层面它本质是一套围绕「患者—挂号—就诊—收费—药房—住院」这条主链路做增删改查、状态流转和权限隔离的业务系统。它不像电商那样拼高并发也不像推荐系统那样拼算法它拼的是业务闭环完整、数据一致、字段能对上医院真实流程。所以一套 HIS 源码的价值不在于用了多新的框架而在于它有没有把门诊挂号、医生站、收费、药房发药、住院登记这几块串成一条能走通的线。适合谁看想拿它做 Java 课程设计案例源码的学生、想二次开发做区域医疗小项目的开发者、以及刚转做 his 系统实施工程师需要摸清表结构的人。下面我按「先看懂结构、再跑起来、再改得动、最后避坑」的顺序讲。2. 先拆清楚HIS 源码里到底有哪些模块和表拿到一份医院信息管理系统源码最忌讳的就是上来就点运行。我一般先花半小时把目录和数据库脚本翻一遍心里有张地图后面改代码才不会迷路。这一章讲清楚模块划分和核心表这是后面所有操作的地基。2.1 门诊主链路的五个模块怎么分绝大多数 Java 版 HIS 源码包结构会按业务域切而不是按技术分层硬切。你打开src/main/java下面通常能看到类似这样的包名com.his.registration # 挂号号源、科室、医生排班 com.his.outpatient # 门诊医生站接诊、开处方、开检查 com.his.charge # 收费划价、结算、退费 com.his.pharmacy # 药房发药、退药、库存 com.his.inpatient # 住院登记、床位、医嘱、出院 com.his.common # 公共权限、字典、工具这个划分不是随便定的它对应医院里真实的岗位边界。挂号员只碰 registration收费员只碰 charge医生只碰 outpatient。你二次开发时加功能要往对应包里加别一股脑塞进 common否则半年后自己都找不到。判断一套源码值不值得深入看它有没有把「号源」单独建模。号源是 HIS 里最容易出并发问题的地方——同一个专家号两个人同时点谁抢到如果源码里号源只是简单的一张doctor_schedule表加个remain_count字段那它大概率没处理并发扣减你得自己补。常见做法是用数据库行锁或者 Redis 预扣我一般先在registration包里搜update ... set remain这类语句看它有没有加where remain_count 0的条件这是最基础的防超卖写法。2.2 核心表结构和字段含义HIS 的表不多但字段密。下面这张表是我从多套源码里总结出来的核心表你对照自己手上的脚本看缺哪张就说明这条链路不完整表名作用关键字段易错点patient患者主索引patient_id, id_card, nameid_card 要唯一重复建档是灾难registration挂号记录reg_id, patient_id, dept_id, doctor_id, statusstatus 流转要闭环doctor_schedule排班号源schedule_id, doctor_id, total, remainremain 扣减要防并发prescription处方主表pres_id, reg_id, total_amount, status金额用 decimal 不用 doubleprescription_detail处方明细detail_id, pres_id, drug_id, qty明细和主表要事务一致charge_record收费记录charge_id, pres_id, pay_type, amount退费要留原记录drug_stock药品库存drug_id, stock_qty, batch_no批次管理别省看这张表你会发现HIS 的数据一致性要求很高挂号要扣号源、开处方要占库存、收费要改处方状态这三步任何一步失败都得回滚。所以你在读源码时重点看 Service 层有没有Transactional以及事务边界划在哪。我见过不少课程设计级别的源码把扣号源和写挂号记录分成两个独立方法中间抛异常就导致号扣了但没挂号这种坑后面第 5 章会细说。2.3 权限模型为什么 HIS 不用简单的角色表普通管理系统一个role表加user_role就够了但 HIS 不行。因为医院里同一个人可能身兼多职而且权限要细到「按钮级」——收费员能点退费按钮挂号员不能。所以成熟的 HIS 源码会用 RBAC 加数据权限user、role、permission、role_permission四张表permission 里存的是菜单和按钮的编码。你读源码时搜一下PreAuthorize或者自定义的权限注解看它拦截粒度。如果只拦到 Controller 方法级那按钮级控制就得前端配合隐藏这种设计在真实医院里是不够的因为前端隐藏挡不住直接调接口。我一般会建议在 Service 层再加一道校验尤其是退费、作废这类敏感操作。3. 把源码跑起来环境、建库、启动的最小步骤看懂结构之后下一步是让它在你机器上跑起来。这一步翻车最多因为 HIS 源码往往依赖特定 JDK 版本和数据库。这一章给你一条能复现的路径参数怎么设、报错怎么看都写清楚。3.1 JDK 和 Maven 版本怎么选先看源码根目录的pom.xml搜java.version或maven.compiler.source。老一点的 HIS 源码写的是 1.8新一点的写 17。这里有个高频翻车点你本地装了 JDK 17源码要 1.8编译时报「源发行版 17 需要目标发行版 17」或者反过来。解决办法是明确指定# 查看当前 JDK java -version # 如果源码要 1.8用这个编译 mvn clean package -Dmaven.compiler.source1.8 -Dmaven.compiler.target1.8 # 如果源码要 17 mvn clean package -Dmaven.compiler.source17 -Dmaven.compiler.target17参数说明source是源码语法版本target是生成的字节码版本两个要一致否则要么编译不过要么运行时报UnsupportedClassVersionError。我一般会在pom.xml里直接改死而不是每次命令行传因为团队协作时命令行参数容易漏。Maven 本身建议用 3.6 以上仓库配国内镜像否则拉依赖能等到你怀疑人生。settings.xml里 mirror 指向阿里云或华为云都行这个属于 java 环境变量配置之外的常规操作配一次管很久。3.2 建库和导入 SQL 脚本HIS 源码的src/main/resources或doc目录下一般有his.sql或init.sql。导入前先建库字符集用 utf8mb4因为患者姓名、地址可能有生僻字CREATE DATABASE his_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE his_db; SOURCE /path/to/his.sql;注意SOURCE是 MySQL 客户端命令不是 SQL 语句在 Navicat 里要用「运行 SQL 文件」。导入后检查三件事表数量对不对、patient表有没有初始数据、字典表sys_dict有没有值。字典表空了前端下拉框全是空白你会以为是代码问题其实是数据没导全。3.3 改配置、启动、验证打开application.yml或application.properties改数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/his_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver参数说明serverTimezone必须设否则 MySQL 8 会报时区错误characterEncodingutf8对应 utf8mb4 库。改完启动mvn spring-boot:run # 或者 java -jar target/his-0.0.1-SNAPSHOT.jar启动后访问登录页用 SQL 里sys_user表的初始账号登录。如果登录报 401先看密码是不是明文存的——有些源码用明文有些用 BCrypt你输的密码要和存储方式匹配。验证跑通的标准是能登录、能进挂号页、能查到科室列表。这三步过了说明主链路环境没问题。4. 二次开发改一个挂号流程要动哪些文件跑起来只是开始真正的工作是改。这一章用一个具体需求——「给挂号加一个身份证校验」——带你走一遍改动路径让你知道 HIS 源码改起来该动哪几层。4.1 从 Controller 到 Mapper 的改动链路假设需求是挂号时如果患者身份证已存在直接复用患者档案不新建。这个需求涉及四层第一层RegistrationController的挂号接口接收参数里要有身份证号。第二层RegistrationService里加逻辑先按身份证查patient表查到就用现有patient_id查不到再建档。第三层PatientMapper加一个selectByIdCard方法。第四层PatientMapper.xml写对应 SQL。// RegistrationService.java Transactional(rollbackFor Exception.class) public Long register(RegisterDTO dto) { // 先查患者存在则复用 Patient patient patientMapper.selectByIdCard(dto.getIdCard()); if (patient null) { patient new Patient(); patient.setIdCard(dto.getIdCard()); patient.setName(dto.getName()); patientMapper.insert(patient); } // 再扣号源注意这里要在同一事务里 int affected scheduleMapper.decreaseRemain(dto.getScheduleId()); if (affected 0) { throw new BizException(号源已满); } // 写挂号记录 Registration reg new Registration(); reg.setPatientId(patient.getPatientId()); reg.setScheduleId(dto.getScheduleId()); registrationMapper.insert(reg); return reg.getRegId(); }逻辑说明这段代码把「查患者、扣号源、写挂号」放在一个事务里任何一步失败都回滚。参数说明rollbackFor Exception.class保证受检异常也回滚默认只回滚运行时异常这是很多人踩的坑。decreaseRemain返回影响行数为 0 说明号源被抢完直接抛异常。4.2 号源扣减的 SQL 怎么写才不超卖上面调用的decreaseRemainSQL 必须带条件UPDATE doctor_schedule SET remain remain - 1 WHERE schedule_id #{scheduleId} AND remain 0;逻辑说明AND remain 0是关键它让数据库在扣减时做原子判断避免两个线程同时读到 remain1 然后都扣成 0。参数说明schedule_id是排班主键走索引这条语句性能没问题。如果你用先查后改的写法先 select 再 update并发下必超卖这是血泪经验。4.3 前端和字典的联动改动后端改完前端挂号页要加身份证输入框并在失焦时调一个查询接口如果患者存在就自动填充姓名。字典方面如果新增了证件类型要去sys_dict表加一条dict_typeid_type的记录否则下拉框没选项。这一步容易被忽略因为代码里写的是dictCode数据没有就显示空。改完自测用同一个身份证挂两次号看第二次是不是复用患者、号源是不是各扣一次。这个用例能同时验证患者复用和号源扣减两条逻辑。5. 避坑与排查HIS 源码落地最常见的五个问题这一章是我这些年踩过的坑每条按「现象 → 原因 → 解决」写你遇到时直接对号入座。5.1 挂号成功但号源没扣现象数据库里挂号记录有了但doctor_schedule.remain没变。原因扣号源和写挂号不在同一事务或者扣号源的方法没加TransactionalSpring 代理没生效。解决确认扣号源和写挂号在同一个 Service 方法内且该方法被外部调用同类内部调用不走代理。我一般会把事务注解加在 Service 的 public 方法上并且用rollbackFor明确异常类型。5.2 收费金额出现 0.01 误差现象处方总金额和明细累加对不上差几分钱。原因金额字段用了double或float浮点运算有精度损失。解决所有金额字段改decimal(10,2)Java 侧用BigDecimal并且setScale(2, RoundingMode.HALF_UP)。这个改动要全表全代码搜漏一个字段就还会出问题。5.3 登录后菜单空白现象能登录但左侧菜单不显示。原因sys_menu或sys_permission表没数据或者当前角色没关联权限。解决先查role_permission表有没有当前角色的记录没有就补再查sys_menu有没有parent_id0的根菜单。有些源码把菜单写死在前端那就要看前端路由配置别只盯数据库。5.4 中文乱码现象患者姓名存进去变成问号。原因数据库、连接串、表字段三处字符集不一致。解决库用 utf8mb4连接串加characterEncodingutf8表字段确认是 utf8mb4。三处都对了才不会乱。导入 SQL 时也要确认文件本身是 UTF-8 编码用记事本另存为 UTF-8 能救急。5.5 启动报端口占用或 Bean 冲突现象启动失败提示 8080 被占用或者同一个 Bean 定义了两次。原因端口被其他程序占或者源码里 XML 配置和注解配置重复扫描。解决端口占用改server.portBean 冲突搜Bean和Component有没有重复或者MapperScan扫到了不该扫的包。这类问题看启动日志第一行报错就够别被后面一堆堆栈带偏。6. 进阶把 HIS 源码改造成能演示的课程设计如果你拿这套源码做 Java 课程设计案例源码光跑通不够答辩时要能讲出你改了什么、为什么这么改。这一章给你一个具体的改造技巧和验证方法。6.1 用 AOP 加一层操作日志医院系统对操作留痕要求高退费、作废都要有记录。与其在每个方法里写日志不如用 AOP 统一拦Aspect Component public class OpLogAspect { Around(annotation(opLog)) public Object around(ProceedingJoinPoint pjp, OpLog opLog) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); // 记录操作人、方法、耗时、结果 logService.save(pjp.getSignature().getName(), SecurityUtils.getCurrentUser(), System.currentTimeMillis() - start); return result; } }逻辑说明自定义OpLog注解打在需要留痕的方法上AOP 环绕通知里记录操作人和耗时。参数说明pjp.proceed()是执行原方法异常时不会走到记录那行所以如果要记录失败操作得用 try-finally。这个改造在答辩时是加分项因为它体现了你对「医疗系统要留痕」这个业务约束的理解。6.2 验证改造是否生效的三个用例改完别急着说完成跑三个用例第一正常挂号看日志表有没有记录、耗时多少第二号源满时挂号看是否抛异常且号源没被扣第三同一身份证挂两次看患者是否复用。这三个用例覆盖了主链路、边界和幂等能过就说明改造没破坏原有逻辑。用例输入预期结果正常挂号有效排班、新身份证挂号成功号源减 1日志有记录号源满remain0 的排班抛「号源已满」号源不变重复挂号已存在的身份证复用患者号源再减 16.3 我自己的习惯我改任何 HIS 源码第一件事是把数据库脚本和pom.xml备份一份改崩了能回退。第二件事是先跑通再改绝不边跑边改。第三件事是每改一个功能就写一个能复现的用例答辩或交付时直接演示。这套源码方向值不值得投入取决于你能不能把它改到贴合一个真实小医院的门诊流程——能改到那一步它就不只是课程设计而是能拿出手的项目。希望帮到你。本文还有配套的精品资源点击获取 Java医院信息管理系统源码解析：从模块拆解到二次开发实战
简介这是一套基于SpringBoot、Jpa与Thymeleaf开发的Java医院信息管理系统源码面向中小型医疗机构信息化建设需求也适合Java学习者深入理解企业级项目实战。系统整合患者管理、医生排班、药品库存、财务管理、预约挂号、住院管理、权限控制等核心业务模块覆盖医院日常运营的主要流程。压缩包共3973个文件约15.37MB以2982个svg图标、254个scss样式、129个java源码、136个js脚本、56个html页面及100个css文件为主另含sql建表脚本、yml配置与maven构建文件前端资源与后端逻辑分层清晰。目前已有2522人学习下载。读者可从中获得完整的项目目录结构、实体与业务层实现范例、数据库脚本以及前后端整合思路既能作为课程设计或二次开发的起点也便于对照学习SpringBoot与Jpa在实际医疗场景中的落地方式。1. 一套 Java 医院信息管理系统源码到底能拿来干什么如果你手上正躺着一份 Java 医院信息管理系统源码或者正在搜「医院 HIS 源码」想找一套能跑起来、能改、能交付的东西那这篇就是写给你的。HIS 是 Hospital Information System 的缩写落到代码层面它本质是一套围绕「患者—挂号—就诊—收费—药房—住院」这条主链路做增删改查、状态流转和权限隔离的业务系统。它不像电商那样拼高并发也不像推荐系统那样拼算法它拼的是业务闭环完整、数据一致、字段能对上医院真实流程。所以一套 HIS 源码的价值不在于用了多新的框架而在于它有没有把门诊挂号、医生站、收费、药房发药、住院登记这几块串成一条能走通的线。适合谁看想拿它做 Java 课程设计案例源码的学生、想二次开发做区域医疗小项目的开发者、以及刚转做 his 系统实施工程师需要摸清表结构的人。下面我按「先看懂结构、再跑起来、再改得动、最后避坑」的顺序讲。2. 先拆清楚HIS 源码里到底有哪些模块和表拿到一份医院信息管理系统源码最忌讳的就是上来就点运行。我一般先花半小时把目录和数据库脚本翻一遍心里有张地图后面改代码才不会迷路。这一章讲清楚模块划分和核心表这是后面所有操作的地基。2.1 门诊主链路的五个模块怎么分绝大多数 Java 版 HIS 源码包结构会按业务域切而不是按技术分层硬切。你打开src/main/java下面通常能看到类似这样的包名com.his.registration # 挂号号源、科室、医生排班 com.his.outpatient # 门诊医生站接诊、开处方、开检查 com.his.charge # 收费划价、结算、退费 com.his.pharmacy # 药房发药、退药、库存 com.his.inpatient # 住院登记、床位、医嘱、出院 com.his.common # 公共权限、字典、工具这个划分不是随便定的它对应医院里真实的岗位边界。挂号员只碰 registration收费员只碰 charge医生只碰 outpatient。你二次开发时加功能要往对应包里加别一股脑塞进 common否则半年后自己都找不到。判断一套源码值不值得深入看它有没有把「号源」单独建模。号源是 HIS 里最容易出并发问题的地方——同一个专家号两个人同时点谁抢到如果源码里号源只是简单的一张doctor_schedule表加个remain_count字段那它大概率没处理并发扣减你得自己补。常见做法是用数据库行锁或者 Redis 预扣我一般先在registration包里搜update ... set remain这类语句看它有没有加where remain_count 0的条件这是最基础的防超卖写法。2.2 核心表结构和字段含义HIS 的表不多但字段密。下面这张表是我从多套源码里总结出来的核心表你对照自己手上的脚本看缺哪张就说明这条链路不完整表名作用关键字段易错点patient患者主索引patient_id, id_card, nameid_card 要唯一重复建档是灾难registration挂号记录reg_id, patient_id, dept_id, doctor_id, statusstatus 流转要闭环doctor_schedule排班号源schedule_id, doctor_id, total, remainremain 扣减要防并发prescription处方主表pres_id, reg_id, total_amount, status金额用 decimal 不用 doubleprescription_detail处方明细detail_id, pres_id, drug_id, qty明细和主表要事务一致charge_record收费记录charge_id, pres_id, pay_type, amount退费要留原记录drug_stock药品库存drug_id, stock_qty, batch_no批次管理别省看这张表你会发现HIS 的数据一致性要求很高挂号要扣号源、开处方要占库存、收费要改处方状态这三步任何一步失败都得回滚。所以你在读源码时重点看 Service 层有没有Transactional以及事务边界划在哪。我见过不少课程设计级别的源码把扣号源和写挂号记录分成两个独立方法中间抛异常就导致号扣了但没挂号这种坑后面第 5 章会细说。2.3 权限模型为什么 HIS 不用简单的角色表普通管理系统一个role表加user_role就够了但 HIS 不行。因为医院里同一个人可能身兼多职而且权限要细到「按钮级」——收费员能点退费按钮挂号员不能。所以成熟的 HIS 源码会用 RBAC 加数据权限user、role、permission、role_permission四张表permission 里存的是菜单和按钮的编码。你读源码时搜一下PreAuthorize或者自定义的权限注解看它拦截粒度。如果只拦到 Controller 方法级那按钮级控制就得前端配合隐藏这种设计在真实医院里是不够的因为前端隐藏挡不住直接调接口。我一般会建议在 Service 层再加一道校验尤其是退费、作废这类敏感操作。3. 把源码跑起来环境、建库、启动的最小步骤看懂结构之后下一步是让它在你机器上跑起来。这一步翻车最多因为 HIS 源码往往依赖特定 JDK 版本和数据库。这一章给你一条能复现的路径参数怎么设、报错怎么看都写清楚。3.1 JDK 和 Maven 版本怎么选先看源码根目录的pom.xml搜java.version或maven.compiler.source。老一点的 HIS 源码写的是 1.8新一点的写 17。这里有个高频翻车点你本地装了 JDK 17源码要 1.8编译时报「源发行版 17 需要目标发行版 17」或者反过来。解决办法是明确指定# 查看当前 JDK java -version # 如果源码要 1.8用这个编译 mvn clean package -Dmaven.compiler.source1.8 -Dmaven.compiler.target1.8 # 如果源码要 17 mvn clean package -Dmaven.compiler.source17 -Dmaven.compiler.target17参数说明source是源码语法版本target是生成的字节码版本两个要一致否则要么编译不过要么运行时报UnsupportedClassVersionError。我一般会在pom.xml里直接改死而不是每次命令行传因为团队协作时命令行参数容易漏。Maven 本身建议用 3.6 以上仓库配国内镜像否则拉依赖能等到你怀疑人生。settings.xml里 mirror 指向阿里云或华为云都行这个属于 java 环境变量配置之外的常规操作配一次管很久。3.2 建库和导入 SQL 脚本HIS 源码的src/main/resources或doc目录下一般有his.sql或init.sql。导入前先建库字符集用 utf8mb4因为患者姓名、地址可能有生僻字CREATE DATABASE his_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE his_db; SOURCE /path/to/his.sql;注意SOURCE是 MySQL 客户端命令不是 SQL 语句在 Navicat 里要用「运行 SQL 文件」。导入后检查三件事表数量对不对、patient表有没有初始数据、字典表sys_dict有没有值。字典表空了前端下拉框全是空白你会以为是代码问题其实是数据没导全。3.3 改配置、启动、验证打开application.yml或application.properties改数据库连接spring: datasource: url: jdbc:mysql://localhost:3306/his_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver参数说明serverTimezone必须设否则 MySQL 8 会报时区错误characterEncodingutf8对应 utf8mb4 库。改完启动mvn spring-boot:run # 或者 java -jar target/his-0.0.1-SNAPSHOT.jar启动后访问登录页用 SQL 里sys_user表的初始账号登录。如果登录报 401先看密码是不是明文存的——有些源码用明文有些用 BCrypt你输的密码要和存储方式匹配。验证跑通的标准是能登录、能进挂号页、能查到科室列表。这三步过了说明主链路环境没问题。4. 二次开发改一个挂号流程要动哪些文件跑起来只是开始真正的工作是改。这一章用一个具体需求——「给挂号加一个身份证校验」——带你走一遍改动路径让你知道 HIS 源码改起来该动哪几层。4.1 从 Controller 到 Mapper 的改动链路假设需求是挂号时如果患者身份证已存在直接复用患者档案不新建。这个需求涉及四层第一层RegistrationController的挂号接口接收参数里要有身份证号。第二层RegistrationService里加逻辑先按身份证查patient表查到就用现有patient_id查不到再建档。第三层PatientMapper加一个selectByIdCard方法。第四层PatientMapper.xml写对应 SQL。// RegistrationService.java Transactional(rollbackFor Exception.class) public Long register(RegisterDTO dto) { // 先查患者存在则复用 Patient patient patientMapper.selectByIdCard(dto.getIdCard()); if (patient null) { patient new Patient(); patient.setIdCard(dto.getIdCard()); patient.setName(dto.getName()); patientMapper.insert(patient); } // 再扣号源注意这里要在同一事务里 int affected scheduleMapper.decreaseRemain(dto.getScheduleId()); if (affected 0) { throw new BizException(号源已满); } // 写挂号记录 Registration reg new Registration(); reg.setPatientId(patient.getPatientId()); reg.setScheduleId(dto.getScheduleId()); registrationMapper.insert(reg); return reg.getRegId(); }逻辑说明这段代码把「查患者、扣号源、写挂号」放在一个事务里任何一步失败都回滚。参数说明rollbackFor Exception.class保证受检异常也回滚默认只回滚运行时异常这是很多人踩的坑。decreaseRemain返回影响行数为 0 说明号源被抢完直接抛异常。4.2 号源扣减的 SQL 怎么写才不超卖上面调用的decreaseRemainSQL 必须带条件UPDATE doctor_schedule SET remain remain - 1 WHERE schedule_id #{scheduleId} AND remain 0;逻辑说明AND remain 0是关键它让数据库在扣减时做原子判断避免两个线程同时读到 remain1 然后都扣成 0。参数说明schedule_id是排班主键走索引这条语句性能没问题。如果你用先查后改的写法先 select 再 update并发下必超卖这是血泪经验。4.3 前端和字典的联动改动后端改完前端挂号页要加身份证输入框并在失焦时调一个查询接口如果患者存在就自动填充姓名。字典方面如果新增了证件类型要去sys_dict表加一条dict_typeid_type的记录否则下拉框没选项。这一步容易被忽略因为代码里写的是dictCode数据没有就显示空。改完自测用同一个身份证挂两次号看第二次是不是复用患者、号源是不是各扣一次。这个用例能同时验证患者复用和号源扣减两条逻辑。5. 避坑与排查HIS 源码落地最常见的五个问题这一章是我这些年踩过的坑每条按「现象 → 原因 → 解决」写你遇到时直接对号入座。5.1 挂号成功但号源没扣现象数据库里挂号记录有了但doctor_schedule.remain没变。原因扣号源和写挂号不在同一事务或者扣号源的方法没加TransactionalSpring 代理没生效。解决确认扣号源和写挂号在同一个 Service 方法内且该方法被外部调用同类内部调用不走代理。我一般会把事务注解加在 Service 的 public 方法上并且用rollbackFor明确异常类型。5.2 收费金额出现 0.01 误差现象处方总金额和明细累加对不上差几分钱。原因金额字段用了double或float浮点运算有精度损失。解决所有金额字段改decimal(10,2)Java 侧用BigDecimal并且setScale(2, RoundingMode.HALF_UP)。这个改动要全表全代码搜漏一个字段就还会出问题。5.3 登录后菜单空白现象能登录但左侧菜单不显示。原因sys_menu或sys_permission表没数据或者当前角色没关联权限。解决先查role_permission表有没有当前角色的记录没有就补再查sys_menu有没有parent_id0的根菜单。有些源码把菜单写死在前端那就要看前端路由配置别只盯数据库。5.4 中文乱码现象患者姓名存进去变成问号。原因数据库、连接串、表字段三处字符集不一致。解决库用 utf8mb4连接串加characterEncodingutf8表字段确认是 utf8mb4。三处都对了才不会乱。导入 SQL 时也要确认文件本身是 UTF-8 编码用记事本另存为 UTF-8 能救急。5.5 启动报端口占用或 Bean 冲突现象启动失败提示 8080 被占用或者同一个 Bean 定义了两次。原因端口被其他程序占或者源码里 XML 配置和注解配置重复扫描。解决端口占用改server.portBean 冲突搜Bean和Component有没有重复或者MapperScan扫到了不该扫的包。这类问题看启动日志第一行报错就够别被后面一堆堆栈带偏。6. 进阶把 HIS 源码改造成能演示的课程设计如果你拿这套源码做 Java 课程设计案例源码光跑通不够答辩时要能讲出你改了什么、为什么这么改。这一章给你一个具体的改造技巧和验证方法。6.1 用 AOP 加一层操作日志医院系统对操作留痕要求高退费、作废都要有记录。与其在每个方法里写日志不如用 AOP 统一拦Aspect Component public class OpLogAspect { Around(annotation(opLog)) public Object around(ProceedingJoinPoint pjp, OpLog opLog) throws Throwable { long start System.currentTimeMillis(); Object result pjp.proceed(); // 记录操作人、方法、耗时、结果 logService.save(pjp.getSignature().getName(), SecurityUtils.getCurrentUser(), System.currentTimeMillis() - start); return result; } }逻辑说明自定义OpLog注解打在需要留痕的方法上AOP 环绕通知里记录操作人和耗时。参数说明pjp.proceed()是执行原方法异常时不会走到记录那行所以如果要记录失败操作得用 try-finally。这个改造在答辩时是加分项因为它体现了你对「医疗系统要留痕」这个业务约束的理解。6.2 验证改造是否生效的三个用例改完别急着说完成跑三个用例第一正常挂号看日志表有没有记录、耗时多少第二号源满时挂号看是否抛异常且号源没被扣第三同一身份证挂两次看患者是否复用。这三个用例覆盖了主链路、边界和幂等能过就说明改造没破坏原有逻辑。用例输入预期结果正常挂号有效排班、新身份证挂号成功号源减 1日志有记录号源满remain0 的排班抛「号源已满」号源不变重复挂号已存在的身份证复用患者号源再减 16.3 我自己的习惯我改任何 HIS 源码第一件事是把数据库脚本和pom.xml备份一份改崩了能回退。第二件事是先跑通再改绝不边跑边改。第三件事是每改一个功能就写一个能复现的用例答辩或交付时直接演示。这套源码方向值不值得投入取决于你能不能把它改到贴合一个真实小医院的门诊流程——能改到那一步它就不只是课程设计而是能拿出手的项目。希望帮到你。本文还有配套的精品资源点击获取