JavaWeb医院预约挂号系统（Servlet+JSP+JDBC原生栈）

简介这是一套面向Java初学者与高校计算机专业学生的医院预约挂号管理系统实战项目适用于JavaWeb课程设计、期末大作业及毕业设计参考。系统基于ServletJSPMySQL开发完整实现患者挂号、医生排班、科室管理、预约查询与后台审核等核心业务流程代码纯手写、逻辑清晰、注释充分已通过教师指导并获95分以上高分评价小白可直接编译运行、快速上手。资源包共343个文件含60个Java后端类、54个前端页面模板.flt、11个XML配置文件、11个CSS样式表含layui.min.css、layer.css等主流UI组件、9个JS交互脚本以及SQL数据库脚本和多张系统界面截图PNG/JPG整体8.94MB结构规范、模块划分明确。目前已有542人学习下载配套资源即开即用包含可直接导入的MySQL数据库、完整前后端源码、响应式页面及典型业务场景的实现细节是巩固Servlet生命周期、MVC分层、会话管理与数据库连接池等关键知识点的优质实践案例。1. 这不是又一个“Hello World”项目一套能直接跑通、老师点头、答辩不卡壳的 JavaWeb 医院预约挂号系统含完整数据库LayUI 前端95分实测记录你是不是也经历过——期末前两周JavaWeb 课程设计选题卡在「做点什么」上网上搜“医院预约挂号系统”90% 是只有截图没源码、有源码但缺数据库、有数据库但表结构错乱、或者用 Spring Boot 写的——可老师明确要求必须是 Servlet JSP JDBC 原生栈禁用框架。更扎心的是部署到 Tomcat 后首页 404控制台报ClassNotFoundException: com.mysql.cj.jdbc.Driver改了三遍web.xml还是连不上库……这套「基于 JavaWeb 的医院预约挂号管理系统源码数据库95分以上大作业.zip」就是专治这种焦虑的。它不是 Demo是真实通过高校计算机系课程设计答辩、获教师手写评语“逻辑清晰、界面规范、数据库设计合理”的完整工程包后端纯 Servlet/JSP 实现挂号、排班、医生管理、患者登录前端全量使用 LayUI非 Bootstrap 或 VueMySQL 数据库含 8 张表user,doctor,schedule,appointment,department,admin,log,notice字段命名规范、外键约束完整、附建表 SQL 和初始化数据含 3 位医生、5 个科室、20 条模拟号源所有 CSS 文件layui.min.css,all.min.css,secondary.css,normalize.css,layer.css,index.css,main.css,laydate.css,style.css,css.css已按实际路径归位无引用缺失。小白照着 README 三步走解压 → 配置 MySQL 账号密码 → 启动 Tomcat就能看到带日历选号、科室筛选、实时余号显示的挂号页——不是静态页面是真能提交、真能查记录、真能删预约的闭环系统。适合 JavaWeb 初学者快速交差也适合想补全原生 Web 开发链路的转岗者复盘细节。2. 从零启动环境配置、数据库导入与 Tomcat 部署全流程含 JDK 8/Tomcat 9/MySQL 5.7 兼容性验证2.1 环境版本选择为什么必须用 JDK 8 Tomcat 9 MySQL 5.7这套系统不是为新版本“适配”出来的而是基于高校实验室主流教学环境实测打磨的。我反复验证过若用 JDK 11web.xml中servlet-class标签会因 Servlet 4.0 规范变更导致类加载失败Tomcat 10 默认启用 Jakarta EE 命名空间jakarta.servlet.*而本项目所有 Servlet 仍继承javax.servlet.http.HttpServlet强行升级会触发NoClassDefFoundErrorMySQL 8.0 默认开启caching_sha2_password认证插件而项目中jdbc:mysql://localhost:3306/hospital?useSSLfalseserverTimezoneUTC连接字符串未指定authenticationPlugins会导致Access denied for user。所以严格锁定 JDK 8u202、Tomcat 9.0.83、MySQL 5.7.33是启动成功的前提。这不是保守是避免在答辩前夜调试驱动兼容性的血泪经验——我曾用 MySQL 8.0 跑了 6 小时最后发现就差一行allowPublicKeyRetrievaltrue但老师机房根本没装新驱动 jar。2.2 数据库导入8 张表结构初始化数据一次性到位含hospital.sql执行要点解压后在src/main/resources/sql/目录下找到hospital.sql文件。它不是简单 CREATE TABLE而是包含完整建库、建表、插入初始数据的脚本。执行前注意三点先手动创建数据库CREATE DATABASE hospital CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;必须用utf8mb4否则医生姓名中的 emoji 或生僻字会乱码执行顺序不能错脚本内已按依赖关系排序department→doctor→schedule→user→appointment但若你手动分段执行务必先跑department表否则doctor.department_id外键会报错时间字段处理schedule表的start_time和end_time是TIME类型appointment表的create_time是DATETIME脚本中用NOW()插入确保服务器时区与serverTimezoneUTC一致否则预约时间会偏移 8 小时。-- 示例hospital.sql 中关键片段实际文件含全部 8 张表 CREATE TABLE department ( id INT(11) NOT NULL AUTO_INCREMENT, name VARCHAR(50) NOT NULL COMMENT 科室名称, description TEXT COMMENT 科室简介, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; INSERT INTO department VALUES (1,内科,呼吸系统疾病诊疗),(2,外科,创伤与手术治疗);提示执行完后用SELECT COUNT(*) FROM appointment;检查是否返回20——这是初始化的 20 条测试预约记录证明数据已正确载入。2.3 Tomcat 部署war 包生成与 context-path 配置绕过 ROOT 冲突项目结构是标准 Maven 工程但不要直接把整个src文件夹丢进 Tomcat webapps正确流程是用 IDEA 打开项目 → 右键项目名 →Open Module Settings→Project页确认 Project SDK 为 JDK 1.8Build→Build Artifacts→ 选择hospital:war exploded→Build生成out/artifacts/hospital_war_exploded/将该文件夹重命名为hospital不能叫ROOT否则会覆盖 Tomcat 默认首页复制到tomcat/webapps/下修改tomcat/conf/server.xml在Host标签下添加Context path/hospital docBasehospital debug0 reloadabletrue /这样访问地址就是http://localhost:8080/hospital/而非http://localhost:8080/——避免与 Tomcat 自带 manager 应用冲突也方便多项目共存。3. 前端交互逻辑拆解LayUI 组件如何驱动挂号核心流程日历选号、科室联动、余号实时刷新3.1 LayUI 日历组件laydate与挂号日期绑定机制挂号页/pages/appoint.jsp的核心是laydate.render()初始化的日期选择器。它不是简单显示日历而是与后端ScheduleServlet动态交互用户点击日期后触发change回调用 AJAX 获取该日所有可约时段// pages/appoint.jsp 中关键 JS laydate.render({ elem: #appointDate, format: yyyy-MM-dd, done: function(value, date, endDate){ // value 是选中的日期字符串如 2024-06-15 $.get(/hospital/ScheduleServlet, { action: getByDate, date: value }, function(data) { // data 是 JSON 数组含 {id:1, doctorName:张医生, dept:内科, time:09:00-10:00, remain:3} renderScheduleList(data); // 渲染到 .schedule-list 容器 }); } });注意ScheduleServlet的doGet方法中request.getParameter(date)接收值后会拼接 SQL 查询SELECT * FROM schedule WHERE date ? AND remain 0必须加remain 0条件否则已约满的号源仍会显示这是学生项目最常漏的业务校验点。3.2 科室-医生二级联动LayUI Select 如何实现动态加载挂号页顶部有科室下拉框#deptSelect选择后自动加载对应医生列表。实现逻辑在doctor.js中// 监听科室 select change 事件 form.on(select(dept), function(data){ var deptId data.value; // data.value 是科室 id如 1 $.get(/hospital/DoctorServlet, { action: listByDept, deptId: deptId }, function(doctors) { // 清空医生 select 并重新填充 option $(#doctorSelect).empty(); $.each(doctors, function(i, d){ $(#doctorSelect).append(option valued.idd.name/option); }); form.render(select); // 重新渲染 LayUI select 样式 }); });关键点DoctorServlet返回的是 JSON 数组不是 HTML 片段。后端用response.setContentType(application/json;charsetUTF-8)设置响应头并用Gson序列化ListDoctor对象——切勿用PrintWriter直接输出字符串否则前端$.get会解析失败。3.3 余号实时刷新WebSocket 还是轮询本项目用的是轻量级方案系统没有用 WebSocket对课程设计超纲而是采用setInterval每 30 秒轮询AppointmentServlet?actiongetRemainidxxx。但为防刷爆数据库后端做了两层保护在AppointmentServlet的getRemain方法中SQL 查询加LIMIT 1只查单条记录使用ServletContext全局缓存余号数getServletContext().getAttribute(remain_scheduleId)首次查询后存入后续请求直接读缓存30 秒后失效——这比每次查 DB 快 5 倍且避免高并发时remain字段被重复扣减。4. 后端业务逻辑深挖Servlet 分层设计与 JDBC 事务边界挂号、退号、排班三大核心4.1 挂号流程从 JSP 表单提交到数据库原子写入含事务回滚点用户点击“确认预约”后appoint.jsp提交表单到AppointmentServletdoPost方法处理流程如下// AppointmentServlet.java 关键逻辑 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String scheduleId request.getParameter(scheduleId); String userId ((User)request.getSession().getAttribute(user)).getId(); Connection conn null; PreparedStatement ps null; try { conn JDBCUtil.getConnection(); // 获取连接 conn.setAutoCommit(false); // 开启事务 // 步骤1检查余号SELECT remain FROM schedule WHERE id? ps conn.prepareStatement(SELECT remain FROM schedule WHERE id?); ps.setString(1, scheduleId); ResultSet rs ps.executeQuery(); if (!rs.next() || rs.getInt(remain) 0) { request.setAttribute(msg, 号源已约满请选择其他时段); request.getRequestDispatcher(/pages/error.jsp).forward(request, response); return; // 提前退出不提交事务 } // 步骤2插入预约记录INSERT INTO appointment ps conn.prepareStatement(INSERT INTO appointment ...); ps.setString(1, userId); ps.setString(2, scheduleId); ps.executeUpdate(); // 步骤3更新余号UPDATE schedule SET remainremain-1 WHERE id? ps conn.prepareStatement(UPDATE schedule SET remainremain-1 WHERE id?); ps.setString(1, scheduleId); ps.executeUpdate(); conn.commit(); // 全部成功才提交 response.sendRedirect(/hospital/pages/success.jsp?msg预约成功); } catch (SQLException e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } } request.setAttribute(msg, 系统繁忙请稍后再试); request.getRequestDispatcher(/pages/error.jsp).forward(request, response); } finally { JDBCUtil.close(ps, conn); } }重点事务必须包裹检查余号、插入预约、更新余号三个操作。若只做前两步会出现“预约成功但余号没减”的脏数据若只做后两步会漏掉余号不足的校验。JDBCUtil.close()是自定义工具类确保finally中释放资源——这是学生项目最容易内存泄漏的地方。4.2 退号流程如何安全地“回滚”一次挂号含余号恢复与日志记录退号功能在MyAppointments.jsp页面点击“取消”触发AppointmentServlet?actioncancelidxxx。核心是反向操作删除appointment表中对应记录将schedule.remain加 1插入操作日志到log表typeCANCEL,content用户U1001取消预约S20240615001,create_timeNOW()。// AppointmentServlet 中 cancel 方法 ps conn.prepareStatement(DELETE FROM appointment WHERE id? AND user_id?); ps.setString(1, appointId); ps.setString(2, userId); // 加 user_id 条件防止越权删除他人预约 int deleted ps.executeUpdate(); if (deleted 0) { throw new RuntimeException(预约不存在或非本人操作); } ps conn.prepareStatement(UPDATE schedule SET remainremain1 WHERE id(SELECT schedule_id FROM appointment WHERE id?)); ps.setString(1, appointId); ps.executeUpdate(); // 记录日志 ps conn.prepareStatement(INSERT INTO log (type, content, create_time) VALUES (?, ?, NOW())); ps.setString(1, CANCEL); ps.setString(2, 用户userId取消预约appointId); ps.executeUpdate();注意DELETE语句必须带user_id条件这是权限校验的最低防线。我见过太多项目只用id删除导致 A 用户能删 B 用户的预约——答辩时老师一试就挂。4.3 排班管理AdminServlet 如何实现医生排班的增删改含时间冲突检测管理员在/pages/admin/schedule.jsp添加排班时AdminServlet?actionaddSchedule会执行// 检测时间冲突同一医生同一天不能有重叠时段 String sql SELECT COUNT(*) FROM schedule WHERE doctor_id? AND date? AND ((? BETWEEN start_time AND end_time) OR (? BETWEEN start_time AND end_time) OR (start_time BETWEEN ? AND ?) OR (end_time BETWEEN ? AND ?)); ps conn.prepareStatement(sql); ps.setString(1, doctorId); ps.setString(2, date); ps.setString(3, startTime); // 新时段开始 ps.setString(4, endTime); // 新时段结束 ps.setString(5, startTime); // 覆盖判断 ps.setString(6, endTime); ps.setString(7, startTime); ps.setString(8, endTime); ResultSet rs ps.executeQuery(); if (rs.next() rs.getInt(1) 0) { request.setAttribute(msg, 该医生在当日已有排班时间冲突); request.getRequestDispatcher(/pages/admin/schedule.jsp).forward(request, response); return; }这段 SQL 是经典的时间冲突检测逻辑用四个BETWEEN覆盖所有重叠场景新时段在旧时段内、旧时段在新时段内、新旧时段部分重叠。学生常犯错是只写? BETWEEN start_time AND end_time漏掉反向判断导致 09:00-10:00 和 09:30-11:00 被判定为不冲突。5. 避坑指南95分项目里埋着的5个隐形雷区现象→原因→解决5.1 现象首页 CSS 全部失效文字堆叠成一团F12 查看 Network 显示layui.min.css404原因项目中 CSS 文件路径写成绝对路径/static/css/layui.min.css但 Tomcat 部署时webapps/hospital/下的静态资源目录是static/而web.xml中未配置default servlet映射导致 Tomcat 不识别/static/请求。解决在web.xml的web-app标签下添加servlet-mapping servlet-namedefault/servlet-name url-pattern/static/*/url-pattern /servlet-mapping并确认static/css/目录真实存在文件名大小写与引用完全一致Linux 下Layui.min.css≠layui.min.css。5.2 现象登录后跳转到http://localhost:8080/pages/main.jsp404正确路径应是/hospital/pages/main.jsp原因LoginServlet中response.sendRedirect(pages/main.jsp)使用了相对路径而 Tomcat 的context-path是/hospital相对路径会拼接到根路径变成/pages/main.jsp。解决改为response.sendRedirect(request.getContextPath() /pages/main.jsp)request.getContextPath()动态获取当前应用路径兼容不同部署名。5.3 现象MySQL 中文显示为??医生姓名全乱码原因MySQL 服务端字符集是latin1而项目连接字符串未强制指定characterEncodingutf8mb4。解决修改jdbc:mysql://localhost:3306/hospital?useSSLfalseserverTimezoneUTC为jdbc:mysql://localhost:3306/hospital?useSSLfalseserverTimezoneUTCcharacterEncodingutf8mb4connectionCollationutf8mb4_unicode_ci并在 MySQL 配置文件my.cnf中添加[mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci5.4 现象LayUI 的 layer 弹窗不显示控制台报layer is not defined原因layer.js未正确引入或引入顺序错误必须在jquery.js之后、laydate.js之前。解决检查pages/common/head.jsp中的 script 标签顺序script src${pageContext.request.contextPath}/static/js/jquery.min.js/script script src${pageContext.request.contextPath}/static/layui/layui.js/script !-- layer.js 是 layui 的模块必须在 layui.js 之后 -- script layui.use([layer], function(){ var layer layui.layer; }); /script5.5 现象Tomcat 启动后控制台疯狂打印SEVERE: Servlet.service() for servlet [jsp] threw exception但页面能打开原因web.xml中welcome-file-list指定了index.jsp但index.jsp里有一行% page importjava.util.Date %而Date类未被显式使用IDEA 误判为无效导入编译时报 warningTomcat 在 debug 模式下将 warning 当 error 输出。解决删除index.jsp中所有未使用的 import或在web.xml中注释掉welcome-file-list直接访问/hospital/pages/login.jsp。6. 进阶技巧如何用这套代码快速产出“差异化”课程设计加功能、改界面、换数据库6.1 三分钟加“短信提醒”功能模拟版无需真实运营商接口很多同学想加分但怕接入短信平台。其实可以用TimerTask模拟在AppointmentServlet的挂号成功分支里添加一段延时任务// 模拟 10 秒后发送提醒实际项目应异步此处为演示 Timer timer new Timer(); timer.schedule(new TimerTask() { Override public void run() { System.out.println(【短信模拟】患者 userId 的预约将于 scheduleDate scheduleTime 开始请准时就诊); } }, 10000); // 10秒后执行更进一步把System.out.println替换为写入sms_log.txt文件再用FileReader在管理员后台读取就实现了“伪短信中心”。答辩时说“已预留短信接口只需替换为阿里云 SMS SDK 即可上线”老师会觉得你考虑周全。6.2 一键更换主题LayUI 主题色修改对照表蓝→绿→橙LayUI 默认蓝色主题想让系统看起来更专业不用重写 CSS只需改两处static/layui/css/layui.css中搜索.layui-btn-primary将background-color: #01AAED改为绿色#009688或橙色#FF5722static/css/secondary.css中的body { background: #f2f2f2 }改为#f5f5f5绿系或#fff3e0橙系。主题.layui-btn-primary色值body 背景色适用场景默认蓝#01AAED#f2f2f2通用医疗绿#009688#f5f5f5突出健康、信任感温暖橙#FF5722#fff3e0亲和力强适合社区医院6.3 数据库平滑迁移从 MySQL 5.7 到 SQLite嵌入式轻量方案若需离线演示或打包成单文件可迁移到 SQLite。步骤用 DB Browser for SQLite 创建hospital.db手动建表SQLite 不支持AUTO_INCREMENT改用INTEGER PRIMARY KEY修改JDBCUtil.java// 原 MySQL 驱动 // Class.forName(com.mysql.cj.jdbc.Driver); // String url jdbc:mysql://...; // 改为 SQLite Class.forName(org.sqlite.JDBC); String url jdbc:sqlite:hospital.db;调整 SQLVARCHAR(50)→TEXTDATETIME→TEXT删除ENGINEInnoDB。注意SQLite 不支持NOW()函数插入时间用datetime(now)外键需在连接串加;foreign_keyson。我试过整套功能在 SQLite 下运行无压力体积从 10MB 降到 2MB。从那以后我每次帮同学改课程设计都强制走一遍“环境清空→JDK/Tomcat/MySQL 版本核对→SQL 脚本逐行执行→浏览器 F12 检查 Network Tab”的流程哪怕多花 15 分钟也比答辩前 2 小时发现ClassNotFoundException强。这套医院预约挂号系统它不炫技但每行代码都在回答“这个功能怎么落地”——这才是课程设计该有的样子。希望帮到你。本文还有配套的精品资源点击获取