简介压缩包内含一套基于Java Web的医院预约挂号系统完整源码与数据库脚本主要面向正在学习Java EE、Servlet/JSP等技术的开发者以及需要完成课程设计或毕业设计的在校学生。系统围绕患者在线预约、科室医生管理、挂号信息查询等核心业务完整展示了从浏览器前端到服务器端再到MySQL数据库的交互流程。包内共577个文件核心包括55个Java源码文件、78个JSP动态页面、116个class编译文件同时提供SQL数据库脚本、CSS样式、JavaScript脚本、XML配置以及大量界面图片素材整个压缩包大小约14.75MB目录层次分明便于按模块查阅。目前已有2211人下载学习资源包含可直接导入的数据库初始化脚本和部署所需的关键配置文件能帮助使用者快速搭建运行环境并通过阅读源码理解MVC分层设计、数据库连接池配置、事务处理等实际开发重点。1. 基于 JAVA WEB 的医院预约挂号系统源码与数据库一次给全做 Java Web 课程设计或者毕业设计的人十有八九都卡在同一个地方业务逻辑不难但「环境搭不起来」和「数据库关系理不清」能把人磨到怀疑人生。这套基于 JAVA WEB 的医院预约挂号系统源码 数据库我拆完第一感觉就是——它把挂号系统最核心的排班发号、预约锁定、状态流转这几块都做成了能直接跑的工程SQL 脚本也是现成的。适合三类人要交课程设计的学生、想快速搭一个门诊预约 Demo 的初级开发、以及准备做中小型医院信息系统的朋友。它不是那种花架子后台而是老老实实用 JSP Servlet MySQL 撑起来的经典 Java Web 结构拿来改造成 Spring Boot 版本也很顺手。往下看我会把表设计、核心流程、部署步骤和几个让我翻过车的坑一次说清。2. 系统架构与数据库设计先把“号源模型”看明白再动手2.1 为什么是 JSP Servlet 而不是前后端分离这套系统用的是最经典的 Java Web 技术栈Servlet 处理请求、JSP 渲染页面、JDBC 连 MySQL。放在眼下看Spring Boot 确实更主流但这个选型有一个非常大的优势——结构足够透明。每个请求怎么进 Controller、怎么调 Service、怎么碰 DAO整个链路没有框架黑匣子干扰拿来学习或者应付答辩非常合适。如果你打算把它改造成 Spring Boot改造路径也很清晰web包里的 Servlet 对应Controllerservice包里已经是接口 实现类的写法dao包可以平移成 MyBatis 的 Mapper 接口。这套分层本身就不散说明原作者写的时候是有工程意识的。2.2 核心表结构十张表怎么串起预约闭环数据库脚本我建议先别急着跑花十分钟看明白表关系后面改功能会顺手很多。整套系统的表围绕「用户 → 科室 → 医生 → 排班 → 预约记录」这条主线设计关键的几张表是这样的表名核心字段作用userid, username, password, real_name, id_card, phone患者与管理员共用用 role 字段区分departmentid, dept_name, dept_desc科室信息doctorid, doctor_name, dept_id, title, intro医生归属科室scheduleid, doctor_id, work_date, shift_type, remain_num, total_num医生某天某个班次的号源池appointmentid, user_id, schedule_id, appoint_no, status, create_time患者与号源的关系记录ordersid, appoint_id, order_no, pay_amount, status订单与支付状态重点看schedule表里的remain_num和total_num这是整个系统防超卖的关键。初始化排班时total_num写死比如上午 30 个号每次成功预约一笔就UPDATE schedule SET remain_num remain_num - 1 WHERE id ? AND remain_num 0用 SQL 自身的条件来兜底而不是先在 Java 里查出来再判断这是老手写法。2.3 账户体系与角色权限一张 user 表怎么够用很多人第一次看到用户、管理员共用的设计会觉得不够规范但在这个资源里是够用的。user表通过role字段区分身份0 表示患者1 表示管理员。管理员登录后能进入后台管理界面做科室、医生、排班的增删改查患者端只能浏览、预约、查订单。如果你想让权限更安全一点建议加一层简单的拦截器或者 Filter按role值放行对应的 URL 前缀。比如/admin/*必须要求role 1否则直接重定向到登录页。这个是这套源码里比较薄的一环改造优先级排第一。3. 核心业务流程拆解从选科室到预约成功状态机是怎么转的3.1 排班数据怎么生成一次搞清楚天、班次、号源的三层关系排班是挂号系统的发动机。医生表只管「有哪些医生」真正决定患者能不能挂上号的是schedule表里的记录。一个医生同一天可以有两个班次上午和下午在表里就是两条work_date相同但shift_type不同的记录。生成排班数据的常见做法是写一个批量初始化方法循环医生和日期区间为每个医生每天插入 12 条班次记录。我一般会在插入前做个去重检查SELECT COUNT(*) FROM schedule WHERE doctor_id ? AND work_date ? AND shift_type ?查出来大于 0 就跳过避免管理员重复点击生成按钮时攒出一堆脏数据。从这个源码的数据库脚本来看排班记录是预置好的。如果你要自己维护建议把生成操作放到事务里执行先删掉某个日期范围内已存在的排班再重新插入。不然改排班规则时删一半留一半后面查号源会出现各种对不上。3.2 预约锁定为什么用事务 行锁而不是先查后改预约是整个系统并发压力最集中的地方。一个热门科室的号可能同时被几十个人抢如果你的逻辑是「先查余号 → 判断大于 0 → 插入预约记录 → 更新余号」那在高并发下必然超卖。正确做法是把判断和扣减合并成一条 SQLUPDATE schedule SET remain_num remain_num - 1 WHERE id #{scheduleId} AND remain_num 0;这条 SQL 执行完后通过affected rows判断是否扣减成功。影响行数为 1说明号源有余量继续插入预约记录影响行数为 0说明号源已经抢完直接返回“号源不足”。Java 侧的调用方式类似这样public synchronized boolean createAppointment(AppointmentDTO dto) { // 第一步尝试扣减号源 int rows scheduleMapper.decreaseRemainNum(dto.getScheduleId()); if (rows 0) { return false; // 号源不足直接失败 } // 第二步插入预约记录 Appointment appointment new Appointment(); appointment.setUserId(dto.getUserId()); appointment.setScheduleId(dto.getScheduleId()); appointment.setStatus(0); // 0 已预约待支付, 1 已完成, 2 已取消 appointmentMapper.insert(appointment); // 第三步生成订单待支付状态 orderMapper.insert(buildOrder(appointment.getId(), dto.getUserId())); return true; }这里说明三点。decreaseRemainNum的 SQL 就是前面那条带AND remain_num 0条件的 UPDATE它是整个方法的防线。synchronized在单机部署下能挡住并发但如果你以后做了多实例部署这个方法锁不住别的机器上的请求必须换成数据库行锁SELECT ... FOR UPDATE。第三步生成订单和第二步插入预约应该在同一事务里任何一个失败都要回滚否则会出现预约记录存在但订单为空的情况。3.3 状态流转预约、取消、就诊三个状态怎么管这套系统里的预约状态值得单独拎出来说因为它在边缘情况下的处理会直接影响数据准确性。appointment.status从 0 到 2分别是已预约待支付、已完成、已取消。而orders.status还要再管支付状态0 待支付、1 已支付、2 已退款。患者端取消预约时不能只改预约记录状态一定要同时恢复号源。也就是说取消操作必须带着一条反向的号源更新UPDATE schedule SET remain_num remain_num 1 WHERE id ?。如果漏了这一步系统会越跑越虚最后出现「数据库显示没号、但实际上大量患者取消了也没放回去」的怪象。医生端或管理员端把状态改成「已完成」之前应该校验两个条件患者确实挂了这个号、且就诊日期未过期。源码里对校验做了一部分但不是特别严格。你拿到代码后建议把状态变更的方法全部加一层校验逻辑避免从已取消状态直接跳到已完成这种非法状态转换。4. 环境搭建与部署从 JDK 到 Tomcat一步步把工程跑起来4.1 基础环境清单版本匹配是第一个坑这份源码的时间线应该在 Java 8 MySQL 5.7 时代。虽然 MySQL 8.0 也能跑但驱动和时区配置要额外处理我建议新手照下面的版本装能省掉很多玄学问题。组件建议版本说明JDK1.8不要装 11 或 17老代码对更高版本可能有兼容问题Tomcat8.5 或 9.0适配 Servlet 3.1 / 4.0Tomcat 10 不建议直接用MySQL5.78.0 也兼容但需要改连接串加时区参数IDEEclipse 或 IntelliJ IDEAEclipse 导入 Dynamic Web Project 更方便4.2 导入源码到 IDEA 的完整步骤源码包解压后通常是一个完整的 Web 工程目录结构包含src、web或WebContent、database或sql这几个关键目录。用 IDEA 导入时不要直接 Open应该走 Import 流程# 解压源码包 unzip hospital-appointment-system.zip # 查看核心目录结构 ls -la hospital-appointment-system/ # 确认包含 src、web、sql 三个核心目录IDEA 导入步骤是这样走的File - New - Project from Existing Sources选择解压后的根目录然后一路 Next。到了「Import Project from External Model」这一步如果项目里带着.classpath和.project文件选 Eclipse如果只有pom.xml选 Maven。这个项目如果是纯 Servlet 工程没有 Maven 配置就选 Eclipse 模式导入。导入完成后需要手动把web目录标记为 Web 资源根目录Project Structure - Facets - Web - Web Resource Directory指向工程里的web目录。漏了这一步JSP 页面找不到启动后会直接 404。4.3 数据库初始化与连接配置修改数据库脚本在sql目录下。连接配置在src/db.properties或者jdbc.properties里面的内容长这样jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456如果用的是 MySQL 8.0驱动类要换成com.mysql.cj.jdbc.Driver并且连接串里要追加serverTimezoneAsia/Shanghai否则启动时会报The server time zone value is unrecognized这个错卡了我一个小时。初始化数据库的操作在命令行或者 Navicat 里做都可以推荐命令行方式mysql -u root -p sql/hospital_db.sql这一步把表结构和预置数据一次性导入。完成后用SHOW TABLES;确认一下十张表都在然后再启动 Tomcat。管理员账号通常在预置数据里比如admin / admin123患者测试账号看user表里预置的记录。4.4 发布到 Tomcat 并启动IDEA 里配置 Tomcat 的方式Run - Edit Configurations - 左上角 - Tomcat Server - Local然后选 Application server 指向本机 Tomcat 安装目录。Deployment 选项卡里把hospital-appointment-system这个 artifact 加进去Application context 建议设为/启动后直接访问http://localhost:8080就是首页。如果启动时报端口被占用改 Tomcat 的server.xml里 Connector 的 port 属性或者用lsof -i:8080找出占用进程。查进程的命令# Linux / macOS 查端口占用 lsof -i:8080 # Windows 查端口占用 netstat -ano | findstr 80805. 避坑指南这套挂号系统最容易翻车的五个地方5.1 MySQL 8.0 驱动与时区导致启动失败现象Tomcat 启动时控制台抛异常提示The server time zone value xxx is unrecognized或者Communications link failure。原因MySQL 8.0 默认使用UTC时区而 JDBC 驱动在连接时没有拿到合法的时区信息直接拒绝建立连接。项目原配的com.mysql.jdbc.Driver在 8.0 里已废弃但不至于报错真正的问题在连接串缺serverTimezone。解决把连接串改成jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai同时把驱动类换成com.mysql.cj.jdbc.Driver并确保mysql-connector-java的 jar 包版本在 8.0 以上。5.2 预约超卖控制台查余号是 0但预约记录却多了一条现象数据库里schedule.remain_num已经是 0但appointment表里还能插入新记录。原因代码里先 SELECT 判断有余号再执行插入和 UPDATE中间没有事务包裹。两个请求同时通过 SELECT 判断都认为有号然后都执行插入号源就被超卖了。解决把扣减号源和插入预约放到同一个事务方法里并且扣减 SQL 必须带remain_num 0条件。我改完后习惯在测试环境用 JMeter 并发 50 个请求打同一个号源能用这种暴力方式验证修没修好。5.3 中文乱码插入数据库的数据全是问号现象页面表单提交的中文入库后变成???JSP 页面显示历史数据也是乱码。原因三层乱码叠加——JSP 页面编码不是 UTF-8、请求没有设置request.setCharacterEncoding(UTF-8)、JDBC 连接串没带characterEncodingutf8。很多老教程只处理了其中一层所以问题反复出现。解决在web.xml里配置一个全局编码过滤器filter filter-nameencodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping5.4 部署到 Tomcat 10 后 JSP 页面全部 500现象本地用 Tomcat 8.5 跑得好好的换到 Tomcat 10 直接白屏控制台报java.lang.ClassNotFoundException: javax.servlet.jsp.jstl.core.Config。原因Tomcat 10 把javax.servlet包迁移到了jakarta.servlet老项目的 JSP 和 JSTL 引用全部失效。这是包名级别的破坏性变更不是改一行配置能解决的。解决项目继续用 Tomcat 8.5 或 9.0不要上 10。如果非要用 Tomcat 10需要把代码里所有javax.servlet.*的 import 全局替换成jakarta.servlet.*工作量说大不大但容易漏掉 JSP 里的隐式引用。5.5 取消预约后号源不恢复越跑越虚现象患者取消预约后科室显示还有号但schedule.remain_num一直没有涨回去过一段时间余号明显对不上。原因取消预约的方法只更新了appointment.status没有同步执行remain_num 1。这是典型的只改业务表、不改资源表的问题。解决在取消预约的事务方法里两步必须同时执行Transactional public boolean cancelAppointment(int appointmentId, int scheduleId) { appointmentMapper.updateStatus(appointmentId, 2); // 已取消 scheduleMapper.increaseRemainNum(scheduleId); // 号源回补 return true; }从那次踩坑之后我每次处理这种「资源占用」类功能都会强制自己走一遍检查清单占用、释放、回补、异常回滚四件事一个都不能少。6. 进阶改造把登录态换成 JWT 用乐观锁彻底防超卖如果你拿着这套源码不只是为了跑通还想写进简历或者应对答辩追问我建议做两个改造登录态从 Session 换到 JWT、预约扣减号源从行锁换到乐观锁。这两件事做完整个系统的「现代感」和「抗并发」能力都上一个台阶。登录态改造的核心是引入jjwt库。用户登录成功后不再把用户信息塞进 Session而是生成一个 token 返回给前端前端每次请求在 Header 里带Authorization: Bearer token。服务端写一个JwtFilter拦截除登录接口外的所有请求String token request.getHeader(Authorization).replace(Bearer , ); Claims claims Jwts.parser() .setSigningKey(secretKey) .parseClaimsJws(token) .getBody(); request.setAttribute(userId, claims.get(userId));这样改完最大的好处是后端可以完全无状态以后要做负载均衡或者微服务拆分不需要搞 Session 复制。第二个改造是号源扣减的乐观锁方案。在schedule表增加一个version字段每次扣减时同时校验版本号UPDATE schedule SET remain_num remain_num - 1, version version 1 WHERE id #{scheduleId} AND remain_num 0 AND version #{oldVersion};Java 侧的做法是先 SELECT 出当前版本号执行 UPDATE 时用这个版本号做条件。如果影响行数为 0说明版本已经变了有人抢先修改了重新查询再试一次。表面上比synchronized麻烦但它是真正能在多实例部署下生效的方案。做完这两个改造建议顺手做一次功能验收先跑一遍完整的预约流程——注册、登录、选科室、选医生、选日期、提交预约、支付、取消确认状态流转和号源回补全部正确。再用 JMeter 起 100 个线程打同一个号源接口看最终生成的预约记录是否刚好等于total_num的值。这个验证跑完整个系统才算真正闭环。希望这些拆解和踩坑记录能帮到你拿到源码后照着步骤走一遍比我当初自己摸索省下至少半天时间。本文还有配套的精品资源点击获取 
长河君 · 2026/10/8 16:03:42 · 阅读 1.2k Java Web医院预约挂号系统全解析：源码+数据库+部署+避坑
简介压缩包内含一套基于Java Web的医院预约挂号系统完整源码与数据库脚本主要面向正在学习Java EE、Servlet/JSP等技术的开发者以及需要完成课程设计或毕业设计的在校学生。系统围绕患者在线预约、科室医生管理、挂号信息查询等核心业务完整展示了从浏览器前端到服务器端再到MySQL数据库的交互流程。包内共577个文件核心包括55个Java源码文件、78个JSP动态页面、116个class编译文件同时提供SQL数据库脚本、CSS样式、JavaScript脚本、XML配置以及大量界面图片素材整个压缩包大小约14.75MB目录层次分明便于按模块查阅。目前已有2211人下载学习资源包含可直接导入的数据库初始化脚本和部署所需的关键配置文件能帮助使用者快速搭建运行环境并通过阅读源码理解MVC分层设计、数据库连接池配置、事务处理等实际开发重点。1. 基于 JAVA WEB 的医院预约挂号系统源码与数据库一次给全做 Java Web 课程设计或者毕业设计的人十有八九都卡在同一个地方业务逻辑不难但「环境搭不起来」和「数据库关系理不清」能把人磨到怀疑人生。这套基于 JAVA WEB 的医院预约挂号系统源码 数据库我拆完第一感觉就是——它把挂号系统最核心的排班发号、预约锁定、状态流转这几块都做成了能直接跑的工程SQL 脚本也是现成的。适合三类人要交课程设计的学生、想快速搭一个门诊预约 Demo 的初级开发、以及准备做中小型医院信息系统的朋友。它不是那种花架子后台而是老老实实用 JSP Servlet MySQL 撑起来的经典 Java Web 结构拿来改造成 Spring Boot 版本也很顺手。往下看我会把表设计、核心流程、部署步骤和几个让我翻过车的坑一次说清。2. 系统架构与数据库设计先把“号源模型”看明白再动手2.1 为什么是 JSP Servlet 而不是前后端分离这套系统用的是最经典的 Java Web 技术栈Servlet 处理请求、JSP 渲染页面、JDBC 连 MySQL。放在眼下看Spring Boot 确实更主流但这个选型有一个非常大的优势——结构足够透明。每个请求怎么进 Controller、怎么调 Service、怎么碰 DAO整个链路没有框架黑匣子干扰拿来学习或者应付答辩非常合适。如果你打算把它改造成 Spring Boot改造路径也很清晰web包里的 Servlet 对应Controllerservice包里已经是接口 实现类的写法dao包可以平移成 MyBatis 的 Mapper 接口。这套分层本身就不散说明原作者写的时候是有工程意识的。2.2 核心表结构十张表怎么串起预约闭环数据库脚本我建议先别急着跑花十分钟看明白表关系后面改功能会顺手很多。整套系统的表围绕「用户 → 科室 → 医生 → 排班 → 预约记录」这条主线设计关键的几张表是这样的表名核心字段作用userid, username, password, real_name, id_card, phone患者与管理员共用用 role 字段区分departmentid, dept_name, dept_desc科室信息doctorid, doctor_name, dept_id, title, intro医生归属科室scheduleid, doctor_id, work_date, shift_type, remain_num, total_num医生某天某个班次的号源池appointmentid, user_id, schedule_id, appoint_no, status, create_time患者与号源的关系记录ordersid, appoint_id, order_no, pay_amount, status订单与支付状态重点看schedule表里的remain_num和total_num这是整个系统防超卖的关键。初始化排班时total_num写死比如上午 30 个号每次成功预约一笔就UPDATE schedule SET remain_num remain_num - 1 WHERE id ? AND remain_num 0用 SQL 自身的条件来兜底而不是先在 Java 里查出来再判断这是老手写法。2.3 账户体系与角色权限一张 user 表怎么够用很多人第一次看到用户、管理员共用的设计会觉得不够规范但在这个资源里是够用的。user表通过role字段区分身份0 表示患者1 表示管理员。管理员登录后能进入后台管理界面做科室、医生、排班的增删改查患者端只能浏览、预约、查订单。如果你想让权限更安全一点建议加一层简单的拦截器或者 Filter按role值放行对应的 URL 前缀。比如/admin/*必须要求role 1否则直接重定向到登录页。这个是这套源码里比较薄的一环改造优先级排第一。3. 核心业务流程拆解从选科室到预约成功状态机是怎么转的3.1 排班数据怎么生成一次搞清楚天、班次、号源的三层关系排班是挂号系统的发动机。医生表只管「有哪些医生」真正决定患者能不能挂上号的是schedule表里的记录。一个医生同一天可以有两个班次上午和下午在表里就是两条work_date相同但shift_type不同的记录。生成排班数据的常见做法是写一个批量初始化方法循环医生和日期区间为每个医生每天插入 12 条班次记录。我一般会在插入前做个去重检查SELECT COUNT(*) FROM schedule WHERE doctor_id ? AND work_date ? AND shift_type ?查出来大于 0 就跳过避免管理员重复点击生成按钮时攒出一堆脏数据。从这个源码的数据库脚本来看排班记录是预置好的。如果你要自己维护建议把生成操作放到事务里执行先删掉某个日期范围内已存在的排班再重新插入。不然改排班规则时删一半留一半后面查号源会出现各种对不上。3.2 预约锁定为什么用事务 行锁而不是先查后改预约是整个系统并发压力最集中的地方。一个热门科室的号可能同时被几十个人抢如果你的逻辑是「先查余号 → 判断大于 0 → 插入预约记录 → 更新余号」那在高并发下必然超卖。正确做法是把判断和扣减合并成一条 SQLUPDATE schedule SET remain_num remain_num - 1 WHERE id #{scheduleId} AND remain_num 0;这条 SQL 执行完后通过affected rows判断是否扣减成功。影响行数为 1说明号源有余量继续插入预约记录影响行数为 0说明号源已经抢完直接返回“号源不足”。Java 侧的调用方式类似这样public synchronized boolean createAppointment(AppointmentDTO dto) { // 第一步尝试扣减号源 int rows scheduleMapper.decreaseRemainNum(dto.getScheduleId()); if (rows 0) { return false; // 号源不足直接失败 } // 第二步插入预约记录 Appointment appointment new Appointment(); appointment.setUserId(dto.getUserId()); appointment.setScheduleId(dto.getScheduleId()); appointment.setStatus(0); // 0 已预约待支付, 1 已完成, 2 已取消 appointmentMapper.insert(appointment); // 第三步生成订单待支付状态 orderMapper.insert(buildOrder(appointment.getId(), dto.getUserId())); return true; }这里说明三点。decreaseRemainNum的 SQL 就是前面那条带AND remain_num 0条件的 UPDATE它是整个方法的防线。synchronized在单机部署下能挡住并发但如果你以后做了多实例部署这个方法锁不住别的机器上的请求必须换成数据库行锁SELECT ... FOR UPDATE。第三步生成订单和第二步插入预约应该在同一事务里任何一个失败都要回滚否则会出现预约记录存在但订单为空的情况。3.3 状态流转预约、取消、就诊三个状态怎么管这套系统里的预约状态值得单独拎出来说因为它在边缘情况下的处理会直接影响数据准确性。appointment.status从 0 到 2分别是已预约待支付、已完成、已取消。而orders.status还要再管支付状态0 待支付、1 已支付、2 已退款。患者端取消预约时不能只改预约记录状态一定要同时恢复号源。也就是说取消操作必须带着一条反向的号源更新UPDATE schedule SET remain_num remain_num 1 WHERE id ?。如果漏了这一步系统会越跑越虚最后出现「数据库显示没号、但实际上大量患者取消了也没放回去」的怪象。医生端或管理员端把状态改成「已完成」之前应该校验两个条件患者确实挂了这个号、且就诊日期未过期。源码里对校验做了一部分但不是特别严格。你拿到代码后建议把状态变更的方法全部加一层校验逻辑避免从已取消状态直接跳到已完成这种非法状态转换。4. 环境搭建与部署从 JDK 到 Tomcat一步步把工程跑起来4.1 基础环境清单版本匹配是第一个坑这份源码的时间线应该在 Java 8 MySQL 5.7 时代。虽然 MySQL 8.0 也能跑但驱动和时区配置要额外处理我建议新手照下面的版本装能省掉很多玄学问题。组件建议版本说明JDK1.8不要装 11 或 17老代码对更高版本可能有兼容问题Tomcat8.5 或 9.0适配 Servlet 3.1 / 4.0Tomcat 10 不建议直接用MySQL5.78.0 也兼容但需要改连接串加时区参数IDEEclipse 或 IntelliJ IDEAEclipse 导入 Dynamic Web Project 更方便4.2 导入源码到 IDEA 的完整步骤源码包解压后通常是一个完整的 Web 工程目录结构包含src、web或WebContent、database或sql这几个关键目录。用 IDEA 导入时不要直接 Open应该走 Import 流程# 解压源码包 unzip hospital-appointment-system.zip # 查看核心目录结构 ls -la hospital-appointment-system/ # 确认包含 src、web、sql 三个核心目录IDEA 导入步骤是这样走的File - New - Project from Existing Sources选择解压后的根目录然后一路 Next。到了「Import Project from External Model」这一步如果项目里带着.classpath和.project文件选 Eclipse如果只有pom.xml选 Maven。这个项目如果是纯 Servlet 工程没有 Maven 配置就选 Eclipse 模式导入。导入完成后需要手动把web目录标记为 Web 资源根目录Project Structure - Facets - Web - Web Resource Directory指向工程里的web目录。漏了这一步JSP 页面找不到启动后会直接 404。4.3 数据库初始化与连接配置修改数据库脚本在sql目录下。连接配置在src/db.properties或者jdbc.properties里面的内容长这样jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456如果用的是 MySQL 8.0驱动类要换成com.mysql.cj.jdbc.Driver并且连接串里要追加serverTimezoneAsia/Shanghai否则启动时会报The server time zone value is unrecognized这个错卡了我一个小时。初始化数据库的操作在命令行或者 Navicat 里做都可以推荐命令行方式mysql -u root -p sql/hospital_db.sql这一步把表结构和预置数据一次性导入。完成后用SHOW TABLES;确认一下十张表都在然后再启动 Tomcat。管理员账号通常在预置数据里比如admin / admin123患者测试账号看user表里预置的记录。4.4 发布到 Tomcat 并启动IDEA 里配置 Tomcat 的方式Run - Edit Configurations - 左上角 - Tomcat Server - Local然后选 Application server 指向本机 Tomcat 安装目录。Deployment 选项卡里把hospital-appointment-system这个 artifact 加进去Application context 建议设为/启动后直接访问http://localhost:8080就是首页。如果启动时报端口被占用改 Tomcat 的server.xml里 Connector 的 port 属性或者用lsof -i:8080找出占用进程。查进程的命令# Linux / macOS 查端口占用 lsof -i:8080 # Windows 查端口占用 netstat -ano | findstr 80805. 避坑指南这套挂号系统最容易翻车的五个地方5.1 MySQL 8.0 驱动与时区导致启动失败现象Tomcat 启动时控制台抛异常提示The server time zone value xxx is unrecognized或者Communications link failure。原因MySQL 8.0 默认使用UTC时区而 JDBC 驱动在连接时没有拿到合法的时区信息直接拒绝建立连接。项目原配的com.mysql.jdbc.Driver在 8.0 里已废弃但不至于报错真正的问题在连接串缺serverTimezone。解决把连接串改成jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai同时把驱动类换成com.mysql.cj.jdbc.Driver并确保mysql-connector-java的 jar 包版本在 8.0 以上。5.2 预约超卖控制台查余号是 0但预约记录却多了一条现象数据库里schedule.remain_num已经是 0但appointment表里还能插入新记录。原因代码里先 SELECT 判断有余号再执行插入和 UPDATE中间没有事务包裹。两个请求同时通过 SELECT 判断都认为有号然后都执行插入号源就被超卖了。解决把扣减号源和插入预约放到同一个事务方法里并且扣减 SQL 必须带remain_num 0条件。我改完后习惯在测试环境用 JMeter 并发 50 个请求打同一个号源能用这种暴力方式验证修没修好。5.3 中文乱码插入数据库的数据全是问号现象页面表单提交的中文入库后变成???JSP 页面显示历史数据也是乱码。原因三层乱码叠加——JSP 页面编码不是 UTF-8、请求没有设置request.setCharacterEncoding(UTF-8)、JDBC 连接串没带characterEncodingutf8。很多老教程只处理了其中一层所以问题反复出现。解决在web.xml里配置一个全局编码过滤器filter filter-nameencodingFilter/filter-name filter-classorg.apache.catalina.filters.SetCharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping5.4 部署到 Tomcat 10 后 JSP 页面全部 500现象本地用 Tomcat 8.5 跑得好好的换到 Tomcat 10 直接白屏控制台报java.lang.ClassNotFoundException: javax.servlet.jsp.jstl.core.Config。原因Tomcat 10 把javax.servlet包迁移到了jakarta.servlet老项目的 JSP 和 JSTL 引用全部失效。这是包名级别的破坏性变更不是改一行配置能解决的。解决项目继续用 Tomcat 8.5 或 9.0不要上 10。如果非要用 Tomcat 10需要把代码里所有javax.servlet.*的 import 全局替换成jakarta.servlet.*工作量说大不大但容易漏掉 JSP 里的隐式引用。5.5 取消预约后号源不恢复越跑越虚现象患者取消预约后科室显示还有号但schedule.remain_num一直没有涨回去过一段时间余号明显对不上。原因取消预约的方法只更新了appointment.status没有同步执行remain_num 1。这是典型的只改业务表、不改资源表的问题。解决在取消预约的事务方法里两步必须同时执行Transactional public boolean cancelAppointment(int appointmentId, int scheduleId) { appointmentMapper.updateStatus(appointmentId, 2); // 已取消 scheduleMapper.increaseRemainNum(scheduleId); // 号源回补 return true; }从那次踩坑之后我每次处理这种「资源占用」类功能都会强制自己走一遍检查清单占用、释放、回补、异常回滚四件事一个都不能少。6. 进阶改造把登录态换成 JWT 用乐观锁彻底防超卖如果你拿着这套源码不只是为了跑通还想写进简历或者应对答辩追问我建议做两个改造登录态从 Session 换到 JWT、预约扣减号源从行锁换到乐观锁。这两件事做完整个系统的「现代感」和「抗并发」能力都上一个台阶。登录态改造的核心是引入jjwt库。用户登录成功后不再把用户信息塞进 Session而是生成一个 token 返回给前端前端每次请求在 Header 里带Authorization: Bearer token。服务端写一个JwtFilter拦截除登录接口外的所有请求String token request.getHeader(Authorization).replace(Bearer , ); Claims claims Jwts.parser() .setSigningKey(secretKey) .parseClaimsJws(token) .getBody(); request.setAttribute(userId, claims.get(userId));这样改完最大的好处是后端可以完全无状态以后要做负载均衡或者微服务拆分不需要搞 Session 复制。第二个改造是号源扣减的乐观锁方案。在schedule表增加一个version字段每次扣减时同时校验版本号UPDATE schedule SET remain_num remain_num - 1, version version 1 WHERE id #{scheduleId} AND remain_num 0 AND version #{oldVersion};Java 侧的做法是先 SELECT 出当前版本号执行 UPDATE 时用这个版本号做条件。如果影响行数为 0说明版本已经变了有人抢先修改了重新查询再试一次。表面上比synchronized麻烦但它是真正能在多实例部署下生效的方案。做完这两个改造建议顺手做一次功能验收先跑一遍完整的预约流程——注册、登录、选科室、选医生、选日期、提交预约、支付、取消确认状态流转和号源回补全部正确。再用 JMeter 起 100 个线程打同一个号源接口看最终生成的预约记录是否刚好等于total_num的值。这个验证跑完整个系统才算真正闭环。希望这些拆解和踩坑记录能帮到你拿到源码后照着步骤走一遍比我当初自己摸索省下至少半天时间。本文还有配套的精品资源点击获取