简介这是一套基于SpringBoot开发的医院挂号预约管理系统完整源码工程面向计算机专业本科生及Java初学者适用于课程设计、毕业设计与Web全栈实践项目。系统覆盖用户管理、医生科室展示、在线挂号、就诊提醒、病历查询、在线支付、医生评价及预约数据分析等核心医疗业务模块具备前后端分离架构特征。资源包共668个文件含156个Java后端逻辑文件、113个Vue前端组件、159个SVG图标资源、63个JS交互脚本及49个JPG/PNG界面素材配合YML配置、SQL建表脚本与BAT启动脚本结构完整、开箱即用压缩包大小为18.57MB。已有81人学习下载提供可直接运行的完整项目骨架、清晰的模块划分目录含fe、be、sql、doc等子目录、典型医疗业务场景的代码实现范例以及包含build/run/install等多环境启动支持的工程化实践细节。1. 这不是又一个“SpringBoot CRUD 演示”而是一套能跑通挂号全流程的医院业务骨架你手头这份「医院挂号预约管理-JAVA-基于springBoot的医院挂号预约管理系统」表面看是课程作业或毕业设计但实际结构远超教学模板它内置了从患者注册、科室医生分级展示、时段化挂号调度、就诊前多通道提醒、到支付对账与评价闭环的完整链路。关键在于它没把“挂号”简化成一张appointment表的增删改查——而是用TimeSlot实体约束医生每日可约时段、用AppointmentStatus枚举区分“待确认/已就诊/已取消”状态、用PaymentChannel抽象层预留微信/支付宝对接入口。这意味着如果你正被导师要求“做点不一样的毕设”或者刚接手医院信息化改造项目需要快速验证业务逻辑这套代码不是拿来抄的而是拿来拆解、替换、压测的真实业务脚手架。它适合两类人一是 Java 初学者想理解 SpringBoot 如何承载真实医疗场景而非 TodoList二是有经验的开发者需要快速复用挂号排程、状态机流转、支付回调等模块。2. SpringBoot 3.x MyBatis-Plus 的分层架构落地细节2.1 为什么选 SpringBoot 3.x 而非 2.x版本兼容性与安全边界该项目默认使用 SpringBoot 3.x具体为 3.1.x 或 3.2.x取决于pom.xml中spring-boot.version值这并非盲目追新。核心动因在于 JDK 17 的强绑定——医院系统上线后往往需长期维护JDK 17 是 LTS 版本而 SpringBoot 3.x 是首个强制要求 JDK 17的主版本。若强行降级到 SpringBoot 2.7.x支持 JDK 8/11将无法使用Observation注解做链路追踪、RetryableTopic做消息重试等现代运维能力。更关键的是SpringBoot 3.x 默认启用 Jakarta EE 9 命名空间如jakarta.servlet.*避免了旧版javax.*在 Tomcat 10 上的类加载冲突。检查你的pom.xml确认以下依赖存在parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.4/version !-- 注意必须 ≥3.0.0 -- relativePath/ /parent提示若mvn clean install报错java.lang.NoClassDefFoundError: javax/servlet/ServletContext说明你误用了 Tomcat 9 或更低版本。请升级至 Tomcat 10.1.x并确保spring-boot-starter-web依赖未被手动排除。2.2 MyBatis-Plus 的实体映射与动态 SQL 实战挂号系统最易被忽略的复杂度在于“时段冲突校验”。患者 A 预约了张医生 9:00-9:30患者 B 就不能再约同一时段。MyBatis-Plus 通过TableField和TableName完成基础映射但真正解决冲突的是其QueryWrapper动态构建能力。以AppointmentMapper.java中的冲突检测方法为例// AppointmentMapper.java public interface AppointmentMapper extends BaseMapperAppointment { // 自定义 SQL查询某医生在指定时间段内是否存在已预约记录 Select(SELECT COUNT(*) FROM appointment WHERE doctor_id #{doctorId} AND status IN (CONFIRMED, CHECKED_IN) AND start_time #{endTime} AND end_time #{startTime}) int countConflictingAppointments(Param(doctorId) Long doctorId, Param(startTime) LocalDateTime startTime, Param(endTime) LocalDateTime endTime); }该 SQL 直接嵌入 Mapper 接口避免 XML 文件冗余。参数#{startTime}使用 MyBatis 的预编译占位符防止 SQL 注入status IN (CONFIRMED, CHECKED_IN)精确过滤有效预约排除“已取消”记录。调用时传入LocalDateTime.now().plusHours(1)作为startTime即可校验未来 1 小时内是否可约。2.2.1 实体类中的时间字段处理陷阱Appointment.java中的startTime和endTime字段类型必须为LocalDateTime而非Date或StringTableField(start_time) private LocalDateTime startTime; // ✅ 正确支持时区无关的本地时间计算 TableField(end_time) private LocalDateTime endTime;若误用DateMyBatis-Plus 会将其序列化为毫秒时间戳导致跨时区显示错误如北京用户看到上海时间若用String则丧失数据库原生时间函数如DATE_ADD()能力。SpringBoot 3.x 默认配置spring.jackson.time-zoneGMT8但LocalDateTime不含时区信息因此所有时间计算应在应用层统一按东八区处理。2.3 多模块划分api、service、domain的职责边界项目目录结构中app.feac833a.css等前端资源文件暗示其采用前后端分离架构后端严格遵循分层规范模块职责关键类示例domain核心领域模型不含任何框架注解Patient.java,Doctor.java,TimeSlot.javaservice业务逻辑编排调用多个 MapperAppointmentService.java中的createAppointment()方法api控制器层处理 HTTP 请求与响应AppointmentController.java中的PostMapping(/appointments)AppointmentService.java中的挂号创建逻辑清晰体现分层价值Service public class AppointmentService { Autowired private AppointmentMapper appointmentMapper; Autowired private DoctorMapper doctorMapper; Autowired private TimeSlotMapper timeSlotMapper; Transactional // 事务控制覆盖整个挂号流程 public ResultAppointment createAppointment(Long patientId, Long doctorId, LocalDateTime slotTime) { // 1. 校验医生是否存在且在职 Doctor doctor doctorMapper.selectById(doctorId); if (doctor null || !doctor.getStatus().equals(ON_DUTY)) { return Result.fail(医生不存在或暂不接诊); } // 2. 校验时段是否可用调用 2.2 节的 countConflictingAppointments if (appointmentMapper.countConflictingAppointments(doctorId, slotTime, slotTime.plusMinutes(30)) 0) { return Result.fail(该时段已被预约请选择其他时间); } // 3. 创建预约记录 Appointment appointment new Appointment(); appointment.setPatientId(patientId); appointment.setDoctorId(doctorId); appointment.setStartTime(slotTime); appointment.setEndTime(slotTime.plusMinutes(30)); appointment.setStatus(PENDING); // 初始状态为待确认 appointmentMapper.insert(appointment); return Result.success(appointment); } }注意Transactional注解必须作用于public方法且由 Spring 容器代理调用。若在createAppointment()内部直接调用this.countConflictingAppointments()事务将失效。3. 挂号核心流程从时段选择到状态机驱动的预约生命周期3.1 科室-医生-时段三级联动的数据建模挂号页面需实现“选科室 → 选医生 → 选时段”的链式筛选这要求数据库表间存在明确关联表名主键关键外键业务含义departmentid—内科、外科等一级科室doctoriddepartment_id医生归属科室time_slotiddoctor_id医生每日可约时段如 9:00-9:30TimeSlot.java实体中doctorId字段必须标注TableField(doctor_id)否则 MyBatis-Plus 无法自动映射。前端发起请求时典型路径为# 1. 获取某科室下所有医生 GET /api/doctors?departmentId1 # 2. 获取某医生未来 7 天可约时段 GET /api/time-slots?doctorId101date2024-06-15后端TimeSlotController.java的实现需注意日期范围校验GetMapping(/time-slots) public ResultListTimeSlot getTimeSlots(RequestParam Long doctorId, RequestParam String date) { // 强制校验日期格式防止恶意输入 LocalDate parsedDate LocalDate.parse(date, DateTimeFormatter.ofPattern(yyyy-MM-dd)); // 限制查询范围仅允许查询未来 30 天内时段 if (parsedDate.isBefore(LocalDate.now()) || parsedDate.isAfter(LocalDate.now().plusDays(30))) { return Result.fail(日期超出可预约范围仅支持未来30天); } ListTimeSlot slots timeSlotService.getAvailableSlots(doctorId, parsedDate); return Result.success(slots); }3.1.1 时段数据初始化避免手动录入的自动化方案time_slot表不应依赖人工维护。项目中1-install.bat脚本实际执行init-time-slots.sql其核心逻辑是遍历每个在职医生为其生成未来 30 天的 8:00-12:00、13:00-17:00 两个班次每 30 分钟一个时段。SQL 示例INSERT INTO time_slot (doctor_id, date, start_time, end_time, status) SELECT d.id AS doctor_id, DATE_ADD(CURDATE(), INTERVAL n DAY) AS date, CONCAT(HOUR, :00:00) AS start_time, CONCAT(HOUR, :30:00) AS end_time, AVAILABLE AS status FROM doctor d CROSS JOIN ( SELECT 0 AS n UNION SELECT 1 UNION ... SELECT 29 ) days CROSS JOIN ( SELECT 8 AS HOUR UNION SELECT 9 UNION SELECT 10 UNION SELECT 11 UNION SELECT 13 UNION SELECT 14 UNION SELECT 15 UNION SELECT 16 ) hours WHERE d.status ON_DUTY AND DATE_ADD(CURDATE(), INTERVAL n DAY) DATE_ADD(CURDATE(), INTERVAL 30 DAY);此脚本在首次部署时运行一次后续由定时任务每日凌晨刷新次日时段。3.2 预约状态机从 PENDING 到 CHECKED_IN 的七种状态流转挂号不是静态记录而是状态持续演进的过程。项目定义了AppointmentStatus枚举public enum AppointmentStatus { PENDING, // 患者提交待医生确认 CONFIRMED, // 医生确认患者收到通知 CANCELLED, // 患者或医生主动取消 NO_SHOW, // 患者未按时就诊 CHECKED_IN, // 患者现场签到 IN_CONSULTATION, // 医生正在问诊 COMPLETED // 诊疗结束生成病历 }状态变更必须受控禁止直接UPDATE appointment SET statusCONFIRMED。AppointmentService.java提供专用方法public ResultString confirmAppointment(Long appointmentId) { Appointment appointment appointmentMapper.selectById(appointmentId); if (!appointment.getStatus().equals(PENDING)) { return Result.fail(仅可确认待确认状态的预约); } appointment.setStatus(CONFIRMED); appointmentMapper.updateById(appointment); // 发送短信/推送通知此处调用第三方 SDK notificationService.sendAppointmentConfirmed(appointment); return Result.success(确认成功); }3.2.1 状态变更的幂等性保障高并发下多次点击“确认预约”可能触发重复更新。解决方案是在updateById前加乐观锁// Appointment.java 中添加版本字段 TableField(version) private Integer version; // 更新时校验版本号 Appointment old appointmentMapper.selectById(appointmentId); if (old.getVersion() ! expectedVersion) { return Result.fail(预约已被他人操作请刷新页面); } old.setVersion(old.getVersion() 1); appointmentMapper.updateById(old); // MyBatis-Plus 自动注入 version 条件Version注解可替代手动管理但需确保数据库version字段初始值为 0。4. 支付与病历模块的可扩展设计及常见踩坑点4.1 支付回调的防重入与异步解耦PaymentController.java中的微信支付回调接口/api/pay/callback是高危入口必须处理重复通知PostMapping(/callback) public String handleWechatCallback(HttpServletRequest request) { try { // 1. 解析微信回调 XML String xmlData IOUtils.toString(request.getInputStream(), StandardCharsets.UTF_8); MapString, String notifyMap WXPayUtil.xmlToMap(xmlData); // 2. 验证签名关键 if (!WXPayUtil.isSignatureValid(notifyMap, your_mch_key)) { return xmlreturn_code![CDATA[FAIL]]/return_codereturn_msg![CDATA[签名失败]]/return_msg/xml; } // 3. 查询订单状态避免重复处理 String outTradeNo notifyMap.get(out_trade_no); Appointment appointment appointmentMapper.selectOne( new QueryWrapperAppointment().eq(order_no, outTradeNo) ); if (appointment null || appointment.getStatus().equals(PAID)) { return xmlreturn_code![CDATA[SUCCESS]]/return_codereturn_msg![CDATA[OK]]/return_msg/xml; } // 4. 更新预约状态并发送就诊提醒 appointment.setStatus(PAID); appointmentMapper.updateById(appointment); notificationService.sendAppointmentPaid(appointment); return xmlreturn_code![CDATA[SUCCESS]]/return_codereturn_msg![CDATA[OK]]/return_msg/xml; } catch (Exception e) { log.error(微信支付回调异常, e); return xmlreturn_code![CDATA[FAIL]]/return_codereturn_msg![CDATA[系统错误]]/return_msg/xml; } }提示WXPayUtil是微信官方 SDK 工具类isSignatureValid方法必须传入商户密钥mch_key该密钥在微信支付后台设置绝不可硬编码在代码中应存于application-prod.yml的加密配置项。4.2 病历记录的读写分离实践MedicalRecord.java实体包含大量文本字段主诉、现病史、诊断结果频繁读写影响性能。项目采用读写分离策略写库主库MySQL处理INSERT/UPDATE保证 ACID读库从库MySQL Slave专用于SELECT通过DS(slave)注解路由。Mapper public interface MedicalRecordMapper extends BaseMapperMedicalRecord { Select(SELECT * FROM medical_record WHERE patient_id #{patientId} ORDER BY created_time DESC LIMIT 10) DS(slave) // 显式指定从库 ListMedicalRecord selectLatestByPatient(Param(patientId) Long patientId); }若未配置多数据源DS注解无效。需在application.yml中声明spring: datasource: master: url: jdbc:mysql://master-db:3306/hospital?useSSLfalse username: root password: password slave: url: jdbc:mysql://slave-db:3306/hospital?useSSLfalse username: reader password: readonly1234.3 数据统计模块的轻量级实现不用 ETL用 SQL 窗口函数摘要中提到“预约数据分析”但项目未引入 ClickHouse 或 Druid。实际通过 MySQL 8.0 的窗口函数实现实时统计-- 统计各科室本周预约量 Top 5 SELECT d.name AS department_name, COUNT(a.id) AS appointment_count, ROUND(COUNT(a.id) * 100.0 / SUM(COUNT(a.id)) OVER(), 2) AS percentage FROM appointment a JOIN doctor doc ON a.doctor_id doc.id JOIN department d ON doc.department_id d.id WHERE a.created_time DATE_SUB(NOW(), INTERVAL 7 DAY) GROUP BY d.name ORDER BY appointment_count DESC LIMIT 5;SUM(COUNT(a.id)) OVER()是窗口函数无需子查询即可计算总占比。此 SQL 可直接在StatisticalService.java中通过Select执行避免 Java 层循环计算。5. 毕业设计答辩高频问题与代码级应答策略5.1 “如何保证高并发挂号不超卖”——从数据库到应用层的三重防护面试官常以此题考察技术深度。回答需分层展开每层附代码证据防护层实现方式代码位置关键参数数据库层time_slot表status字段加唯一索引schema.sqlUNIQUE KEY uk_doctor_date_start (doctor_id, date, start_time)应用层countConflictingAppointments()先查后插AppointmentMapper.javaSelect中start_time #{endTime} AND end_time #{startTime}缓存层Redis 锁控制单医生时段并发AppointmentService.javaRedisLock lock new RedisLock(slot_lock: doctorId _ slotTime);若项目未实现 Redis 锁可坦诚说明“当前设计已通过数据库唯一索引和应用层校验满足日均 5000 预约量需求若需支撑万级并发将在createAppointment()方法开头添加RedisTemplate.opsForValue().setIfAbsent()分布式锁。”5.2 “支付模块怎么对接微信/支付宝”——配置化接入的关键字段表答辩时需展示支付模块的可配置性而非硬编码。application.yml中应存在pay: wechat: app-id: wx1234567890abcdef mch-id: 1234567890 api-v3-key: your_api_v3_key_here # 32位密钥 notify-url: https://your-domain.com/api/pay/callback alipay: app-id: 2021000123456789 merchant-private-key: MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC... alipay-public-key: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu...注意merchant-private-key和alipay-public-key必须用\n替换换行符后填入 YAML否则 RSA 解密失败。例如MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...→MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n...5.3 “如何快速验证系统功能”——2-run.bat启动后的三步验证法不要只说“启动成功”要给出可立即执行的验证路径访问 Swagger UI启动后打开http://localhost:8080/swagger-ui/index.html测试POST /api/appointments接口传入 JSON{ patientId: 1, doctorId: 101, slotTime: 2024-06-15T09:00:00 }检查数据库登录 MySQL执行SELECT * FROM appointment WHERE patient_id 1 ORDER BY created_time DESC LIMIT 1;确认status为PENDING。触发支付回调用 Postman 模拟微信回调 XML观察appointment表中status是否变为PAID并检查notification_service日志是否有“支付成功通知已发送”。这三步能在 5 分钟内向答辩老师证明代码可运行、逻辑可验证、问题可追溯。本文还有配套的精品资源点击获取
简介这是一套基于SpringBoot开发的医院挂号预约管理系统完整源码工程面向计算机专业本科生及Java初学者适用于课程设计、毕业设计与Web全栈实践项目。系统覆盖用户管理、医生科室展示、在线挂号、就诊提醒、病历查询、在线支付、医生评价及预约数据分析等核心医疗业务模块具备前后端分离架构特征。资源包共668个文件含156个Java后端逻辑文件、113个Vue前端组件、159个SVG图标资源、63个JS交互脚本及49个JPG/PNG界面素材配合YML配置、SQL建表脚本与BAT启动脚本结构完整、开箱即用压缩包大小为18.57MB。已有81人学习下载提供可直接运行的完整项目骨架、清晰的模块划分目录含fe、be、sql、doc等子目录、典型医疗业务场景的代码实现范例以及包含build/run/install等多环境启动支持的工程化实践细节。1. 这不是又一个“SpringBoot CRUD 演示”而是一套能跑通挂号全流程的医院业务骨架你手头这份「医院挂号预约管理-JAVA-基于springBoot的医院挂号预约管理系统」表面看是课程作业或毕业设计但实际结构远超教学模板它内置了从患者注册、科室医生分级展示、时段化挂号调度、就诊前多通道提醒、到支付对账与评价闭环的完整链路。关键在于它没把“挂号”简化成一张appointment表的增删改查——而是用TimeSlot实体约束医生每日可约时段、用AppointmentStatus枚举区分“待确认/已就诊/已取消”状态、用PaymentChannel抽象层预留微信/支付宝对接入口。这意味着如果你正被导师要求“做点不一样的毕设”或者刚接手医院信息化改造项目需要快速验证业务逻辑这套代码不是拿来抄的而是拿来拆解、替换、压测的真实业务脚手架。它适合两类人一是 Java 初学者想理解 SpringBoot 如何承载真实医疗场景而非 TodoList二是有经验的开发者需要快速复用挂号排程、状态机流转、支付回调等模块。2. SpringBoot 3.x MyBatis-Plus 的分层架构落地细节2.1 为什么选 SpringBoot 3.x 而非 2.x版本兼容性与安全边界该项目默认使用 SpringBoot 3.x具体为 3.1.x 或 3.2.x取决于pom.xml中spring-boot.version值这并非盲目追新。核心动因在于 JDK 17 的强绑定——医院系统上线后往往需长期维护JDK 17 是 LTS 版本而 SpringBoot 3.x 是首个强制要求 JDK 17的主版本。若强行降级到 SpringBoot 2.7.x支持 JDK 8/11将无法使用Observation注解做链路追踪、RetryableTopic做消息重试等现代运维能力。更关键的是SpringBoot 3.x 默认启用 Jakarta EE 9 命名空间如jakarta.servlet.*避免了旧版javax.*在 Tomcat 10 上的类加载冲突。检查你的pom.xml确认以下依赖存在parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.2.4/version !-- 注意必须 ≥3.0.0 -- relativePath/ /parent提示若mvn clean install报错java.lang.NoClassDefFoundError: javax/servlet/ServletContext说明你误用了 Tomcat 9 或更低版本。请升级至 Tomcat 10.1.x并确保spring-boot-starter-web依赖未被手动排除。2.2 MyBatis-Plus 的实体映射与动态 SQL 实战挂号系统最易被忽略的复杂度在于“时段冲突校验”。患者 A 预约了张医生 9:00-9:30患者 B 就不能再约同一时段。MyBatis-Plus 通过TableField和TableName完成基础映射但真正解决冲突的是其QueryWrapper动态构建能力。以AppointmentMapper.java中的冲突检测方法为例// AppointmentMapper.java public interface AppointmentMapper extends BaseMapperAppointment { // 自定义 SQL查询某医生在指定时间段内是否存在已预约记录 Select(SELECT COUNT(*) FROM appointment WHERE doctor_id #{doctorId} AND status IN (CONFIRMED, CHECKED_IN) AND start_time #{endTime} AND end_time #{startTime}) int countConflictingAppointments(Param(doctorId) Long doctorId, Param(startTime) LocalDateTime startTime, Param(endTime) LocalDateTime endTime); }该 SQL 直接嵌入 Mapper 接口避免 XML 文件冗余。参数#{startTime}使用 MyBatis 的预编译占位符防止 SQL 注入status IN (CONFIRMED, CHECKED_IN)精确过滤有效预约排除“已取消”记录。调用时传入LocalDateTime.now().plusHours(1)作为startTime即可校验未来 1 小时内是否可约。2.2.1 实体类中的时间字段处理陷阱Appointment.java中的startTime和endTime字段类型必须为LocalDateTime而非Date或StringTableField(start_time) private LocalDateTime startTime; // ✅ 正确支持时区无关的本地时间计算 TableField(end_time) private LocalDateTime endTime;若误用DateMyBatis-Plus 会将其序列化为毫秒时间戳导致跨时区显示错误如北京用户看到上海时间若用String则丧失数据库原生时间函数如DATE_ADD()能力。SpringBoot 3.x 默认配置spring.jackson.time-zoneGMT8但LocalDateTime不含时区信息因此所有时间计算应在应用层统一按东八区处理。2.3 多模块划分api、service、domain的职责边界项目目录结构中app.feac833a.css等前端资源文件暗示其采用前后端分离架构后端严格遵循分层规范模块职责关键类示例domain核心领域模型不含任何框架注解Patient.java,Doctor.java,TimeSlot.javaservice业务逻辑编排调用多个 MapperAppointmentService.java中的createAppointment()方法api控制器层处理 HTTP 请求与响应AppointmentController.java中的PostMapping(/appointments)AppointmentService.java中的挂号创建逻辑清晰体现分层价值Service public class AppointmentService { Autowired private AppointmentMapper appointmentMapper; Autowired private DoctorMapper doctorMapper; Autowired private TimeSlotMapper timeSlotMapper; Transactional // 事务控制覆盖整个挂号流程 public ResultAppointment createAppointment(Long patientId, Long doctorId, LocalDateTime slotTime) { // 1. 校验医生是否存在且在职 Doctor doctor doctorMapper.selectById(doctorId); if (doctor null || !doctor.getStatus().equals(ON_DUTY)) { return Result.fail(医生不存在或暂不接诊); } // 2. 校验时段是否可用调用 2.2 节的 countConflictingAppointments if (appointmentMapper.countConflictingAppointments(doctorId, slotTime, slotTime.plusMinutes(30)) 0) { return Result.fail(该时段已被预约请选择其他时间); } // 3. 创建预约记录 Appointment appointment new Appointment(); appointment.setPatientId(patientId); appointment.setDoctorId(doctorId); appointment.setStartTime(slotTime); appointment.setEndTime(slotTime.plusMinutes(30)); appointment.setStatus(PENDING); // 初始状态为待确认 appointmentMapper.insert(appointment); return Result.success(appointment); } }注意Transactional注解必须作用于public方法且由 Spring 容器代理调用。若在createAppointment()内部直接调用this.countConflictingAppointments()事务将失效。3. 挂号核心流程从时段选择到状态机驱动的预约生命周期3.1 科室-医生-时段三级联动的数据建模挂号页面需实现“选科室 → 选医生 → 选时段”的链式筛选这要求数据库表间存在明确关联表名主键关键外键业务含义departmentid—内科、外科等一级科室doctoriddepartment_id医生归属科室time_slotiddoctor_id医生每日可约时段如 9:00-9:30TimeSlot.java实体中doctorId字段必须标注TableField(doctor_id)否则 MyBatis-Plus 无法自动映射。前端发起请求时典型路径为# 1. 获取某科室下所有医生 GET /api/doctors?departmentId1 # 2. 获取某医生未来 7 天可约时段 GET /api/time-slots?doctorId101date2024-06-15后端TimeSlotController.java的实现需注意日期范围校验GetMapping(/time-slots) public ResultListTimeSlot getTimeSlots(RequestParam Long doctorId, RequestParam String date) { // 强制校验日期格式防止恶意输入 LocalDate parsedDate LocalDate.parse(date, DateTimeFormatter.ofPattern(yyyy-MM-dd)); // 限制查询范围仅允许查询未来 30 天内时段 if (parsedDate.isBefore(LocalDate.now()) || parsedDate.isAfter(LocalDate.now().plusDays(30))) { return Result.fail(日期超出可预约范围仅支持未来30天); } ListTimeSlot slots timeSlotService.getAvailableSlots(doctorId, parsedDate); return Result.success(slots); }3.1.1 时段数据初始化避免手动录入的自动化方案time_slot表不应依赖人工维护。项目中1-install.bat脚本实际执行init-time-slots.sql其核心逻辑是遍历每个在职医生为其生成未来 30 天的 8:00-12:00、13:00-17:00 两个班次每 30 分钟一个时段。SQL 示例INSERT INTO time_slot (doctor_id, date, start_time, end_time, status) SELECT d.id AS doctor_id, DATE_ADD(CURDATE(), INTERVAL n DAY) AS date, CONCAT(HOUR, :00:00) AS start_time, CONCAT(HOUR, :30:00) AS end_time, AVAILABLE AS status FROM doctor d CROSS JOIN ( SELECT 0 AS n UNION SELECT 1 UNION ... SELECT 29 ) days CROSS JOIN ( SELECT 8 AS HOUR UNION SELECT 9 UNION SELECT 10 UNION SELECT 11 UNION SELECT 13 UNION SELECT 14 UNION SELECT 15 UNION SELECT 16 ) hours WHERE d.status ON_DUTY AND DATE_ADD(CURDATE(), INTERVAL n DAY) DATE_ADD(CURDATE(), INTERVAL 30 DAY);此脚本在首次部署时运行一次后续由定时任务每日凌晨刷新次日时段。3.2 预约状态机从 PENDING 到 CHECKED_IN 的七种状态流转挂号不是静态记录而是状态持续演进的过程。项目定义了AppointmentStatus枚举public enum AppointmentStatus { PENDING, // 患者提交待医生确认 CONFIRMED, // 医生确认患者收到通知 CANCELLED, // 患者或医生主动取消 NO_SHOW, // 患者未按时就诊 CHECKED_IN, // 患者现场签到 IN_CONSULTATION, // 医生正在问诊 COMPLETED // 诊疗结束生成病历 }状态变更必须受控禁止直接UPDATE appointment SET statusCONFIRMED。AppointmentService.java提供专用方法public ResultString confirmAppointment(Long appointmentId) { Appointment appointment appointmentMapper.selectById(appointmentId); if (!appointment.getStatus().equals(PENDING)) { return Result.fail(仅可确认待确认状态的预约); } appointment.setStatus(CONFIRMED); appointmentMapper.updateById(appointment); // 发送短信/推送通知此处调用第三方 SDK notificationService.sendAppointmentConfirmed(appointment); return Result.success(确认成功); }3.2.1 状态变更的幂等性保障高并发下多次点击“确认预约”可能触发重复更新。解决方案是在updateById前加乐观锁// Appointment.java 中添加版本字段 TableField(version) private Integer version; // 更新时校验版本号 Appointment old appointmentMapper.selectById(appointmentId); if (old.getVersion() ! expectedVersion) { return Result.fail(预约已被他人操作请刷新页面); } old.setVersion(old.getVersion() 1); appointmentMapper.updateById(old); // MyBatis-Plus 自动注入 version 条件Version注解可替代手动管理但需确保数据库version字段初始值为 0。4. 支付与病历模块的可扩展设计及常见踩坑点4.1 支付回调的防重入与异步解耦PaymentController.java中的微信支付回调接口/api/pay/callback是高危入口必须处理重复通知PostMapping(/callback) public String handleWechatCallback(HttpServletRequest request) { try { // 1. 解析微信回调 XML String xmlData IOUtils.toString(request.getInputStream(), StandardCharsets.UTF_8); MapString, String notifyMap WXPayUtil.xmlToMap(xmlData); // 2. 验证签名关键 if (!WXPayUtil.isSignatureValid(notifyMap, your_mch_key)) { return xmlreturn_code![CDATA[FAIL]]/return_codereturn_msg![CDATA[签名失败]]/return_msg/xml; } // 3. 查询订单状态避免重复处理 String outTradeNo notifyMap.get(out_trade_no); Appointment appointment appointmentMapper.selectOne( new QueryWrapperAppointment().eq(order_no, outTradeNo) ); if (appointment null || appointment.getStatus().equals(PAID)) { return xmlreturn_code![CDATA[SUCCESS]]/return_codereturn_msg![CDATA[OK]]/return_msg/xml; } // 4. 更新预约状态并发送就诊提醒 appointment.setStatus(PAID); appointmentMapper.updateById(appointment); notificationService.sendAppointmentPaid(appointment); return xmlreturn_code![CDATA[SUCCESS]]/return_codereturn_msg![CDATA[OK]]/return_msg/xml; } catch (Exception e) { log.error(微信支付回调异常, e); return xmlreturn_code![CDATA[FAIL]]/return_codereturn_msg![CDATA[系统错误]]/return_msg/xml; } }提示WXPayUtil是微信官方 SDK 工具类isSignatureValid方法必须传入商户密钥mch_key该密钥在微信支付后台设置绝不可硬编码在代码中应存于application-prod.yml的加密配置项。4.2 病历记录的读写分离实践MedicalRecord.java实体包含大量文本字段主诉、现病史、诊断结果频繁读写影响性能。项目采用读写分离策略写库主库MySQL处理INSERT/UPDATE保证 ACID读库从库MySQL Slave专用于SELECT通过DS(slave)注解路由。Mapper public interface MedicalRecordMapper extends BaseMapperMedicalRecord { Select(SELECT * FROM medical_record WHERE patient_id #{patientId} ORDER BY created_time DESC LIMIT 10) DS(slave) // 显式指定从库 ListMedicalRecord selectLatestByPatient(Param(patientId) Long patientId); }若未配置多数据源DS注解无效。需在application.yml中声明spring: datasource: master: url: jdbc:mysql://master-db:3306/hospital?useSSLfalse username: root password: password slave: url: jdbc:mysql://slave-db:3306/hospital?useSSLfalse username: reader password: readonly1234.3 数据统计模块的轻量级实现不用 ETL用 SQL 窗口函数摘要中提到“预约数据分析”但项目未引入 ClickHouse 或 Druid。实际通过 MySQL 8.0 的窗口函数实现实时统计-- 统计各科室本周预约量 Top 5 SELECT d.name AS department_name, COUNT(a.id) AS appointment_count, ROUND(COUNT(a.id) * 100.0 / SUM(COUNT(a.id)) OVER(), 2) AS percentage FROM appointment a JOIN doctor doc ON a.doctor_id doc.id JOIN department d ON doc.department_id d.id WHERE a.created_time DATE_SUB(NOW(), INTERVAL 7 DAY) GROUP BY d.name ORDER BY appointment_count DESC LIMIT 5;SUM(COUNT(a.id)) OVER()是窗口函数无需子查询即可计算总占比。此 SQL 可直接在StatisticalService.java中通过Select执行避免 Java 层循环计算。5. 毕业设计答辩高频问题与代码级应答策略5.1 “如何保证高并发挂号不超卖”——从数据库到应用层的三重防护面试官常以此题考察技术深度。回答需分层展开每层附代码证据防护层实现方式代码位置关键参数数据库层time_slot表status字段加唯一索引schema.sqlUNIQUE KEY uk_doctor_date_start (doctor_id, date, start_time)应用层countConflictingAppointments()先查后插AppointmentMapper.javaSelect中start_time #{endTime} AND end_time #{startTime}缓存层Redis 锁控制单医生时段并发AppointmentService.javaRedisLock lock new RedisLock(slot_lock: doctorId _ slotTime);若项目未实现 Redis 锁可坦诚说明“当前设计已通过数据库唯一索引和应用层校验满足日均 5000 预约量需求若需支撑万级并发将在createAppointment()方法开头添加RedisTemplate.opsForValue().setIfAbsent()分布式锁。”5.2 “支付模块怎么对接微信/支付宝”——配置化接入的关键字段表答辩时需展示支付模块的可配置性而非硬编码。application.yml中应存在pay: wechat: app-id: wx1234567890abcdef mch-id: 1234567890 api-v3-key: your_api_v3_key_here # 32位密钥 notify-url: https://your-domain.com/api/pay/callback alipay: app-id: 2021000123456789 merchant-private-key: MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC... alipay-public-key: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu...注意merchant-private-key和alipay-public-key必须用\n替换换行符后填入 YAML否则 RSA 解密失败。例如MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...→MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...\n...5.3 “如何快速验证系统功能”——2-run.bat启动后的三步验证法不要只说“启动成功”要给出可立即执行的验证路径访问 Swagger UI启动后打开http://localhost:8080/swagger-ui/index.html测试POST /api/appointments接口传入 JSON{ patientId: 1, doctorId: 101, slotTime: 2024-06-15T09:00:00 }检查数据库登录 MySQL执行SELECT * FROM appointment WHERE patient_id 1 ORDER BY created_time DESC LIMIT 1;确认status为PENDING。触发支付回调用 Postman 模拟微信回调 XML观察appointment表中status是否变为PAID并检查notification_service日志是否有“支付成功通知已发送”。这三步能在 5 分钟内向答辩老师证明代码可运行、逻辑可验证、问题可追溯。本文还有配套的精品资源点击获取
