JSP+Servlet医院预约挂号系统：从源码部署到避坑实战

简介基于JSPServlet的医院预约挂号系统源码面向计算机相关专业毕业设计、课程实训及Java Web初学者。系统完整覆盖患者注册登录、科室与医生查询、号源预约、后台管理等核心流程清晰展示了JSP动态页面、Servlet请求处理、JDBC数据库操作以及MVC分层设计适合在学习SSH/SSM框架前夯实经典Java Web技术。压缩包共1431个文件约30.98MB除78个JSP页面、23个Java源文件、46个class文件和62个jar依赖外还包含SQL数据库脚本、XML配置及CSS/JS等前端资源并附有大量静态素材与文档便于直接部署、调试和二次开发。当前已有208人学习下载。通过阅读源码和配置读者可以快速掌握预约挂号系统的表结构设计、会话管理、权限控制及异常处理思路尤其适合作为毕业设计参考或综合项目练手是一份结构完整、易于上手的Java Web实战资料。1. 这个压缩包解决什么问题医院预约挂号在 JavaWeb 课设里的真实分量一份名为“基于JspServlet医院预约挂号系统源码.zip”的项目几乎就是 JavaWeb 课程设计和毕业设计的“标配题”。你拿到的不是一个简单的静态页面而是一套包含用户注册登录、科室医生展示、号源预约、后台管理的小型业务系统。它最典型的运行形态是Tomcat 做 Web 服务器MySQL 存业务数据浏览器地址栏输入http://localhost:8080/hospital/就能进入首页。对于正在做 JavaWeb 头歌实训、课程设计或者第一次接触企业级 Servlet 开发的人来说这个项目是理解 MVC 分层和 Session 会话控制最直接的素材。它解决的核心痛点就一句话让你在不会 Spring Boot 的情况下照样能交付一个有完整“前后端交互 数据库落库 用户状态保持”的可用系统。很多学生卡在“不知道代码该放哪、请求怎么流转、为什么页面中文乱码”这套源码把这些答案都写在代码里。本文会从解压源码包开始带你跑通它、看懂它再把最常见的五个坑提前排掉。2. 拆开源码包目录结构、运行前提与两种启动方式2.1 压缩包里的三种典型布局先认准这三个东西解压基于JspServlet医院预约挂号系统源码.zip之后第一件事不是双击看页面而是认目录。不同人的工程模板不一样压缩包里可能是 Eclipse 的 Dynamic Web Project也可能是 IDEA 的非 Maven 工程还可能是被人为整理过的 Maven 骨架。但不管哪种你要找的无非是三样Java 源文件目录、Web 根目录、数据库脚本。常见的是这种hospital/ ├── src/ # Java 源文件 │ └── com/hospital/ # 包名通常有 servlet、dao、bean 等子包 ├── WebContent/ # Web 根目录IDEA 里可能叫 web │ ├── index.jsp │ ├── login.jsp │ ├── register.jsp │ ├── WEB-INF/ │ │ ├── web.xml │ │ └── lib/ # 依赖的 jar 包 │ └── static/ # css、js 等 └── sql/ └── hospital.sql # 建库建表脚本如果你看到的是 Maven 结构那src/main/java替代srcsrc/main/webapp替代WebContent。这两者启动方式差别很大非 Maven 工程直接丢进 Tomcat 的 webapps 目录或 IDE 部署即可Maven 工程则需要先mvn package再部署或者用插件直接跑。这里要特别提醒当你用 IDEA 导入别人的源码时经常因为是普通工程而找不到 Web Facet。正确做法是File – Project Structure – Facets里手动添加 Web并指定 Web 根目录。否则 IDE 不知道把 JSP 和静态资源部署到哪里。这个问题排在“跑不起来”原因的第一名。2.2 本地跑通最小命令先判断是不是 Maven 工程我一般会先看根目录有没有pom.xml。有就走 Maven 插件方式没有就直接配置 Tomcat 容器。给你演示两条路线。第一如果是 Maven在项目根目录执行前提是已安装 JDK8、Maven3、MySQL# 先用 Maven 把 war 包打出来 mvn clean package -DskipTests # 拷贝到本地 Tomcat 的 webapps 下 cp target/hospital.war /your/tomcat/path/webapps/ # 启动 Tomcat /your/tomcat/path/bin/startup.sh参数说明-DskipTests跳过测试代码避免有些遗留工程里有失败的单测阻塞打包。clean是清空上次构建产物防止旧 class 残留导致“改了代码没生效”的玄学。第二如果是传统 Eclipse 工程可以在 pom 里临时加一个 Tomcat 插件不污染源码只是帮你本地起服务。但你确实不想动工程文件的话就用 IDE 的 Run 配置添加 Tomcat Server然后指向WebContent作为 Deployment Context文理上最省心。注意传统工程里必须在WEB-INF/lib能看到jsp-api.jar和servlet-api.jar看不到的话编译会报错。2.3 数据库导入与 jdbc.properties 的四个必改参数这套系统几乎清一色使用 MySQL压缩包里通常带一个.sql脚本。在命令行导入mysql -u root -p -e create database hospital character set utf8mb4; mysql -u root -p hospital sql/hospital.sql然后在源码里找到数据库配置文件名字可能是jdbc.properties、db.properties或database.properties位置一般在src根目录。核心内容就四项jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hospital?useUnicodetruecharacterEncodingutf-8useSSLfalse jdbc.usernameroot jdbc.password123456参数说明MySQL 5.x 用com.mysql.jdbc.DriverMySQL 8.x 要把驱动包换成com.mysql.cj.jdbc.Driver对应的 jar 也要换成mysql-connector-java 8.x。useSSLfalse是本地调试必备否则 MySQL 8 会强制加密连接控制台报 SSL 告警。characterEncodingutf-8配合项目里的过滤器才能保证从数据库读出来的中文不是问号。这里有个越过去容易踩的如果你的 MySQL 是 8.0但源码里的 lib 包还是 5.1 老驱动连接时会报Public Key Retrieval is not allowed。解决方案不是改连接参数而是直接替换 jar 包。别在代码里找问题先看 jar 版本。2.4 不装 IDEA 也能跑用 VSCode 配一个 Servlet 运行环境很多人在 VSCode 里写 Servlet问要怎么配置环境。其实核心就三步装一个 Tomcat 插件比如 Community Server Connectors装 Java Extension Pack再加一个 MySQL 驱动。VSCode 不像 IDEA 自动管理 Web Facet你要手动在.vscode/settings.json里指定编译器输出目录。不过我不建议你用 VSCode 跑这个完整项目——它更适合改单页 JSP 和看代码。真要把系统跑起来还是 Eclipse 或 IDEA 顺手。如果你是做最后答辩演示直接用 IDEA 配 Tomcat 最快VSCode 留着写前端页面看效果就好。3. 预约挂号的核心链路从登录到成功预约的 Servlet 请求流3.1 用 Model2 思想拆开“科室列表 → 选择医生 → 提交挂号”这套源码你最该读的不是注册登录而是预约挂号这一条业务线。它天生就符合 Servlet 规范里要求的 Model2MVC模式JSP 只负责渲染Servlet 负责接收参数和调度DAO 负责查询数据库。拿“选择医生”这一步来说浏览器访问Servelet?actionlistDoctordeptId3后台接收到请求后典型代码如下代码已简化只保留骨架WebServlet(/patient/doctorServlet) public class DoctorServlet extends HttpServlet { private DoctorDao doctorDao new DoctorDao(); Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String action req.getParameter(action); if (listDoctor.equals(action)) { int deptId Integer.parseInt(req.getParameter(deptId)); ListDoctor list doctorDao.findByDept(deptId); req.setAttribute(doctorList, list); req.getRequestDispatcher(/patient/selectDoctor.jsp) .forward(req, resp); } else if (detail.equals(action)) { // 查看医生详情跳转预约页 } } }逻辑说明第一行req.setCharacterEncoding(UTF-8)必须写且必须放在读取任何参数之前否则 POST 请求里的中文医生姓名、科室名全会变成乱码。action是很多老 JSP 项目喜欢用的“请求分发参数”一个 Servlet 里用 if-else 拆出多个功能。这不是最佳实践但课设代码里常见读起来也直白。参数说明deptId是从department.jsp页面里带过来的挂在链接后面doctorServlet?actionlistDoctordeptId${dept.id}。如果你发现点击科室没反应第一个要查的就是这个参数是否拼写正确第二个是DoctorDao.findByDept里 SQL 的表名和字段名是否和数据库里一致。老项目最容易在这些地方大小写不一致Java 里写的DeptId数据库表里是dept_id映射不上直接 500。3.2 会话管理为什么登录后必须把用户塞进 session而不是 request预约挂号的整个流程中用户登录状态是核心。很多新手在“提交预约”的 Servlet 里重新查一遍用户 ID其实登录时已经存过了。常见做法是登录成功后执行User user userDao.findByUsernameAndPwd(username, password); if (user ! null) { HttpSession session req.getSession(); session.setAttribute(loginUser, user); resp.sendRedirect(index.jsp); } else { req.setAttribute(msg, 用户名或密码错误); req.getRequestDispatcher(login.jsp).forward(req, resp); }这里要是把用户对象放进request而不放session重定向到index.jsp时那个属性就丢了。因为重定向是让浏览器重新发一次请求之前的 request 已经销毁。这是 javaweb 头歌实训里经常考察的知识点request 生命周期只覆盖一次请求转发session 生命周期覆盖整个会话。那“提交预约”的 Servlet 怎么拿当前用户很简单User loginUser (User) req.getSession().getAttribute(loginUser); if (loginUser null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } int userId loginUser.getId();这实际上是所有 JavaWeb 项目都会用到的会话校验模板。很多源码里没有统一的登录校验 Filter每个 Servlet 都重复这样写七八行。先别急着加 Filter你要理解的是为什么这里不能从表单里直接传userId因为前端传参可被伪造如果预约接口信任页面隐藏域里的 userId那任意登录用户都可以替别人挂号。必须从 session 取这是安全底线。3.3 数据库防重复预约用唯一索引锁住“一个患者对一个号源”预约系统最怕的翻车是同一个患者的同一个号被点击两次提交生成两条重复预约记录。前端可以禁用按钮但后端必须兜底。源码里如果没做我来写给你看。先看数据库表设计预约表通常长这样CREATE TABLE appointment ( id BIGINT PRIMARY KEY AUTO_INCREMENT, patient_id INT NOT NULL, schedule_id INT NOT NULL, appointment_no VARCHAR(20) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE KEY uk_patient_schedule (patient_id, schedule_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;然后在插入预约的 DAO 里不再用普通的INSERT而是加一个“先查询再插入”的外层事务控制public boolean bookAppointment(int patientId, int scheduleId) { Connection conn null; PreparedStatement ps null; ResultSet rs null; try { conn JdbcUtil.getConnection(); conn.setAutoCommit(false); // 检查是否已预约 String checkSql SELECT id FROM appointment WHERE patient_id? AND schedule_id? FOR UPDATE; ps conn.prepareStatement(checkSql); ps.setInt(1, patientId); ps.setInt(2, scheduleId); rs ps.executeQuery(); if (rs.next()) { return false; // 已存在 } // 插入新预约 String insertSql INSERT INTO appointment (patient_id, schedule_id) VALUES (?, ?); ps conn.prepareStatement(insertSql); ps.setInt(1, patientId); ps.setInt(2, scheduleId); ps.executeUpdate(); conn.commit(); return true; } catch (SQLException e) { // 捕获唯一键冲突说明并发预约了同一号源 try { if (conn ! null) conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } e.printStackTrace(); return false; } finally { JdbcUtil.close(rs, ps, conn); } }逻辑说明FOR UPDATE是行级锁确保同一时间只有一个请求能对这个 pair 进行“查询 插入”。即使两个请求同时进来后执行到SELECT ... FOR UPDATE的线程会等前面 commit 之后才继续第二次查询就能看到那条数据直接返回 false。如果不用FOR UPDATE哪怕有唯一索引也可能会在那极短的“查询-插入”窗口里抛Duplicate entry异常靠异常捕获也能兜底。参数说明appointment_no是挂号编号很多源码里直接用时间戳拼随机数生成比如SimpleDateFormat(yyyyMMddHHmmss) UUID.randomUUID().toString().substring(0,4)。这个字段设计成唯一约束更保险但注意别和主键混用。实际课设不需要这么复杂你只要确保patient_id schedule_id有唯一索引就已经比市面上 60% 的源码项目健壮。3.4 把“个人信息展示页面”改造成真正的 Model2 结构很多源码里的userInfo.jsp直接写死了一段 Java 代码% User u (User) session.getAttribute(loginUser); out.println(u.getName()); %这在课设里能跑但按JSP Model2的思想应该改成在 Servlet 里查出最新数据转发给 JSPJSP 只用 EL 表达式和 JSTL 展示。也就是把你的个人信息展示页面从“JSP 脚本片段”升级为“Servlet JSP EL”。比如// UserInfoServlet.java User user userDao.findById(((User)req.getSession().getAttribute(loginUser)).getId()); req.setAttribute(user, user); req.getRequestDispatcher(/user/userInfo.jsp).forward(req, resp);%-- userInfo.jsp 里的关键片段 --% 姓名${user.name} 手机${user.phone}这样做的好处是 JSP 里没有 Java 代码IDE 能帮你发现 EL 表达式拼写错误而且后边想加缓存、加权限控制都只动 Servlet不碰页面。这套源码里如果存在大量% ... %这就是你第一个要动手重构的点也是答辩时能讲两分钟的亮点。4. 避坑指南JSP Servlet 老项目最容易翻车的 5 个位置4.1 页面中文全是问号先查三处编码设置现象跑起来后登录页汉字正常但从数据库读出来的科室名称、医生姓名显示成????或者乱码。原因三层编码不一致。页面 JSP 声明pageEncodingUTF-8数据库连接串里characterEncodingUTF-8但 Servlet 接收请求参数时没设req.setCharacterEncoding(UTF-8)或者 Tomcat 服务器默认 URI 编码是ISO-8859-1。解决在web.xml里加一个全局编码过滤器这是最常见做法filter filter-nameencoding/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-nameencoding/filter-name url-pattern/*/url-pattern /filter-mapping如果你是 Tomcat 8.5还需要在server.xml的 Connector 上追加URIEncodingUTF-8。否则 GET 请求 URL 里的中文参数就会在到达 Servlet 之前变成乱码。如果源码还在用自定义的CharacterEncodingFilter优先检查它的WebFilter注解是否写了对的路径。这个坑隐蔽就隐蔽在POST 正常GET 乱码很多人会在 Servlet 里反复调编码方法其实根源在 Tomcat 连接器配置。4.2 Tomcat 10 换了包名javax.servlet 变 jakarta.servlet现象用最新版 Tomcat 10 启动项目直接报java.lang.ClassNotFoundException: javax.servlet.Filter或者NoClassDefFoundError。原因Tomcat 10 是 Java EE 9 之后的首个版本Servlet API 从javax.servlet迁移到jakarta.servlet。老源码里所有 import 都是javax.servlet自然加载不到类。解决两个路子。第一换成 Tomcat 9.0.x最省事课设没必要追新。第二全局替换源码里的javax.servlet为jakarta.servlet同时把WEB-INF/lib里的老 servlet-api.jar 删掉换上jakarta.servlet-api-5.0.0.jar。注意web.xml头的版本也要改成 5.0 对应的 schema否则解析失败。我的建议是选 Tomcat 9因为项目里用到的第三方库不一定都适配 jakarta 命名空间。这不是你代码的问题是容器版本的问题别改代码改到怀疑人生。4.3 MySQL 8 驱动和 JDK 版本不匹配启动时不报错写库时才报错现象项目能启动登录能查数但点击“确认预约”就 500控制台报java.sql.SQLException: Unknown system variable query_cache_size。原因MySQL 8.0 在 JDBC 连接后执行SET query_cache_size...这条指令时因为新版移除了查询缓存特性老驱动会试图设置这个变量导致连接建立异常。明面上它和项目代码无关但数据库驱动 jar 是压在WEB-INF/lib里的 5.1 版本。解决把mysql-connector-java-5.1.x.jar换成mysql-connector-java-8.0.x.jar同时把jdbc.properties里的 driver 改成com.mysql.cj.jdbc.Driver。注意MySQL 8 驱动要求 mysql 库存在mysql.user表的 host 匹配否则报Access denied for user。检查本地 MySQL 的用户是rootlocalhost代码里连接地址也要写localhost而不是127.0.0.1在某些 Linux 上这两者走不同授权记录。4.4 路径写死成/hospital/login.jsp项目重名就 404现象直接访问http://localhost:8080/hospital/login.jsp没事但从别的页面跳转到/hospital/index.jsp就 404。或者把 war 包改名为med部署后整个项目全部 404。原因源码里用了绝对路径比如resp.sendRedirect(/hospital/index.jsp)。当应用上下文context path不叫hospital时路径自然失效。解决不要在任何代码里写死应用名。Servlet 里统一用resp.sendRedirect(req.getContextPath() /index.jsp);JSP 里用${pageContext.request.contextPath}拼路径或者在web.xml里定义一个全局变量。这是老 JavaWeb 源码最丑陋的地方之一。拿到压缩包后第一件事全局搜索/hospital/把所有硬编码替换成动态上下文路径否则你的项目一部署到别人的机器就崩。4.5 静态资源被登录过滤器拦掉页面光秃秃只有 HTML现象登录页能打开但是 CSS 和 JS 全部加载失败控制台一片 404。更诡异的是功能不受影响就是页面丑。原因项目在web.xml或注解里写了一个/*的登录校验 Filter把所有请求都拦了静态资源也不例外。过滤器判断 session 里没有用户就 redirect 到登录页导致浏览器拿到的是登录页的 HTML 而不是 CSS 文件。解决修改过滤器映射放行静态资源。常见做法有两种。一种是直接把Filter的 URL 映射从/*改成/page/*、/servlet/*等具体前缀另一种是在过滤器内部白名单判断。强烈推荐后者因为改映射会影响已有请求路径public void doFilter(...) throws ... { String uri request.getRequestURI(); if (uri.endsWith(.css) || uri.endsWith(.js) || uri.endsWith(.jpg) || uri.endsWith(.png)) { chain.doFilter(request, response); return; } if (request.getSession().getAttribute(loginUser) null) { response.sendRedirect(request.getContextPath() /login.jsp); } else { chain.doFilter(request, response); } }逻辑说明先判断请求资源类型静态文件直接放行不进入登录校验逻辑。很多人只在web.xml里配url-pattern/static/*/url-pattern单独放行但页面如果引用了根目录下的favicon.ico或css/common.css还是会被拦。最稳的就是在过滤器代码里做前缀判断。这才是真正的血泪经验——我见过至少三个项目因为过滤器把bootstrap.min.css拦了学生熬夜排查两天。5. 把它改造成“能写进简历”的样子分页、过滤器、Maven 化5.1 给挂号记录列表加分页一个通用 Servlet 模板课设源码里的“我的预约”一般是一张List全查出来显示在表格里。数据一多页面卡死。你只需把 DAO 查询改成带LIMIT offset, size再在 Servlet 里算总页数int page 1, size 10; String pageStr req.getParameter(page); if (pageStr ! null pageStr.matches(\\d)) { page Integer.parseInt(pageStr); } int total appointmentDao.countByPatient(userId); int totalPage (total size - 1) / size; ListAppointment list appointmentDao.findByPatient(userId, (page-1)*size, size); req.setAttribute(list, list); req.setAttribute(totalPage, totalPage); req.setAttribute(currentPage, page);JSP 底部用 EL 表达式渲染上一页/下一页链接不给翻车留余地。这是所有 JavaWeb 项目都可以复用的分页套路面试时讲清楚LIMIT的两个参数含义就比写死全查高一个档次。5.2 用 Filter 统一做登录校验和编码处理把每个 Servlet 里重复的if (session.getAttribute(loginUser) null) redirect抽到一个过滤器里这是重构交付物的第一步。过滤器里一边处理编码一边处理未登录跳转代码量减少一半。再配合WebFilter(/*)注意按 4.5 节的静态资源白名单放行。5.3 把 Maven 用起来从 WebContent 到 src/main/webapp这套源码如果还是传统工程我强烈建议你花半小时把它改造成 Maven 项目。好处有两种一是依赖 jar 不用手动复制进libpom.xml写清楚版本就能下载二是mvn package能一次性产出 war 包部署到 Linux 服务器时再也不用从 IDE 里做满手操作。转换方法不复杂新建一个标准 Maven 目录结构把src下内容移动到src/main/javaWebContent移动为src/main/webapp配置文件到src/main/resources然后在根目录放一个包含javax.servlet-apiscope provided和mysql-connector-java的 pom。这种改造本身就是课设报告里很有分量的“工程化提升”。最后说个我的习惯。每次拿到这种源码包我不会先跑起来而是先grep -r localhost .看有哪些写死的环境和路径。改完路径、换好 MySQL 驱动、调好编码再启动 Tomcat。这一套下来十分钟跑通已经算慢。那些报错翻车的情况90% 都在上面四个坑里。你手里的源码大概率没问题问题出在环境。把环境对齐JSP Servlet 这套老技术跑起来还是相当稳的。希望帮到你。本文还有配套的精品资源点击获取