拓冰网站定制 
简介基于JSPServlet的医院预约挂号系统源码压缩包面向Java Web课程设计、毕业设计及初学Servlet/JSP的开发者提供一套可运行、可扩展的完整项目工程。系统涵盖患者预约、医生排班、后台管理、用户登录认证等核心模块并对MVC分层、JDBC/SQL数据库操作、异步并发与安全防护等关键实现均有体现。资源共1431个文件压缩包约30.98MB主要包含78个JSP页面、23个Java类、400个JS脚本、46个class文件以及62个jar依赖库、40个CSS样式和1个SQL脚本前端页面与后端逻辑分层清晰便于直接导入IDE运行和二次开发。已有208人学习下载源码目录结构完整配合数据库脚本和部署配置可帮助读者快速理解预约挂号业务流程掌握从页面交互到服务端处理的完整Java Web开发链路。包内同时附有常用富文本编辑器、页面样式与数据库初始化文件可作为毕业设计答辩和项目实战的双重参考。1. JspServlet医院预约挂号系统老技术栈为什么还值得认真跑一遍你下载了一个基于JspServlet医院预约挂号系统源码.zip解压一看就是典型的 Java 课程设计布局src 里一堆 Servlet 和 DAOWebContent 里是 JSP根目录还放着hospital.sql。这套技术栈听起来老但如果你是在交 Java Web 课设或者刚接手一个十年前上线的老挂号系统它反而是最值得研究的东西JspServletJDBC 把 HTTP 请求、会话、数据库事务这些底子全暴露在代码里没有框架帮你掩盖。预约挂号表面上是页面跳转真正难点在号源并发和排班冲突而老代码里恰好能看到最原始的解决方式。下面按“源码里有什么 → 怎么跑起来 → 号源怎么设计 → 坑在哪 → 怎么验证”一路拆开讲。2. 先看清源码结构解压后从哪里开始看 JspServlet 项目2.1 源码包里到底有什么先盘文件再谈部署拿到 zip 以后别急着往 Tomcat 里丢。先解压用 tree 命令或直接看目录结构。一个标准的 JspServlet 工程通常长这样hospital-register/ ├── src/ │ └── com/hospital/ │ ├── entity/ # 用户、医生、科室、排班、挂号单的 JavaBean │ ├── dao/ # JDBC 操作类负责 query 和 update │ ├── servlet/ # 请求入口doGet/doPost 里做业务分发 │ └── util/ # DBUtil 数据库连接工具、字符串工具 ├── WebContent/ │ ├── css/ js/ images/ │ ├── jsp/ │ │ ├── login.jsp # 登录页面 │ │ ├── register.jsp # 患者注册 │ │ ├── doctor_list.jsp# 医生列表/科室列表 │ │ └── appoint.jsp # 预约提交页 │ └── WEB-INF/ │ ├── web.xml # Servlet 映射、欢迎文件、过滤器配置 │ └── lib/ # mysql-connector-java.jar、jstl.jar └── hospital.sql # 建库建表 初始数据这段目录树是整个源码包的索引。先看src/com/hospital/servlet下有多少 Servlet 类、分别叫什么你就能猜出系统有哪些功能模块再看web.xml里的 servlet-mapping能确认浏览器访问的 URL 最终交给哪个类。很多新手一上来就翻 JSP结果被一堆% %和 EL 表达式绕晕其实 JSP 只是视图层真正的业务逻辑都在 Servlet 和 DAO 里。接着打开hospital.sql搜索CREATE TABLE数一下有几张表。预约挂号系统最小编码一般是五张表用户表、科室表、医生表、排班表、挂号单表有的源码还加管理员表。把表数量和 Servlet 数量记下来这一步花五分钟后面部署和排错能省半小时。注意部署前先看清源码里的包名我的示例是com.hospital每个源码不一定一样。后面改配置时以实际包名为准别照抄教程里的全限定名。2.2 从浏览器到数据库一次预约请求的完整链路JspServlet 项目的运行逻辑比 Spring Boot 直白浏览器提交表单 → Tomcat 根据web.xml里的 URL 映射找 Servlet → Servlet 在doPost里接收参数 → 调用 DAO 操作数据库 → 跳转或转发到 JSP 渲染结果。这条链路也是你后续排查问题的顺序。先看 web.xml 里最关键的映射servlet servlet-nameAppointServlet/servlet-name servlet-classcom.hospital.servlet.AppointServlet/servlet-class /servlet servlet-mapping servlet-nameAppointServlet/servlet-name url-pattern/patient/appoint/url-pattern /servlet-mapping这段配置被 Web 容器读取后请求/patient/appoint就会进入AppointServlet。注意servlet-class必须是全限定名大小写不能错url-pattern以/开头但不要写成.jsp结尾。如果你的源码用的是WebServlet(/patient/appoint)注解web.xml 里可能没有这段映射两种配置方式不要混用同一个路径否则启动时会报重复映射。对应的 Servlet 骨架一般是这样的WebServlet(/patient/appoint) public class AppointServlet extends HttpServlet { Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String userId request.getParameter(userId); String scheduleId request.getParameter(scheduleId); // 调用 service/dao 执行预约 int result appointDao.createAppointment(userId, scheduleId); if (result 0) { response.sendRedirect(request.getContextPath() /myAppoint.jsp); } else { response.setContentType(text/html;charsetUTF-8); response.getWriter().write(scriptalert(号源已满);history.back();/script); } } }doGet和doPost的分工不要弄反页面点按钮一般是 POST直接在地址栏访问是 GET。很多源码为了让两种方式都能处理会在doGet里直接调用doPost这是省事的常见写法但要注意安全比如把“取消预约”这种写操作暴露成 GET容易被恶意链接触发。读完代码后建议把“写操作都放 doPost”当成规范记下来。再往下看 DAO 层核心就是一段 JDBC 代码。比如按科室查医生列表String sql SELECT * FROM doctor WHERE dept_id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, deptId); try (ResultSet rs ps.executeQuery()) { ListDoctor list new ArrayList(); while (rs.next()) { Doctor d new Doctor(); d.setId(rs.getInt(id)); d.setName(rs.getString(name)); list.add(d); } request.setAttribute(doctorList, list); } }用PreparedStatement而不是拼接字符串是为了防 SQL 注入这也是老源码少数做得对的地方。参数说明setInt(1, deptId)中的1是第一个问号的下标只能从 1 开始rs.getInt(id)里的id是数据库列名。DBUtil.getConnection()内部通常写死 URL、用户名、密码部署时第一件事就是改这里。2.3 先分清三种 JSP 页面再看个人信息展示页面源码里的 JSP 大致分三类登录注册这种入口页、科室/医生列表这种查询页、挂号单管理这种个人中心页。个人中心页里最常见的功能就是 jsp 个人信息展示页面显示当前登录用户的姓名、手机、历史挂号记录通常从 session 里取用户对象再查一次挂号单表。看这类页面时注意两点。第一它是不是直接用% user.getRealName() %输出用户信息如果是说明服务端把User对象塞进了request或session属性第二它有没有做空值判断。如果 session 过期user为 null页面直接报NullPointerException这也是为什么很多老系统看完列表再点详情就 500 的原因。常见修正是在页面顶部用c:if标签或提前response.sendRedirect(login.jsp)。补一个 JSP 片段说明取值方式% User loginUser (User) session.getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } % p当前用户%loginUser.getRealName()%/p逻辑说明session.getAttribute(loginUser)拿到的是登录时塞进去的对象不是每次请求都重新查库如果返回 null说明会话过期需要跳回登录页。参数说明request.getContextPath()拿的是项目上下文路径所有链接跳转最好都带上它避免部署时改了 webapps 下的目录名导致全站链接失效。这套“session 里拿用户、页面顶部防空”的写法是理解这个源码后端状态管理最快的抓手。3. 把源码跑到本地Tomcat MySQL 环境搭建与最小部署步骤3.1 一个版本组合先定死JDK 8、Tomcat 8.5、MySQL 5.7部署老代码第一件事不是导入 IDE而是先把运行环境三件套对齐。JspServlet 项目对版本很敏感JDK 6/7 时代写的源码放到 JDK 17 上经常因为模块化问题启动失败Tomcat 10 已经把javax.servlet包改成jakarta.servlet老代码的import javax.servlet.*直接编译不过。因此最稳妥的组合是JDK 1.8 Tomcat 8.5.x MySQL 5.7。如果想用 MySQL 8.0也可以但要换驱动类名com.mysql.cj.jdbc.Driver并在连接 URL 上追加serverTimezoneAsia/Shanghai否则会报时区错误。环境参数表组件推荐版本必改配置JDK1.88u201 以上系统变量 JAVA_HOME 指向安装目录Tomcat8.5.x修改 catalina.bat 或 startup.sh 设置 JRE_HOMEMySQL5.7 或 8.0默认端口 3306字符集 utf8MySQL 驱动5.1.47对应 5.7放入 WEB-INF/lib项目编码UTF-8全局文件编码 数据库表编码这里的版本参数不是在硬凑而是这种课程设计最常见的环境。如果机器已经装了 JDK 17 也没关系单独再解压一个 JDK 8在 Tomcat 启动脚本里指定JAVA_HOME指向它不必卸载当前 JDK。我一般把 Tomcat 解压到D:\dev\apache-tomcat-8.5.100项目直接拷到webapps下越简单越不容易翻车。3.2 导入数据库并启动项目两条命令加一条访问路径执行这一步前先确认 MySQL 服务已启动root 密码自己知道。如果源码提供了hospital.sql直接在命令行导入mysql -uroot -p mysql CREATE DATABASE hospital DEFAULT CHARACTER SET utf8mb4; mysql USE hospital; mysql SOURCE E:/path/to/hospital.sql;或者一条命令完成mysql -uroot -p E:/path/to/hospital.sql逻辑说明CREATE DATABASE指定utf8mb4是为了让中文用户名和医生姓名能正常显示。SOURCE命令把 SQL 文件里的建表语句和数据逐条执行。如果执行过程报错不要急着跳过先看是语法错误还是缺权限。语法错误说明源码里的 SQL 和 MySQL 版本不兼容最常见的坑是ENGINEMyISAM或timestamp默认值写法不同。接着把整个项目目录复制到 Tomcat 的webapps文件夹下。如果项目目录名是hospital-register启动 Tomcat 后访问地址就是http://localhost:8080/hospital-register/。cd /usr/local/tomcat/bin ./startup.sh # Windows 下是 startup.bat启动后看日志logs/catalina.out确认没有异常。补一个常用排错动作先在浏览器输入http://localhost:8080/能看到 Tomcat 默认首页说明容器没问题再加项目名出现 404问题多半在项目的web.xml或数据库连接上而不是 Tomcat 本身。3.3 用最小登录流程验证源码是否打通环境起来以后不要急着点菜单先按“登录 → 查医生 → 预约 → 后台确认”的最小闭环走一遍。多数源码会在 SQL 里内置一个管理员账号比如admin / admin123你可以去hospital.sql里查看初始账号再和登录代码里的加密方式对一下。如果 SQL 里没有初始账号就通过注册页注册一个患者号再找后台管理页面调整权限这一步能顺带验证 JSP 表单到 Servlet 的参数传递。最小验证清单要落到三个页面login.jsp输入错误密码有没有提示登录成功跳首页还是个人中心。doctor_list.jsp打开后医生列表是否来自数据库科室筛选是否生效。appoint.jsp选择时间提交后挂号单表是否新增一条记录号源余量是否减一。这套闭环确认完才能证明部署环境是通的。如果一启动就白屏先看浏览器控制台的 500 错误再回catalina.out找完整堆栈不要盲目重启。项目跟数据库之间的连接参数在DBUtil.java里建议先改对这里再启动private static final String URL jdbc:mysql://localhost:3306/hospital?useUnicodetruecharacterEncodingUTF-8; private static final String USER root; private static final String PASSWORD yourpassword;URL里的useUnicodetruecharacterEncodingUTF-8必须保留否则中文参数传到数据库会变成问号。如果 MySQL 是 8.0把 URL 改成jdbc:mysql://localhost:3306/hospital?serverTimezoneAsia/ShanghaiuseSSLfalsecharacterEncodingUTF-8并确认WEB-INF/lib下是 8.x 驱动 jar。这一步参数对不上后面所有页面都会 500。4. 拆表设计与号源状态机预约挂号系统最核心的几段代码4.1 五张核心表之间的联系预约挂号系统的业务代码围绕一张排班表和一张挂号单表展开。看表结构前要明确字段名在不同源码里可能不同但关系基本一致表名常见字段作用userid, username, password, real_name, id_card患者 管理员departmentid, dept_name, intro科室doctorid, dept_id, doctor_name, title医生归属科室scheduleid, doctor_id, schedule_date, time_slot, total, remain排班与号源appointmentid, schedule_id, user_id, appoint_time, status挂号单关系上doctor.dept_id指向department.idschedule.doctor_id指向doctor.idappointment.schedule_id指向schedule.id。理解时要抓住一个核心预约系统的每一分钟号源是排班表里的一行不是医生表里的一行。医生表只存基础信息排班表把他分配到哪个日期、哪个时段、放出多少号。挂号单表每成功插一条schedule.remain就减一。这个模型把医生出诊和号码库存拆开一个医生一周的出诊安排只改排班表不用动医生表。表之间的关系在 DAO 里一般用多表 JOIN 体现。比如查“某科室医生剩余号源”的 SQLSELECT d.doctor_name, s.schedule_date, s.time_slot, s.remain FROM doctor d LEFT JOIN schedule s ON d.id s.doctor_id WHERE d.dept_id 1 AND s.schedule_date 2025-06-10 AND s.remain 0;LEFT JOIN而不是INNER JOIN是为了把没排班的医生也列出来显示“暂无号源”如果改成 INNER JOIN没排班的医生整行消失前端列表人数会莫名变少。参数说明schedule_date建议用 DATE 类型不要用 VARCHAR否则日期比较和索引都会变慢。4.2 号源状态流转从可约到已约的一行更新排班表里通常有一个状态位或者直接用remain余量表示。预约成功后最原始的写法是UPDATE schedule SET remain remain - 1 WHERE id ?; INSERT INTO appointment(user_id, schedule_id, status) VALUES (?, ?, 1);这种写法看起来合理但两台机器同时提交时两条remain remain - 1可能读到同一个旧值最后余量只减一造成超卖。所以成熟源码会把“检查余量 扣减”合并成一条带条件的 UPDATE。好的写法是UPDATE schedule SET remain remain - 1 WHERE id ? AND remain 0;如果受影响行数是 1说明这次扣号成功返回 0说明余量已满不能插入挂号单。插入操作要放在扣号成功之后并且扣号和插入最好在同一个事务里。老代码常见问题是不开事务扣号和插入分开执行插入一旦失败就会出现余量减了但挂号单不存在。写一个典型事务模板Connection conn DBUtil.getConnection(); conn.setAutoCommit(false); try { PreparedStatement ps1 conn.prepareStatement( UPDATE schedule SET remain remain - 1 WHERE id? AND remain 0); ps1.setInt(1, scheduleId); if (ps1.executeUpdate() 0) { conn.rollback(); // 返回“号源已满” } PreparedStatement ps2 conn.prepareStatement( INSERT INTO appointment(schedule_id, user_id, status) VALUES (?,?,1)); ps2.setInt(1, scheduleId); ps2.setInt(2, userId); ps2.executeUpdate(); conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.setAutoCommit(true); conn.close(); }这段代码的要害是setAutoCommit(false)和commit()之间。executeUpdate的返回值是受影响行数它天然告诉你remain 0是否成立rollback()保证扣减失败时不留下脏数据。如果用连接池最后务必把setAutoCommit(true)还原否则连接归还后事务状态污染下一次调用可能意外开启一个事务。4.3 排班冲突校验同一医生同一时段不能重叠除了防止超卖排班还容易出现的坑是后台管理员给同一个医生添加两条同一日期、同一时段的记录。如果没有唯一索引前端会显示两条一样的号源患者约谁都约到同一个医生。常见做法是在排班表上建唯一索引ALTER TABLE schedule ADD UNIQUE INDEX uk_doctor_time (doctor_id, schedule_date, time_slot);加了这个索引后重复插入会抛DuplicateKeyExceptionServlet 里捕获并提示“该医生此时间段已有排班”。注意time_slot是时段编号如 1 表示上午2 表示下午不要用“上午”这类展示字符串存否则唯一索引判断不出同一时段。业务上如果想处理节假日可以在维护排班的 Servlet 里先查日历表再决定是否允许排班。这种小改造不伤筋动骨适合作为二次开发练手点。5. 部署与二次开发常见问题排查驱动、乱码与并发超卖五个坑5.1 启动时报 ClassNotFoundException: com.mysql.jdbc.Driver现象Tomcat 启动后访问任意页面控制台抛出ClassNotFoundException: com.mysql.jdbc.Driver页面 500。原因分三种。第一WEB-INF/lib下没有 MySQL 驱动 jar第二用了 MySQL 8.0 驱动但代码里还是com.mysql.jdbc.Driver8.0 已经改名com.mysql.cj.jdbc.Driver第三jar 在 IDE 的 Build Path 里但不在WEB-INF/lib下Tomcat 运行时找不到。解决先把驱动 jar 放到WebContent/WEB-INF/lib。再打开DBUtil.java把Class.forName(...)参数改成与驱动包匹配的类名。老驱动 5.1.x 和新驱动 8.x 不要混用否则容易出现连上又断掉。5.2 JSP 页面中文乱码数据库里的中文也变成问号现象注册页提交中文姓名后页面显示乱码或 MySQL 里real_name存成了??。原因链条上有三处没统一为 UTF-8。第一JSP 头部缺pageEncoding第二Servlet 没执行request.setCharacterEncoding(UTF-8)第三JDBC 连接 URL 少characterEncodingUTF-8或者数据库表本身建的是 latin1。解决按顺序检查。所有 JSP 第一行改成% page contentTypetext/html; charsetUTF-8 pageEncodingUTF-8 %在doPost入口立刻加request.setCharacterEncoding(UTF-8)DBUtil 的连接 URL 加useUnicodetruecharacterEncodingUTF-8。如果数据库已经建好再执行ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4;。三处只要漏一处中文就可能在某环节变问号。5.3 并发点同一个号源两个人同时预约成功现象用两个浏览器或两个线程同时按“预约”两边都提示成功号源余量却只减一甚至出现多张挂号单。原因代码先SELECT remain判断是否大于 0再UPDATE。两个请求同时读到 remain1都判断可约然后各自插入挂号单造成超卖。这是最经典的竞态条件。解决改成“条件更新先行”也就是 4.2 节的事务代码。判断成功与否不靠查询靠UPDATE schedule SET remain remain - 1 WHERE id ? AND remain 0的影响行数。这行 SQL 是原子操作行锁会挡住第二个并发请求。如果源码里没有事务把预约逻辑包进setAutoCommit(false)/commit()防止只扣号不落单。5.4 页面进入后自动刷新一次导致表单重复提交现象打开预约提交页后页面加载完自动刷新一次用户还没操作一张空白挂号单已经生成。原因源码为了自动跳转在某个 JSP 的head里写了meta http-equivrefresh content0;url...但它放在表单页会让浏览器在渲染前再发一次 GET。这种 jsp 页面让加载完后刷新一次的写法用错位置就是坑。另外表单用 GET 提交时用户按 F5 也会重新提交。解决把自动刷新标签从表单页移除改成 Servlet 完成后用response.sendRedirect()跳转。表单提交方式统一为methodpost并在 Servlet 里接收参数后立刻重定向也就是 PRG 模式POST-Redirect-GET。重定向后的地址不保留表单数据刷新也不会重复提交。5.5 请求 404Servlet 映射不到或 URL 拼错了现象浏览器访问/hospital-register/admin/doctor_list返回 404但项目明明部署了。原因最频繁的是三种。URL 少了项目上下文路径servlet 映射路径和 JSP 表单 action 大小写不一致web.xml 和注解双重配置同一路径启动报冲突后容器忽略了其中一个。解决先在浏览器确认http://localhost:8080/hospital-register/是否能打开再按 web.xml 或WebServlet注解拼完整路径。建议所有内部链接都用${pageContext.request.contextPath}做前缀JSP 里不要写死/hospital-register否则目录改名后全部失效。确认映射没写错还是 404 的话清理 Tomcat 的work/Catalina缓存目录重启再看。6. 从课设到生产用并发压测验证防超卖再改一个连接池跑通源码只是第一步真正让这套系统站得住的是验证和改造。推荐做一个最小压测用 JMeter 建一个并发 20 的线程组全部请求同一个预约接口观察挂号单表最终记录数是否等于号源扣减数。这里不要通过 JSP 页面压直接写一个只返回 JSON 的测试接口或者用浏览器 F12 拿到表单提交的完整 URL把 POST 参数填进 JMeter。断言别只看“响应包含成功”要看数据库里appointment表最终行数再看schedule.remain有没有变成负数。另一个值得做的改造是替换DBUtil里的裸连接。老源码每次请求都DriverManager.getConnection()高并发下频繁创建和销毁连接MySQL 连接数很快被打满。常见做法是换成 HikariCP改动量其实很小引入 jar 后直接初始化数据源HikariConfig config new HikariConfig(); config.setJdbcUrl(jdbc:mysql://localhost:3306/hospital?characterEncodingUTF-8); config.setUsername(root); config.setPassword(yourpassword); config.setMaximumPoolSize(10); DataSource ds new HikariDataSource(config);这段代码里的setMaximumPoolSize(10)是最大连接数setJdbcUrl建议保留characterEncodingUTF-8。把DataSource接口类型作为公共字段再把原先DBUtil.getConnection()里的DriverManager.getConnection(...)替换成ds.getConnection()其余代码不用动。这样改完压测 100 并发时数据库连接不容易被打爆这也是接手老系统后性价比最高的一处升级。被这套老代码反复教育过后我拿到任何新项目第一件事都是先看请求出入口和事务边界而不是去纠结页面好不好看。JspServlet 源码正是练习这个习惯的好素材。希望这篇能让你少走我当年的弯路把号源并发这类问题一次看透。本文还有配套的精品资源点击获取 Jsp+Servlet医院预约挂号系统：源码部署、号源并发与二次开发全解析
简介基于JSPServlet的医院预约挂号系统源码压缩包面向Java Web课程设计、毕业设计及初学Servlet/JSP的开发者提供一套可运行、可扩展的完整项目工程。系统涵盖患者预约、医生排班、后台管理、用户登录认证等核心模块并对MVC分层、JDBC/SQL数据库操作、异步并发与安全防护等关键实现均有体现。资源共1431个文件压缩包约30.98MB主要包含78个JSP页面、23个Java类、400个JS脚本、46个class文件以及62个jar依赖库、40个CSS样式和1个SQL脚本前端页面与后端逻辑分层清晰便于直接导入IDE运行和二次开发。已有208人学习下载源码目录结构完整配合数据库脚本和部署配置可帮助读者快速理解预约挂号业务流程掌握从页面交互到服务端处理的完整Java Web开发链路。包内同时附有常用富文本编辑器、页面样式与数据库初始化文件可作为毕业设计答辩和项目实战的双重参考。1. JspServlet医院预约挂号系统老技术栈为什么还值得认真跑一遍你下载了一个基于JspServlet医院预约挂号系统源码.zip解压一看就是典型的 Java 课程设计布局src 里一堆 Servlet 和 DAOWebContent 里是 JSP根目录还放着hospital.sql。这套技术栈听起来老但如果你是在交 Java Web 课设或者刚接手一个十年前上线的老挂号系统它反而是最值得研究的东西JspServletJDBC 把 HTTP 请求、会话、数据库事务这些底子全暴露在代码里没有框架帮你掩盖。预约挂号表面上是页面跳转真正难点在号源并发和排班冲突而老代码里恰好能看到最原始的解决方式。下面按“源码里有什么 → 怎么跑起来 → 号源怎么设计 → 坑在哪 → 怎么验证”一路拆开讲。2. 先看清源码结构解压后从哪里开始看 JspServlet 项目2.1 源码包里到底有什么先盘文件再谈部署拿到 zip 以后别急着往 Tomcat 里丢。先解压用 tree 命令或直接看目录结构。一个标准的 JspServlet 工程通常长这样hospital-register/ ├── src/ │ └── com/hospital/ │ ├── entity/ # 用户、医生、科室、排班、挂号单的 JavaBean │ ├── dao/ # JDBC 操作类负责 query 和 update │ ├── servlet/ # 请求入口doGet/doPost 里做业务分发 │ └── util/ # DBUtil 数据库连接工具、字符串工具 ├── WebContent/ │ ├── css/ js/ images/ │ ├── jsp/ │ │ ├── login.jsp # 登录页面 │ │ ├── register.jsp # 患者注册 │ │ ├── doctor_list.jsp# 医生列表/科室列表 │ │ └── appoint.jsp # 预约提交页 │ └── WEB-INF/ │ ├── web.xml # Servlet 映射、欢迎文件、过滤器配置 │ └── lib/ # mysql-connector-java.jar、jstl.jar └── hospital.sql # 建库建表 初始数据这段目录树是整个源码包的索引。先看src/com/hospital/servlet下有多少 Servlet 类、分别叫什么你就能猜出系统有哪些功能模块再看web.xml里的 servlet-mapping能确认浏览器访问的 URL 最终交给哪个类。很多新手一上来就翻 JSP结果被一堆% %和 EL 表达式绕晕其实 JSP 只是视图层真正的业务逻辑都在 Servlet 和 DAO 里。接着打开hospital.sql搜索CREATE TABLE数一下有几张表。预约挂号系统最小编码一般是五张表用户表、科室表、医生表、排班表、挂号单表有的源码还加管理员表。把表数量和 Servlet 数量记下来这一步花五分钟后面部署和排错能省半小时。注意部署前先看清源码里的包名我的示例是com.hospital每个源码不一定一样。后面改配置时以实际包名为准别照抄教程里的全限定名。2.2 从浏览器到数据库一次预约请求的完整链路JspServlet 项目的运行逻辑比 Spring Boot 直白浏览器提交表单 → Tomcat 根据web.xml里的 URL 映射找 Servlet → Servlet 在doPost里接收参数 → 调用 DAO 操作数据库 → 跳转或转发到 JSP 渲染结果。这条链路也是你后续排查问题的顺序。先看 web.xml 里最关键的映射servlet servlet-nameAppointServlet/servlet-name servlet-classcom.hospital.servlet.AppointServlet/servlet-class /servlet servlet-mapping servlet-nameAppointServlet/servlet-name url-pattern/patient/appoint/url-pattern /servlet-mapping这段配置被 Web 容器读取后请求/patient/appoint就会进入AppointServlet。注意servlet-class必须是全限定名大小写不能错url-pattern以/开头但不要写成.jsp结尾。如果你的源码用的是WebServlet(/patient/appoint)注解web.xml 里可能没有这段映射两种配置方式不要混用同一个路径否则启动时会报重复映射。对应的 Servlet 骨架一般是这样的WebServlet(/patient/appoint) public class AppointServlet extends HttpServlet { Override protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String userId request.getParameter(userId); String scheduleId request.getParameter(scheduleId); // 调用 service/dao 执行预约 int result appointDao.createAppointment(userId, scheduleId); if (result 0) { response.sendRedirect(request.getContextPath() /myAppoint.jsp); } else { response.setContentType(text/html;charsetUTF-8); response.getWriter().write(scriptalert(号源已满);history.back();/script); } } }doGet和doPost的分工不要弄反页面点按钮一般是 POST直接在地址栏访问是 GET。很多源码为了让两种方式都能处理会在doGet里直接调用doPost这是省事的常见写法但要注意安全比如把“取消预约”这种写操作暴露成 GET容易被恶意链接触发。读完代码后建议把“写操作都放 doPost”当成规范记下来。再往下看 DAO 层核心就是一段 JDBC 代码。比如按科室查医生列表String sql SELECT * FROM doctor WHERE dept_id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, deptId); try (ResultSet rs ps.executeQuery()) { ListDoctor list new ArrayList(); while (rs.next()) { Doctor d new Doctor(); d.setId(rs.getInt(id)); d.setName(rs.getString(name)); list.add(d); } request.setAttribute(doctorList, list); } }用PreparedStatement而不是拼接字符串是为了防 SQL 注入这也是老源码少数做得对的地方。参数说明setInt(1, deptId)中的1是第一个问号的下标只能从 1 开始rs.getInt(id)里的id是数据库列名。DBUtil.getConnection()内部通常写死 URL、用户名、密码部署时第一件事就是改这里。2.3 先分清三种 JSP 页面再看个人信息展示页面源码里的 JSP 大致分三类登录注册这种入口页、科室/医生列表这种查询页、挂号单管理这种个人中心页。个人中心页里最常见的功能就是 jsp 个人信息展示页面显示当前登录用户的姓名、手机、历史挂号记录通常从 session 里取用户对象再查一次挂号单表。看这类页面时注意两点。第一它是不是直接用% user.getRealName() %输出用户信息如果是说明服务端把User对象塞进了request或session属性第二它有没有做空值判断。如果 session 过期user为 null页面直接报NullPointerException这也是为什么很多老系统看完列表再点详情就 500 的原因。常见修正是在页面顶部用c:if标签或提前response.sendRedirect(login.jsp)。补一个 JSP 片段说明取值方式% User loginUser (User) session.getAttribute(loginUser); if (loginUser null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } % p当前用户%loginUser.getRealName()%/p逻辑说明session.getAttribute(loginUser)拿到的是登录时塞进去的对象不是每次请求都重新查库如果返回 null说明会话过期需要跳回登录页。参数说明request.getContextPath()拿的是项目上下文路径所有链接跳转最好都带上它避免部署时改了 webapps 下的目录名导致全站链接失效。这套“session 里拿用户、页面顶部防空”的写法是理解这个源码后端状态管理最快的抓手。3. 把源码跑到本地Tomcat MySQL 环境搭建与最小部署步骤3.1 一个版本组合先定死JDK 8、Tomcat 8.5、MySQL 5.7部署老代码第一件事不是导入 IDE而是先把运行环境三件套对齐。JspServlet 项目对版本很敏感JDK 6/7 时代写的源码放到 JDK 17 上经常因为模块化问题启动失败Tomcat 10 已经把javax.servlet包改成jakarta.servlet老代码的import javax.servlet.*直接编译不过。因此最稳妥的组合是JDK 1.8 Tomcat 8.5.x MySQL 5.7。如果想用 MySQL 8.0也可以但要换驱动类名com.mysql.cj.jdbc.Driver并在连接 URL 上追加serverTimezoneAsia/Shanghai否则会报时区错误。环境参数表组件推荐版本必改配置JDK1.88u201 以上系统变量 JAVA_HOME 指向安装目录Tomcat8.5.x修改 catalina.bat 或 startup.sh 设置 JRE_HOMEMySQL5.7 或 8.0默认端口 3306字符集 utf8MySQL 驱动5.1.47对应 5.7放入 WEB-INF/lib项目编码UTF-8全局文件编码 数据库表编码这里的版本参数不是在硬凑而是这种课程设计最常见的环境。如果机器已经装了 JDK 17 也没关系单独再解压一个 JDK 8在 Tomcat 启动脚本里指定JAVA_HOME指向它不必卸载当前 JDK。我一般把 Tomcat 解压到D:\dev\apache-tomcat-8.5.100项目直接拷到webapps下越简单越不容易翻车。3.2 导入数据库并启动项目两条命令加一条访问路径执行这一步前先确认 MySQL 服务已启动root 密码自己知道。如果源码提供了hospital.sql直接在命令行导入mysql -uroot -p mysql CREATE DATABASE hospital DEFAULT CHARACTER SET utf8mb4; mysql USE hospital; mysql SOURCE E:/path/to/hospital.sql;或者一条命令完成mysql -uroot -p E:/path/to/hospital.sql逻辑说明CREATE DATABASE指定utf8mb4是为了让中文用户名和医生姓名能正常显示。SOURCE命令把 SQL 文件里的建表语句和数据逐条执行。如果执行过程报错不要急着跳过先看是语法错误还是缺权限。语法错误说明源码里的 SQL 和 MySQL 版本不兼容最常见的坑是ENGINEMyISAM或timestamp默认值写法不同。接着把整个项目目录复制到 Tomcat 的webapps文件夹下。如果项目目录名是hospital-register启动 Tomcat 后访问地址就是http://localhost:8080/hospital-register/。cd /usr/local/tomcat/bin ./startup.sh # Windows 下是 startup.bat启动后看日志logs/catalina.out确认没有异常。补一个常用排错动作先在浏览器输入http://localhost:8080/能看到 Tomcat 默认首页说明容器没问题再加项目名出现 404问题多半在项目的web.xml或数据库连接上而不是 Tomcat 本身。3.3 用最小登录流程验证源码是否打通环境起来以后不要急着点菜单先按“登录 → 查医生 → 预约 → 后台确认”的最小闭环走一遍。多数源码会在 SQL 里内置一个管理员账号比如admin / admin123你可以去hospital.sql里查看初始账号再和登录代码里的加密方式对一下。如果 SQL 里没有初始账号就通过注册页注册一个患者号再找后台管理页面调整权限这一步能顺带验证 JSP 表单到 Servlet 的参数传递。最小验证清单要落到三个页面login.jsp输入错误密码有没有提示登录成功跳首页还是个人中心。doctor_list.jsp打开后医生列表是否来自数据库科室筛选是否生效。appoint.jsp选择时间提交后挂号单表是否新增一条记录号源余量是否减一。这套闭环确认完才能证明部署环境是通的。如果一启动就白屏先看浏览器控制台的 500 错误再回catalina.out找完整堆栈不要盲目重启。项目跟数据库之间的连接参数在DBUtil.java里建议先改对这里再启动private static final String URL jdbc:mysql://localhost:3306/hospital?useUnicodetruecharacterEncodingUTF-8; private static final String USER root; private static final String PASSWORD yourpassword;URL里的useUnicodetruecharacterEncodingUTF-8必须保留否则中文参数传到数据库会变成问号。如果 MySQL 是 8.0把 URL 改成jdbc:mysql://localhost:3306/hospital?serverTimezoneAsia/ShanghaiuseSSLfalsecharacterEncodingUTF-8并确认WEB-INF/lib下是 8.x 驱动 jar。这一步参数对不上后面所有页面都会 500。4. 拆表设计与号源状态机预约挂号系统最核心的几段代码4.1 五张核心表之间的联系预约挂号系统的业务代码围绕一张排班表和一张挂号单表展开。看表结构前要明确字段名在不同源码里可能不同但关系基本一致表名常见字段作用userid, username, password, real_name, id_card患者 管理员departmentid, dept_name, intro科室doctorid, dept_id, doctor_name, title医生归属科室scheduleid, doctor_id, schedule_date, time_slot, total, remain排班与号源appointmentid, schedule_id, user_id, appoint_time, status挂号单关系上doctor.dept_id指向department.idschedule.doctor_id指向doctor.idappointment.schedule_id指向schedule.id。理解时要抓住一个核心预约系统的每一分钟号源是排班表里的一行不是医生表里的一行。医生表只存基础信息排班表把他分配到哪个日期、哪个时段、放出多少号。挂号单表每成功插一条schedule.remain就减一。这个模型把医生出诊和号码库存拆开一个医生一周的出诊安排只改排班表不用动医生表。表之间的关系在 DAO 里一般用多表 JOIN 体现。比如查“某科室医生剩余号源”的 SQLSELECT d.doctor_name, s.schedule_date, s.time_slot, s.remain FROM doctor d LEFT JOIN schedule s ON d.id s.doctor_id WHERE d.dept_id 1 AND s.schedule_date 2025-06-10 AND s.remain 0;LEFT JOIN而不是INNER JOIN是为了把没排班的医生也列出来显示“暂无号源”如果改成 INNER JOIN没排班的医生整行消失前端列表人数会莫名变少。参数说明schedule_date建议用 DATE 类型不要用 VARCHAR否则日期比较和索引都会变慢。4.2 号源状态流转从可约到已约的一行更新排班表里通常有一个状态位或者直接用remain余量表示。预约成功后最原始的写法是UPDATE schedule SET remain remain - 1 WHERE id ?; INSERT INTO appointment(user_id, schedule_id, status) VALUES (?, ?, 1);这种写法看起来合理但两台机器同时提交时两条remain remain - 1可能读到同一个旧值最后余量只减一造成超卖。所以成熟源码会把“检查余量 扣减”合并成一条带条件的 UPDATE。好的写法是UPDATE schedule SET remain remain - 1 WHERE id ? AND remain 0;如果受影响行数是 1说明这次扣号成功返回 0说明余量已满不能插入挂号单。插入操作要放在扣号成功之后并且扣号和插入最好在同一个事务里。老代码常见问题是不开事务扣号和插入分开执行插入一旦失败就会出现余量减了但挂号单不存在。写一个典型事务模板Connection conn DBUtil.getConnection(); conn.setAutoCommit(false); try { PreparedStatement ps1 conn.prepareStatement( UPDATE schedule SET remain remain - 1 WHERE id? AND remain 0); ps1.setInt(1, scheduleId); if (ps1.executeUpdate() 0) { conn.rollback(); // 返回“号源已满” } PreparedStatement ps2 conn.prepareStatement( INSERT INTO appointment(schedule_id, user_id, status) VALUES (?,?,1)); ps2.setInt(1, scheduleId); ps2.setInt(2, userId); ps2.executeUpdate(); conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.setAutoCommit(true); conn.close(); }这段代码的要害是setAutoCommit(false)和commit()之间。executeUpdate的返回值是受影响行数它天然告诉你remain 0是否成立rollback()保证扣减失败时不留下脏数据。如果用连接池最后务必把setAutoCommit(true)还原否则连接归还后事务状态污染下一次调用可能意外开启一个事务。4.3 排班冲突校验同一医生同一时段不能重叠除了防止超卖排班还容易出现的坑是后台管理员给同一个医生添加两条同一日期、同一时段的记录。如果没有唯一索引前端会显示两条一样的号源患者约谁都约到同一个医生。常见做法是在排班表上建唯一索引ALTER TABLE schedule ADD UNIQUE INDEX uk_doctor_time (doctor_id, schedule_date, time_slot);加了这个索引后重复插入会抛DuplicateKeyExceptionServlet 里捕获并提示“该医生此时间段已有排班”。注意time_slot是时段编号如 1 表示上午2 表示下午不要用“上午”这类展示字符串存否则唯一索引判断不出同一时段。业务上如果想处理节假日可以在维护排班的 Servlet 里先查日历表再决定是否允许排班。这种小改造不伤筋动骨适合作为二次开发练手点。5. 部署与二次开发常见问题排查驱动、乱码与并发超卖五个坑5.1 启动时报 ClassNotFoundException: com.mysql.jdbc.Driver现象Tomcat 启动后访问任意页面控制台抛出ClassNotFoundException: com.mysql.jdbc.Driver页面 500。原因分三种。第一WEB-INF/lib下没有 MySQL 驱动 jar第二用了 MySQL 8.0 驱动但代码里还是com.mysql.jdbc.Driver8.0 已经改名com.mysql.cj.jdbc.Driver第三jar 在 IDE 的 Build Path 里但不在WEB-INF/lib下Tomcat 运行时找不到。解决先把驱动 jar 放到WebContent/WEB-INF/lib。再打开DBUtil.java把Class.forName(...)参数改成与驱动包匹配的类名。老驱动 5.1.x 和新驱动 8.x 不要混用否则容易出现连上又断掉。5.2 JSP 页面中文乱码数据库里的中文也变成问号现象注册页提交中文姓名后页面显示乱码或 MySQL 里real_name存成了??。原因链条上有三处没统一为 UTF-8。第一JSP 头部缺pageEncoding第二Servlet 没执行request.setCharacterEncoding(UTF-8)第三JDBC 连接 URL 少characterEncodingUTF-8或者数据库表本身建的是 latin1。解决按顺序检查。所有 JSP 第一行改成% page contentTypetext/html; charsetUTF-8 pageEncodingUTF-8 %在doPost入口立刻加request.setCharacterEncoding(UTF-8)DBUtil 的连接 URL 加useUnicodetruecharacterEncodingUTF-8。如果数据库已经建好再执行ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4;。三处只要漏一处中文就可能在某环节变问号。5.3 并发点同一个号源两个人同时预约成功现象用两个浏览器或两个线程同时按“预约”两边都提示成功号源余量却只减一甚至出现多张挂号单。原因代码先SELECT remain判断是否大于 0再UPDATE。两个请求同时读到 remain1都判断可约然后各自插入挂号单造成超卖。这是最经典的竞态条件。解决改成“条件更新先行”也就是 4.2 节的事务代码。判断成功与否不靠查询靠UPDATE schedule SET remain remain - 1 WHERE id ? AND remain 0的影响行数。这行 SQL 是原子操作行锁会挡住第二个并发请求。如果源码里没有事务把预约逻辑包进setAutoCommit(false)/commit()防止只扣号不落单。5.4 页面进入后自动刷新一次导致表单重复提交现象打开预约提交页后页面加载完自动刷新一次用户还没操作一张空白挂号单已经生成。原因源码为了自动跳转在某个 JSP 的head里写了meta http-equivrefresh content0;url...但它放在表单页会让浏览器在渲染前再发一次 GET。这种 jsp 页面让加载完后刷新一次的写法用错位置就是坑。另外表单用 GET 提交时用户按 F5 也会重新提交。解决把自动刷新标签从表单页移除改成 Servlet 完成后用response.sendRedirect()跳转。表单提交方式统一为methodpost并在 Servlet 里接收参数后立刻重定向也就是 PRG 模式POST-Redirect-GET。重定向后的地址不保留表单数据刷新也不会重复提交。5.5 请求 404Servlet 映射不到或 URL 拼错了现象浏览器访问/hospital-register/admin/doctor_list返回 404但项目明明部署了。原因最频繁的是三种。URL 少了项目上下文路径servlet 映射路径和 JSP 表单 action 大小写不一致web.xml 和注解双重配置同一路径启动报冲突后容器忽略了其中一个。解决先在浏览器确认http://localhost:8080/hospital-register/是否能打开再按 web.xml 或WebServlet注解拼完整路径。建议所有内部链接都用${pageContext.request.contextPath}做前缀JSP 里不要写死/hospital-register否则目录改名后全部失效。确认映射没写错还是 404 的话清理 Tomcat 的work/Catalina缓存目录重启再看。6. 从课设到生产用并发压测验证防超卖再改一个连接池跑通源码只是第一步真正让这套系统站得住的是验证和改造。推荐做一个最小压测用 JMeter 建一个并发 20 的线程组全部请求同一个预约接口观察挂号单表最终记录数是否等于号源扣减数。这里不要通过 JSP 页面压直接写一个只返回 JSON 的测试接口或者用浏览器 F12 拿到表单提交的完整 URL把 POST 参数填进 JMeter。断言别只看“响应包含成功”要看数据库里appointment表最终行数再看schedule.remain有没有变成负数。另一个值得做的改造是替换DBUtil里的裸连接。老源码每次请求都DriverManager.getConnection()高并发下频繁创建和销毁连接MySQL 连接数很快被打满。常见做法是换成 HikariCP改动量其实很小引入 jar 后直接初始化数据源HikariConfig config new HikariConfig(); config.setJdbcUrl(jdbc:mysql://localhost:3306/hospital?characterEncodingUTF-8); config.setUsername(root); config.setPassword(yourpassword); config.setMaximumPoolSize(10); DataSource ds new HikariDataSource(config);这段代码里的setMaximumPoolSize(10)是最大连接数setJdbcUrl建议保留characterEncodingUTF-8。把DataSource接口类型作为公共字段再把原先DBUtil.getConnection()里的DriverManager.getConnection(...)替换成ds.getConnection()其余代码不用动。这样改完压测 100 并发时数据库连接不容易被打爆这也是接手老系统后性价比最高的一处升级。被这套老代码反复教育过后我拿到任何新项目第一件事都是先看请求出入口和事务边界而不是去纠结页面好不好看。JspServlet 源码正是练习这个习惯的好素材。希望这篇能让你少走我当年的弯路把号源并发这类问题一次看透。本文还有配套的精品资源点击获取