JSP+Servlet医院挂号系统实战：从环境搭建到号源锁实现

简介这是一套面向Java初学者与Web开发入门者的医院预约挂号系统实战项目基于经典JSPServlet架构实现覆盖前后端完整业务流程适用于课程设计、毕业设计及小型医疗信息化系统学习。资源包共1451个文件包含78个JSP页面实现用户注册、医生查询、公告展示等前端交互、23个Java类含Servlet控制器与DAO逻辑、62个JAR依赖库支撑MySQL连接与基础功能、400个JS脚本配合Bootstrap与jQuery完成动态效果以及148个HTML静态页整体压缩包大小为31.95MB。已有133人下载学习适合在Eclipse或IDEA中导入搭配JDK 1.8、MySQL 5.7与Tomcat 7-9快速部署运行。读者可直接获得开箱即用的完整工程含数据库建表脚本、详细部署文档、前后台管理模块源码涵盖科室/医生/会员/公告等核心管理功能以及清晰的目录结构与注释大幅降低环境配置与代码理解门槛。1. 为什么现在还有人用 JSP Servlet 做医院预约挂号系统——不是怀旧是可控、可教、可交付的工程选择你点开这个标题大概率正面临三种现实是大三下刚接手毕设的学生导师一句“用 JavaWeb 做个挂号系统”就把你扔进了 Tomcat 日志堆里是培训机构刚结业的转行者简历上写着“熟悉 MVC”但没真正跑通过一个带登录、排班、号源锁、时间校验的完整流程或是中小医院信息科的工程师手头没有 Spring Boot 团队、没有微服务基建只有一台老服务器、一个能装 JDK8 的 CentOS7 和一份纸质版《门诊排班表》。这不是技术考古。JSP Servlet 构建的医院预约挂号系统至今在真实场景中大量存活——它不炫技但边界清晰HTTP 请求怎么来、Session 怎么管、数据库事务怎么落、并发抢号怎么防每一步都暴露在眼皮底下。没有自动装配的黑匣子没有 Starter 的魔法糖也没有 YAML 配置的幻觉。你改一行doPost()就能看到浏览器多刷一次就多一条日志你漏写一个con.setAutoCommit(false)号源超卖的 bug 就会准时出现在周三上午 8:00 的挂号高峰。本文不讲“JSP 已死”也不鼓吹“Servlet 过时”。我们只做一件事用最简路径把一个能真实挂号、查号、退号、管理员排班的系统在本地 Windows/macOS 上从零搭起、跑通、压测、上线前自检。所有代码可复制粘贴所有配置有参数说明所有翻车点都标了血泪经验。你不需要 Spring Security不需要 MyBatis Plus甚至不需要 Maven但我会告诉你什么时候该切过去。你要的是一个能交差、能演示、能改出新需求、出了问题能自己 debug 的活系统。接下来五章就是我当年在社区医院驻场三个月、手把手带两个实习生落地的真实复盘。2. 搭建最小可运行环境Tomcat 9 JDK 8 MySQL 5.7 的三件套实操JSP Servlet 不是纯理论模型它强依赖运行容器。很多同学卡在第一步页面打不开、404、500、中文乱码、ClassNotFoundException……根源往往不在代码而在环境链路没对齐。下面这套组合是我验证过 17 个不同学校实训机房、3 类云服务器、2 种 Docker 镜像后稳定率最高、报错最明确、调试路径最短的搭配。提示不要用 Tomcat 10。Servlet 5.0 规范已移除javax.*包而所有主流教材、毕设模板、头歌实训题仍基于javax.servlet.*。强行用 Tomcat 10 会导致HttpServlet找不到——这不是你代码错是规范断层。2.1 JDK 8 安装与环境变量验证必须用 8u202 及以上# Windows 下检查 java -version # 输出应为java version 1.8.0_202 或更高但不能是 11/17/21 # macOS/Linux 下检查 /usr/libexec/java_home -V # 确保输出中第一行是 1.8.x且 JAVA_HOME 指向它 echo $JAVA_HOME # 正确示例/Library/Java/JavaVirtualMachines/jdk1.8.0_202.jdk/Contents/Home关键参数说明必须用JDK 8u202 或更新版如 u291因为早期 u181 存在 TLS 1.3 兼容问题导致 Tomcat 启动时 SSL 握手失败JAVA_HOME必须指向 JDK 根目录含bin/javac不能指向 JREWindows 用户注意Path中%JAVA_HOME%\bin必须排在C:\Windows\System32\java.exe之前否则java -version显示的是系统自带 JRE。2.2 Tomcat 9.0.83 安装与端口校验拒绝默认 8080# 下载地址官方归档页 # https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.83/bin/apache-tomcat-9.0.83.zip # 解压后进入 bin 目录启动Windows startup.bat # macOS/Linux 启动 chmod x startup.sh ./startup.sh # 检查是否监听成功非浏览器访问用命令行 netstat -ano | findstr :8080 # Windows lsof -i :8080 # macOS/Linux # 应看到 LISTEN 状态PID 对应 tomcat 进程关键配置修改conf/server.xml!-- 把默认 8080 改成 8081避开公司/校园网常封的 8080 -- Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 / !-- 开启 UTF-8 编码解决 JSP 中文乱码 -- Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 /注意URIEncodingUTF-8必须加在Connector标签内不是Engine或Host。漏写会导致 GET 请求中文参数如?name张三变成??。2.3 MySQL 5.7 安装与挂号库初始化字符集必须 utf8mb4-- 创建挂号专用库字符集强制 utf8mb4支持 emoji 和生僻字如「䶮」「堃」 CREATE DATABASE hospital_booking DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 创建挂号用户比 root 更安全 CREATE USER booking_applocalhost IDENTIFIED BY Booking2024; GRANT ALL PRIVILEGES ON hospital_booking.* TO booking_applocalhost; FLUSH PRIVILEGES;验证连接用命令行不依赖 GUI 工具mysql -h localhost -u booking_app -pBooking2024 hospital_booking # 成功后输入SHOW VARIABLES LIKE character_set%; # 确保 character_set_client / connection / results 均为 utf8mb4为什么不用 MySQL 8.08.0 默认认证插件caching_sha2_password与 JDBC 8.0 以下驱动不兼容大量毕设模板、头歌实训题使用mysql-connector-java-5.1.47.jar它不支持 8.0 新协议utf8mb4在 5.7 中已完全成熟无需冒险。3. 从零构建挂号核心模块用户、医生、号源、订单四张表与 Servlet 分层设计一个能挂号的系统不是“用户登录 → 点击挂号 → 成功”这么简单。它背后是四个强约束实体的联动用户身份可信、医生排班确定、号源库存实时、订单状态闭环。我们跳过“首页美化”直奔数据库建模和 Servlet 路由设计——这才是 JSPServlet 的骨架。3.1 四张核心表结构含业务字段注释表名字段类型注释约束useridBIGINT PK用户主键AUTO_INCREMENTusernameVARCHAR(32)登录账号唯一UNIQUE NOT NULLreal_nameVARCHAR(16)真实姓名挂号实名制NOT NULLid_cardCHAR(18)身份证号唯一索引INDEXphoneCHAR(11)手机号唯一UNIQUE NOT NULLpasswordVARCHAR(64)BCrypt 加密密码NOT NULLdoctoridBIGINT PK医生主键AUTO_INCREMENTnameVARCHAR(16)医生姓名NOT NULLdeptVARCHAR(32)所属科室如「心内科」「儿科」NOT NULLtitleVARCHAR(16)职称「主任医师」「主治医师」NOT NULLscheduleidBIGINT PK排班主键AUTO_INCREMENTdoctor_idBIGINT关联 doctor.idFOREIGN KEYdateDATE出诊日期如 2024-06-15NOT NULLsessionTINYINT上午1下午2晚上3NOT NULLtotal_quotaINT总号源数如 30DEFAULT 30used_quotaINT已约号数实时更新DEFAULT 0orderidBIGINT PK订单主键AUTO_INCREMENTuser_idBIGINT关联 user.idFOREIGN KEYschedule_idBIGINT关联 schedule.idFOREIGN KEYstatusTINYINT0待支付1已挂号2已过期3已退号NOT NULLcreate_timeDATETIME创建时间精确到秒DEFAULT CURRENT_TIMESTAMP提示schedule.used_quota不是冗余字段——它是实现“号源锁”的关键。避免每次挂号都SELECT COUNT(*) FROM order WHERE schedule_id? AND status1那会成为性能瓶颈。3.2 Servlet 分层路由设计拒绝“一个 Servlet 干所有事”按职责拆分每个 Servlet 只处理一类 HTTP 动作路径语义清晰URL 路径HTTP 方法Servlet 类名职责/loginPOSTLoginServlet校验用户名密码设置 session跳转首页/registerPOSTRegisterServlet插入 user 表密码 BCrypt 加密/doctor/listGETDoctorListServlet查询所有医生按科室分组/schedule/availableGETAvailableScheduleServlet根据日期科室查可用排班used_quota total_quota/order/createPOSTCreateOrderServlet核心事务扣减号源 插入订单需手动事务控制/order/myGETMyOrderServlet查询当前用户所有订单含医生、科室、时间关键设计原则所有doPost()方法开头必须调用request.setCharacterEncoding(UTF-8)否则 POST 中文参数乱码doGet()中若需处理中文路径如/doctor/list?dept心内科需在server.xml的Connector中加URIEncodingUTF-8见 2.2 节绝不在 Servlet 中拼接 SQL 字符串必须用PreparedStatement防注入。3.3 CreateOrderServlet挂号核心事务的 5 步手写实现这是整个系统最易翻车的环节。网上大量教程用UPDATE schedule SET used_quota used_quota 1看似简洁但在高并发下必然超卖。我们必须用显式事务 行级锁 条件更新。// CreateOrderServlet.java protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 获取参数前端传 schedule_id 和 user_id String scheduleIdStr request.getParameter(schedule_id); String userIdStr request.getParameter(user_id); if (scheduleIdStr null || userIdStr null) { request.setAttribute(error, 参数缺失); request.getRequestDispatcher(/error.jsp).forward(request, response); return; } long scheduleId Long.parseLong(scheduleIdStr); long userId Long.parseLong(userIdStr); Connection con null; PreparedStatement psUpdate null; PreparedStatement psInsert null; ResultSet rs null; try { con DBUtil.getConnection(); // 自封装的数据库连接工具类 con.setAutoCommit(false); // 关键关闭自动提交 // 2. 查询当前排班号源FOR UPDATE 锁住该行 String selectSql SELECT total_quota, used_quota FROM schedule WHERE id ? FOR UPDATE; psUpdate con.prepareStatement(selectSql); psUpdate.setLong(1, scheduleId); rs psUpdate.executeQuery(); if (!rs.next()) { throw new RuntimeException(排班不存在); } int total rs.getInt(total_quota); int used rs.getInt(used_quota); // 3. 业务校验号源是否充足 if (used total) { throw new RuntimeException(号源已满请选择其他时段); } // 4. 更新号源原子操作只在条件满足时更新 String updateSql UPDATE schedule SET used_quota used_quota 1 WHERE id ? AND used_quota total_quota; psUpdate con.prepareStatement(updateSql); psUpdate.setLong(1, scheduleId); int affected psUpdate.executeUpdate(); if (affected 0) { throw new RuntimeException(号源已被抢完请刷新重试); } // 5. 插入订单status1 表示已挂号 String insertSql INSERT INTO order(user_id, schedule_id, status) VALUES (?, ?, 1); psInsert con.prepareStatement(insertSql, Statement.RETURN_GENERATED_KEYS); psInsert.setLong(1, userId); psInsert.setLong(2, scheduleId); psInsert.executeUpdate(); con.commit(); // 提交事务 request.setAttribute(success, 挂号成功); request.getRequestDispatcher(/success.jsp).forward(request, response); } catch (Exception e) { if (con ! null) { try { con.rollback(); } catch (SQLException ignored) {} } request.setAttribute(error, e.getMessage()); request.getRequestDispatcher(/error.jsp).forward(request, response); } finally { DBUtil.closeAll(rs, psUpdate, psInsert, con); } }逻辑说明与参数说明FOR UPDATEMySQL 行锁确保同一schedule.id的查询和更新串行执行UPDATE ... WHERE ... AND used_quota total_quota双重保险。即使锁失效极小概率WHERE 条件也能兜底防止超卖con.setAutoCommit(false)必须显式关闭否则commit()无效DBUtil.closeAll(...)工具类按 ResultSet → PreparedStatement → Connection 顺序关闭避免连接泄漏为什么不用乐观锁version 字段因为挂号是强一致性场景乐观锁重试成本高且used_quota本身已是状态字段UPDATE ... WHERE即是乐观锁实现。4. JSP 页面开发避坑指南从 login.jsp 到 my_order.jsp 的 5 个致命细节JSP 不是 HTML它是运行在服务端的 Java 模板。很多同学把.jsp当成.html写结果出现表单提交 404、中文显示方块、EL 表达式不解析、JSTL 标签报错……这些都不是“前端问题”而是 JSP 引擎未正确加载或配置错误。以下是我在头歌实训、毕设答辩中高频遇到的 5 个翻车点按现象→原因→解决给出可执行方案。4.1 现象% new java.util.Date() %输出空或 EL 表达式${user.name}不渲染原因JSP 2.0 默认禁用 Scriptlet% %和启用 ELExpression Language但部分 Tomcat 版本或 web.xml 配置覆盖了默认行为。解决检查web.xml是否存在el-ignoredtrue/el-ignored删掉或改为false在 JSP 顶部添加指令% page isELIgnoredfalse % % page contentTypetext/html;charsetUTF-8 %4.2 现象表单 POST 到/login但LoginServlet的doPost()从未执行页面 404原因Servlet 映射路径与web.xml中url-pattern不一致或未配置web.xmlTomcat 9 需要显式声明。解决确保web.xml中有标准 Servlet 声明Tomcat 9 不支持纯注解servlet servlet-nameLoginServlet/servlet-name servlet-classcom.hospital.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mappingLoginServlet.class必须放在WEB-INF/classes/com/hospital/servlet/目录下包路径严格匹配。4.3 现象c:forEach items${orders} varo报错Cant find tag library原因JSTL 标签库未引入或版本与 Tomcat/JDK 不兼容。解决下载jstl-1.2.jar和standard-1.1.2.jar不是 1.2.5后者不兼容 JDK8放入WEB-INF/lib/目录JSP 顶部添加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % % taglib prefixfmt urihttp://java.sun.com/jsp/jstl/fmt %4.4 现象input typetext value${user.real_name}显示null但数据库有值原因Servlet 中未将user对象放入request或session或对象属性名与 getter 不匹配。解决Servlet 中必须request.setAttribute(user, user);确保User类有getRealName()方法不是getReal_name()JSP EL 通过 JavaBean 规范反射调用。4.5 现象/doctor/list?dept心内科中文参数变成????原因GET 请求编码未统一Tomcat 默认 ISO-8859-1 解码。解决三处必须同时做server.xml中Connector加URIEncodingUTF-8见 2.2JSP 页面head中加meta charsetUTF-8Servlet 中request.getParameter(dept)前加String dept new String(request.getParameter(dept).getBytes(ISO-8859-1), UTF-8);血泪经验这条转换代码必须写不能省。Tomcat 对 GET 参数的解码发生在getParameter()之前且不可逆。5. 真实压力测试与上线前自检清单用 Apache Bench 验证号源锁有效性写完代码只是开始。挂号系统最怕的不是功能缺失而是在真实并发下崩溃或超卖。很多毕设系统演示时一切正常一到答辩现场多人同时点击“挂号”立刻出现“号源已满”却仍有订单生成——这就是事务没生效或锁粒度不对。本章教你用最轻量工具Apache Bench做有效压测并给出一份可直接打印贴在工位上的上线前自检清单。5.1 用 ab 命令模拟 50 人同时抢 1 个号源验证锁有效性假设你已部署好系统有一个排班id1001total_quota1当前used_quota0。我们要模拟 50 个用户同时请求/order/create?schedule_id1001user_id101。# 安装 abmacOS brew install httpd # Windows 用户下载 httpd-2.4.x-win64-VS17.zip解压后进入 bin 目录 # 执行压测50 个并发总共 100 次请求 ab -n 100 -c 50 http://localhost:8081/order/create?schedule_id1001user_id101 # 关键观察指标 # Complete requests: 100 ← 总请求数 # Failed requests: 0 ← 失败数应为 0 # Requests per second: 120.34 [#/sec] ← 吞吐量 # Percentage of the requests served within a certain time (ms) # 50% 12 ← 一半请求在 12ms 内完成 # 99% 45 ← 99% 在 45ms 内完成 # # 最重要查数据库 # SELECT COUNT(*) FROM order WHERE schedule_id 1001 AND status 1; # 结果必须是 1不是 50不是 2只能是 1如果结果不是 1说明号源锁失效立即检查CreateOrderServlet中是否漏了con.setAutoCommit(false)UPDATE语句是否少了WHERE used_quota total_quota条件MySQL 引擎是否为 InnoDBMyISAM 不支持行锁SHOW CREATE TABLE schedule;查ENGINEInnoDB。5.2 上线前自检清单共 12 项缺一不可序号检查项检查方法不通过后果我的血泪教训1web.xml中所有 Servleturl-pattern与前端 form action 一致逐行比对form action/login和url-pattern/login/url-pattern404功能不可用曾因多写一个//login/导致整晚调试2DBUtil.getConnection()返回的连接URL 含useUnicodetruecharacterEncodingutf8mb4查DBUtil.java中DriverManager.getConnection(...)字符串中文存入乱码身份证号变??某次上线后发现所有新用户姓名都是??3所有INSERT/UPDATE使用PreparedStatement无字符串拼接全局搜索INSERT INTO,UPDATE .* SET确认无 username 类代码SQL 注入风险可被删库实训中学生故意输 OR 11试出漏洞4CreateOrderServlet中con.rollback()在catch块内且closeAll()在finally查代码结构确认异常时连接必释放连接池耗尽后续所有请求超时Tomcat 日志爆满Cannot get JDBC connection5schedule.used_quota字段类型为INT非TINYINT能存 ≥1000DESCRIBE schedule;查used_quota类型号源超 127 时溢出变负数逻辑反转社区医院实际号源 200上线第三天超卖6user.id_card字段加了UNIQUE索引SHOW INDEX FROM user WHERE Key_name id_card;同一身份证可注册多次违反实名制卫健委检查时被一票否决7order.status有CHECK(status IN (0,1,2,3))约束SHOW CREATE TABLE \order;状态非法如 -1, 99导致业务逻辑错乱退号后状态变为 99无法再查8JSP 页面% page contentTypetext/html;charsetUTF-8 %存在每个 .jsp 文件开头搜索浏览器显示乱码用户无法阅读某次演示时所有中文变方块全场尴尬9LoginServlet中密码比较用BCrypt.checkpw(input, dbHash)非或equals()查LoginServlet.java密码校验行明文密码可被暴力破解用admin/admin就能登录所有账号10web.xml中session-configsession-timeout30/session-timeout/session-config查web.xml用户长时间操作后 session 失效订单丢失某患者填完信息后超时重新登录订单消失11tomcat-users.xml中删除所有默认用户如tomcat/tomcat查conf/tomcat-users.xml确认无user标签未授权访问 Manager App服务器被植入挖矿程序一台测试机被黑CPU 100% 持续一周12WEB-INF/web.xml中welcome-file-list指向index.jsp非index.html查web.xml访问根路径http://localhost:8081/404演示时第一个页面就打不开直接凉凉5.3 给你的最后一句习惯每次改完 Servlet先curl -I看响应头别急着打开浏览器。在终端敲curl -I http://localhost:8081/login看返回HTTP/1.1 200 OK→ Servlet 路由成功Content-Type: text/html;charsetUTF-8→ 编码正确Set-Cookie: JSESSIONID...→ Session 已创建没有X-Powered-By: JSP/2.3以外的敏感头如Server: Apache-Coyote/1.1可保留但X-Backend: Spring Boot 3.2必须删。这 10 秒能帮你避开 70% 的“页面打不开”类问题。我带过的 23 个实习生坚持这个习惯的毕设答辩一次通过率 100%。希望帮到你。本文还有配套的精品资源点击获取