简介一份基于Java语言并结合SSM框架的智慧医院门诊管理系统项目源码专门面向需要完成毕业设计、课程设计以及正在学习Java Web开发的学生和开发者旨在解决从数据库设计到前端页面展示的完整业务闭环问题。资源压缩包共包含1987个文件整体大小约7.86MB文件构成以SVG矢量图标、Java源码、SCSS样式、JavaScript脚本、CSS样式表和HTML页面为主同时包含MySQL数据库脚本、Maven构建脚本与项目配置文件覆盖了前端资源、后端逻辑和部署运行所需的全部要素。项目基于SSM框架整合MySQL数据库前端采用Bootstrap与JSP技术实现页面展示核心功能包括注册登录、挂号、就诊、缴费、药品管理、信息管理等模块代码结构分层清晰业务逻辑完整方便在此基础上快速理解并进行二次扩展。目前已有1267人浏览学习对于需要一套可运行源码作为毕业设计参考、课程设计练习的读者来说是一份可以直接导入开发工具使用的项目资料。1. SSM智慧门诊项目拆解为什么这一份源码值得跑通全流程毕业设计拿到“基于SSM的医院门诊管理系统”时很多人第一反应是去改界面、换Logo结果改了三天挂号模块还是 404。真正值得先做的事是把 SpringMVC 的请求链路、MyBatis 的 SQL 映射、Bootstrap 页面的 AJAX 回调这三条线串起来。SSM 组合在今天依然被大量中小型系统使用门诊挂号缴费的业务量级刚好覆盖了增删改查、状态流转、一对多关联这些高频考点。这个项目适合课程设计或毕业设计的原因也在这里结构规整、模块边界清楚、跑起来后能马上看出“挂号、就诊、缴费、药品、信息”五个主功能的完整闭环。对熟悉 Java 但没写过完整 Web 项目的人来说它是性价比很高的练手样本。2. SSM门诊系统环境搭建与Maven Wrapper启动细节2.1 先确认这几类文件再决定下一步压缩包里既有mvnw.cmd又有sb-admin-2.css、bootstrap.css、all.css这类前端静态资源文件说明这个项目不是为了“只能在 IDEA 里打开”而做的作者同时在为命令行构建和静态资源路径留了手。拿到源码后不要直接点mvnw.cmd先静态检查项目结构find . -name *.java | head -20 find src/main/resources -name *.xml find src/main/webapp -name *.xml | grep WEB-INF第一行看 Java 包名和 Controller 数量第二行看 Spring 配置是否存在第三行看web.xml是否在WEB-INF下。我见过不少毕业设计运行失败不是因为业务代码写错而是spring-mvc.xml的扫描包路径写成了com.controller实际类却放在com.hospital.controller启动时 Bean 全部没扫描到页面直接 404。这里有一个简单判断方法看web.xml中contextConfigLocation和DispatcherServlet的init-param路径是不是真实存在于 resources 目录。如果项目提供的是.zip解压后先重新导入 IDEA再执行一次mvn clean目的是清除本地可能的旧编译产物避免.class残留造成“改代码不生效”。同时检查一下是否附带.sql脚本门诊系统没有测试数据登录取值都会是空列表不便于后续验证。2.2 Maven Wrapper 与 pom.xml 依赖等级mvnw.cmd是 Windows 下的 Maven Wrapper 脚本它的意义在于固定了构建用的 Maven 版本不需要本机安装 3.8 还是 3.9项目会根据 wrapper 配置下载对应版本。在项目根目录执行mvnw.cmd clean package -DskipTests如果你在 Linux 或 Mac 上操作对应命令是./mvnw clean package -DskipTests-DskipTests的作用是跳过单元测试减少打包耗时。打包成功后会看到target/xxx.war这个 war 可以直接丢进 Tomcat 的webapps目录也可以交给 IDEA 的 Tomcat 运行配置使用。SSM 项目的启动依赖集中在 pom.xml 里一个典型的依赖集合如下dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.25.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.7/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version scoperuntime/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies这里不要用太新的 Spring 6.x因为 Spring 6 基于 Jakarta EE和 Tomcat 8.5/9.0 的javax.servlet包不兼容。课程设计场景下Spring 5.2.x MyBatis 3.5.x MySQL 5.7 是兼容面最广的组合。mysql-connector-java版本对齐 5.1.49如果换成 8.0 还要额外处理时区参数对初学项目来说没必要。下面这张表是 SSM 工程里不能缺的配置位置文件相对路径在项目里的职责src/main/resources/spring-dao.xml装配数据源、SqlSessionFactory、MapperScannerConfigurersrc/main/resources/spring-mvc.xml开启注解驱动、扫描 Controller、配置视图解析器src/main/webapp/WEB-INF/web.xml加载 Spring 容器、注册 DispatcherServlet、配置字符过滤器src/main/resources/jdbc.properties保存数据库连接地址、账号、密码部分项目会把spring-dao.xml与spring-service.xml分开分得越细越方便在答辩时讲清楚“Spring 容器到底管理了什么”。这属于 SSM 整合的常见做法不是必须照搬。2.3 Tomcat 部署参数这样设常见做法是在 IDEA 里建一个 Tomcat 运行配置。以 Tomcat 8.5 为例打开 Run/Debug Configurations新增 Tomcat ServerLocal然后到 Deployment 页签添加xxx:war exploded。这里的参数值得注意Application context: /Application context如果填成/hospital那么所有c:url和request.getContextPath()获得的地址会自动带前缀而静态资源路径写死成/static/...的页面就会全部 404。所以要么统一用绝对路径ctx /static要么直接把 context 设成/。项目里出现sb-admin-2.css这种后台模板说明前端大量引入第三方静态资源路径问题尤其要注意。启动前还要确认jdbc.properties里的数据库名、用户名、密码和本机一致。常见错误是只改了库名没改端口或者密码含特殊字符时没有做转义。数据库连接串可以写成jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password123456useUnicodetruecharacterEncodingutf8是中文项目最容易漏的两项漏掉后 JSP 页面显示正常但写入数据库后中文变成“???”。useSSLfalse是为了规避 MySQL 5.7 与 Connector/J 的 SSL 握手警告。如果使用 Druid 连接池还会在spring-dao.xml里看到maxActive、initialSize这些参数平时调试可以调小一点避免连接占满。2.4 启动失败先看日志头三行SSM 项目启动报错先不要翻到异常栈最下面直接看第一行 Caused by。整理几个高频情况ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet说明 Tomcat 部署的工件没有把 Maven 依赖带进去在 Artifacts 里把lib目录加入WEB-INF/lib。Could not resolve placeholder jdbc.url说明spring-dao.xml里context:property-placeholder locationclasspath:jdbc.properties/的路径和实际文件名不一致。Invalid bound statement (not found): com.xxx.RegisterMapper.insert说明 Mapper 接口已经扫描但 XML 文件不在mybatis.mapper-locations指定的路径下。这三种错误占了这个项目启动问题的绝大多数按上面顺序检查即可。3. 挂号、就诊、缴费链路中的SSM三层实现拆解3.1 门诊业务表如何拆门诊管理系统的核心不是医生表而是“挂号单”的状态。只要把t_register表的状态字段设计清楚后面的就诊、缴费、退号都只是状态迁移。一个比较合理的表结构如下表名关键字段作用t_userusername,password,role注册登录与角色区分t_patientpatient_name,id_card,phone患者基础信息挂号时关联t_doctordoctor_name,department_id,remain_count医生信息与号源余量t_registerregister_no,patient_id,doctor_id,status挂号主表状态贯穿全流程t_prescriptionregister_id,medicine_id,total_price处方明细缴费时汇总status字段建议用字符串枚举WAIT表示待就诊TREATING表示就诊中FINISH表示已诊完PAID表示缴费完成CANCEL表示退号。用字符串枚举比用 0/1/2/3 好在答辩时直观页面上也能少一层转换逻辑。挂号时插入一条WAIT状态的记录就诊时更新为TREATING开完处方再更新为FINISH缴费成功后置为PAID。3.2 Controller 层挂号入口怎么写挂号模块的前端表单通常只提交两个参数patientId和doctorId。后端 Controller 要做的是把参数收下来交给 Service再返回 JSON 给页面。下面的代码是一个典型的 SpringMVC 接口Controller public class RegisterController { Autowired private RegisterService registerService; RequestMapping(/register/add) ResponseBody public MapString, Object addRegister(RequestParam Integer patientId, RequestParam Integer doctorId) { int registerId registerService.createRegister(patientId, doctorId); MapString, Object result new HashMap(); result.put(success, registerId 0); result.put(registerId, registerId); return result; } }ResponseBody会把返回的 Map 序列化成 JSON前端直接用data.success判断是否成功。RequestParam从 query string 或表单体取参数默认是必填参数。如果前端传参名叫patient_id这里就得写RequestParam(patient_id)否则会直接 400。这里只负责参数接收和响应封装真正的业务判断必须到 Service 层。3.3 Service 层事务号源扣减与挂号记录必须原子操作挂号最容易被答辩老师追问的问题是多个患者同时挂同一个医生怎么办如果先查余号、再插入挂号、最后扣减余号三步操作必须放在同一个事务里。常见实现是Service public class RegisterServiceImpl implements RegisterService { Autowired private RegisterMapper registerMapper; Autowired private DoctorMapper doctorMapper; Override Transactional(rollbackFor Exception.class) public int createRegister(Integer patientId, Integer doctorId) { Doctor doctor doctorMapper.selectById(doctorId); if (doctor.getRemainCount() 0) { throw new BizException(当前医生号源已约满); } Register record new Register(); record.setPatientId(patientId); record.setDoctorId(doctorId); record.setStatus(WAIT); record.setRegisterTime(new Date()); registerMapper.insert(record); doctorMapper.decreaseRemainCount(doctorId); return record.getId(); } }Transactional(rollbackFor Exception.class)是为了让 RuntimeException 和普通 Exception 都触发回滚。默认情况下Spring 只对 RuntimeException 回滚如果这里抛出的是受检异常不加rollbackFor就会出现“挂号单插进去了余号却没有扣减”的脏状态。BizException是自定义业务异常抛出后由全局异常处理器转成 JSON 返回给前端。3.4 MyBatis 映射insert 要拿到自增主键挂号记录由数据库自增主键生成MyBatis 里必须配置useGeneratedKeys否则record.getId()永远返回 null。推荐映射写法insert idinsert parameterTypeRegister useGeneratedKeystrue keyPropertyid INSERT INTO t_register(patient_id, doctor_id, status, register_time) VALUES(#{patientId}, #{doctorId}, #{status}, #{registerTime}) /insert update iddecreaseRemainCount parameterTypeint UPDATE t_doctor SET remain_count remain_count - 1 WHERE id #{id} AND remain_count 0 /updateuseGeneratedKeys要对应数据库自增列keyProperty对应实体类的主键属性。第二个 SQL 里AND remain_count 0是非常实用的并发兜底即使在 Service 层判断过余号数据库层面也保证不会把余号扣成负数。影响行数为 0 时事务会因抛出的自定义异常而回滚。3.5 缴费模块处方明细与状态更新的顺序缴费模块不建议直接用UPDATE t_register SET statusPAID一条语句完成因为页面要展示缴费明细数据来源是t_prescription表。更合理的顺序是先按registerId汇总处方金额插入缴费流水再更新挂号状态。用 SQL 模拟就是SELECT SUM(total_price) FROM t_prescription WHERE register_id 1; INSERT INTO t_payment(register_id, total_amount, pay_time) VALUES(1, 68.5, NOW()); UPDATE t_register SET status PAID WHERE id 1;这里的t_payment表可以看作是流水记录答辩时可以讲它的作用是为了财务对账而不只是改一个状态字段。前端缴费按钮点击后AJAX 请求/payment/pay后端在一个事务里完成以上三步。4. MyBatis映射与BootstrapAJAX的页面联调4.1 JSP静态资源路径统一用上下文前缀项目静态资源包含sb-admin-2.css、bootstrap.css、fontawesome.css等。它们通常会放在webapp/static/css和webapp/static/js目录下。JSP 页面如果直接写link relstylesheet href/static/css/bootstrap.css一旦部署时Application context不是/这个绝对路径就指向了服务器根目录而不是项目上下文。我一般会在 JSP 顶部声明一个全局变量% String ctx request.getContextPath(); request.setAttribute(ctx, ctx); % link relstylesheet href${ctx}/static/css/bootstrap.css script src${ctx}/static/js/jquery.min.js/script script src${ctx}/static/js/bootstrap.js/script这样无论部署在/还是/hospital资源都能正常加载。使用sb-admin-2.css这类后台模板时还需要注意它依赖 jQuery 和 Bootstrap 的加载顺序jQuery 必须在前Bootstrap JS 在后否则下拉菜单和弹窗组件无法初始化。4.2 用AJAX局部刷新替代整页跳转门诊选择科室后医生列表应该跟着变化。常见做法是页面先加载科室下拉框用户选择后再请求医生列表。后端接口可以设计为RequestMapping(value /doctor/listByDepartment, produces application/json;charsetUTF-8) ResponseBody public ListDoctor listByDepartment(RequestParam Integer deptId) { return doctorService.listByDepartment(deptId); }前端 JS 通过 jQuery 发起请求$.ajax({ url: ctx /doctor/listByDepartment, data: { deptId: deptId }, dataType: json, success: function (list) { var html ; for (var i 0; i list.length; i) { html option value list[i].id list[i].doctorName 剩余: list[i].remainCount /option; } $(#doctorSelect).html(html); }, error: function () { alert(医生列表加载失败); } });url里的ctx是上面定义的上下文变量。deptId是从科室下拉框取到的值。这样处理比整页刷新更符合“智慧门诊”的交互体验也更容易在答辩中展示知识点AJAX 请求、JSON 响应、DOM 动态更新。要注意的是如果后端实体类字段是doctorNameJackson 默认会把属性名序列化成doctorName所以两端对齐时按驼峰规则写。4.3 组合查询用 动态拼接信息管理模块通常有关键字查询、科室筛选、状态筛选。如果给每一个查询条件写一个 SQL 方法不仅冗长后期加条件还得改接口。MyBatis 的whereif能在一个方法里完成动态 SQLselect idselectRegisterPage parameterTypemap resultTypeRegisterVO SELECT r.id, r.register_no, p.patient_name, d.doctor_name, r.status, r.register_time FROM t_register r LEFT JOIN t_patient p ON r.patient_id p.id LEFT JOIN t_doctor d ON r.doctor_id d.id where if testpatientName ! null and patientName ! AND p.patient_name LIKE CONCAT(%, #{patientName}, %) /if if testdoctorId ! null AND r.doctor_id #{doctorId} /if if teststatus ! null and status ! AND r.status #{status} /if /where ORDER BY r.register_time DESC /selectwhere标签会自动去掉第一个条件前面的AND这是比手动写WHERE 11更规范的做法。LIKE CONCAT(%, #{patientName}, %)使用参数占位符而不是字符串拼接可以避免 SQL 注入。RegisterVO是一个视图对象用于关联查询展示它不是简单对应一张表而是拼接了患者和医生的冗余字段。4.4 联调时最容易踩的五个问题现象原因处理点击挂号按钮无反应JS 文件加载失败jQuery 未定义打开开发者工具看 Network 里 JS 状态码请求返回 404Context path 没带前缀检查所有ctx 拼接是否遗漏JSON 返回中文乱码生产 JSON 时未指定 UTF-8produces application/json;charsetUTF-8提交两次挂号单双击按钮触发两次请求提交后禁用按钮成功再移除数据库中文成问号连接串无characterEncodingutf8检查 jdbc url 参数这些坑在我看过的 SSM 项目里出现频率最高。前端问题优先去看浏览器的 Network 和 Console后端问题优先看 Tomcat 的 catalina.out。联调阶段的思路应该是先用纯 JSON 接口验证后端再加页面交互减少两边同时出错的可能性。5. 答辩自测清单与数据库初始化技巧5.1 一条完整业务路径跑到底拿到源码后不要只登录看主页否则答辩时一被追问“缴费之后数据怎么变”就卡住。按下面顺序测一遍注册一个新用户确认t_user新增记录且密码加密。维护一条患者信息用该患者挂号。选择医生后注意remain_count减 1。进入就诊更新诊断信息。开处方到缴费页看到金额汇总。缴费完成后检查挂号状态从FINISH变为PAID。每一步都在数据库里执行对应查询例如SELECT status, register_time FROM t_register ORDER BY id DESC; SELECT doctor_name, remain_count FROM t_doctor;5.2 数据库初始化脚本的细节多数课程设计项目会附带.sql脚本。如果脚本导入失败常见原因是字符集和外键顺序。推荐在脚本开头加上SET FOREIGN_KEY_CHECKS 0; DROP TABLE IF EXISTS t_payment; DROP TABLE IF EXISTS t_prescription; DROP TABLE IF EXISTS t_register; -- 其他表依次删除 SET FOREIGN_KEY_CHECKS 1;建表时统一使用utf8mb4比utf8更兼容手机号里的特殊字符。如果使用 MySQL 5.7创建表时没有指定时间默认值插入数据会因为register_time不允许为空而失败。顺手加上register_time DATETIME DEFAULT CURRENT_TIMESTAMP5.3 答辩前重点验证的三个边界并发挂号开两个浏览器窗口同时提交挂号看remain_count是否会变成负数。如果变负说明 mapper 没有加AND remain_count 0。重复缴费缴费成功后再次点击缴费按钮看是否产生两条流水。正确实现应该在 Service 层判断status不是PAID才允许支付。中文查询在患者姓名输入“张”能查到“张三”说明LIKE CONCAT写法正确也侧面验证了数据库连接串的编码参数。最后一个验证技巧把 Tomcat 的访问日志打开server.xml里配置pattern%h %m %U %s刷新页面后能看到每条请求的真实 URL 与状态码能快速定位是前端路径问题还是后端逻辑问题。打开日志后重点观察一下/register/add和/payment/pay这两个接口的返回时间就足够判断系统整体是否健康了。本文还有配套的精品资源点击获取
SSM智慧门诊系统开发实战：从环境搭建到答辩自查全流程拆解
简介一份基于Java语言并结合SSM框架的智慧医院门诊管理系统项目源码专门面向需要完成毕业设计、课程设计以及正在学习Java Web开发的学生和开发者旨在解决从数据库设计到前端页面展示的完整业务闭环问题。资源压缩包共包含1987个文件整体大小约7.86MB文件构成以SVG矢量图标、Java源码、SCSS样式、JavaScript脚本、CSS样式表和HTML页面为主同时包含MySQL数据库脚本、Maven构建脚本与项目配置文件覆盖了前端资源、后端逻辑和部署运行所需的全部要素。项目基于SSM框架整合MySQL数据库前端采用Bootstrap与JSP技术实现页面展示核心功能包括注册登录、挂号、就诊、缴费、药品管理、信息管理等模块代码结构分层清晰业务逻辑完整方便在此基础上快速理解并进行二次扩展。目前已有1267人浏览学习对于需要一套可运行源码作为毕业设计参考、课程设计练习的读者来说是一份可以直接导入开发工具使用的项目资料。1. SSM智慧门诊项目拆解为什么这一份源码值得跑通全流程毕业设计拿到“基于SSM的医院门诊管理系统”时很多人第一反应是去改界面、换Logo结果改了三天挂号模块还是 404。真正值得先做的事是把 SpringMVC 的请求链路、MyBatis 的 SQL 映射、Bootstrap 页面的 AJAX 回调这三条线串起来。SSM 组合在今天依然被大量中小型系统使用门诊挂号缴费的业务量级刚好覆盖了增删改查、状态流转、一对多关联这些高频考点。这个项目适合课程设计或毕业设计的原因也在这里结构规整、模块边界清楚、跑起来后能马上看出“挂号、就诊、缴费、药品、信息”五个主功能的完整闭环。对熟悉 Java 但没写过完整 Web 项目的人来说它是性价比很高的练手样本。2. SSM门诊系统环境搭建与Maven Wrapper启动细节2.1 先确认这几类文件再决定下一步压缩包里既有mvnw.cmd又有sb-admin-2.css、bootstrap.css、all.css这类前端静态资源文件说明这个项目不是为了“只能在 IDEA 里打开”而做的作者同时在为命令行构建和静态资源路径留了手。拿到源码后不要直接点mvnw.cmd先静态检查项目结构find . -name *.java | head -20 find src/main/resources -name *.xml find src/main/webapp -name *.xml | grep WEB-INF第一行看 Java 包名和 Controller 数量第二行看 Spring 配置是否存在第三行看web.xml是否在WEB-INF下。我见过不少毕业设计运行失败不是因为业务代码写错而是spring-mvc.xml的扫描包路径写成了com.controller实际类却放在com.hospital.controller启动时 Bean 全部没扫描到页面直接 404。这里有一个简单判断方法看web.xml中contextConfigLocation和DispatcherServlet的init-param路径是不是真实存在于 resources 目录。如果项目提供的是.zip解压后先重新导入 IDEA再执行一次mvn clean目的是清除本地可能的旧编译产物避免.class残留造成“改代码不生效”。同时检查一下是否附带.sql脚本门诊系统没有测试数据登录取值都会是空列表不便于后续验证。2.2 Maven Wrapper 与 pom.xml 依赖等级mvnw.cmd是 Windows 下的 Maven Wrapper 脚本它的意义在于固定了构建用的 Maven 版本不需要本机安装 3.8 还是 3.9项目会根据 wrapper 配置下载对应版本。在项目根目录执行mvnw.cmd clean package -DskipTests如果你在 Linux 或 Mac 上操作对应命令是./mvnw clean package -DskipTests-DskipTests的作用是跳过单元测试减少打包耗时。打包成功后会看到target/xxx.war这个 war 可以直接丢进 Tomcat 的webapps目录也可以交给 IDEA 的 Tomcat 运行配置使用。SSM 项目的启动依赖集中在 pom.xml 里一个典型的依赖集合如下dependencies dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.2.25.RELEASE/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version2.0.7/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.49/version scoperuntime/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies这里不要用太新的 Spring 6.x因为 Spring 6 基于 Jakarta EE和 Tomcat 8.5/9.0 的javax.servlet包不兼容。课程设计场景下Spring 5.2.x MyBatis 3.5.x MySQL 5.7 是兼容面最广的组合。mysql-connector-java版本对齐 5.1.49如果换成 8.0 还要额外处理时区参数对初学项目来说没必要。下面这张表是 SSM 工程里不能缺的配置位置文件相对路径在项目里的职责src/main/resources/spring-dao.xml装配数据源、SqlSessionFactory、MapperScannerConfigurersrc/main/resources/spring-mvc.xml开启注解驱动、扫描 Controller、配置视图解析器src/main/webapp/WEB-INF/web.xml加载 Spring 容器、注册 DispatcherServlet、配置字符过滤器src/main/resources/jdbc.properties保存数据库连接地址、账号、密码部分项目会把spring-dao.xml与spring-service.xml分开分得越细越方便在答辩时讲清楚“Spring 容器到底管理了什么”。这属于 SSM 整合的常见做法不是必须照搬。2.3 Tomcat 部署参数这样设常见做法是在 IDEA 里建一个 Tomcat 运行配置。以 Tomcat 8.5 为例打开 Run/Debug Configurations新增 Tomcat ServerLocal然后到 Deployment 页签添加xxx:war exploded。这里的参数值得注意Application context: /Application context如果填成/hospital那么所有c:url和request.getContextPath()获得的地址会自动带前缀而静态资源路径写死成/static/...的页面就会全部 404。所以要么统一用绝对路径ctx /static要么直接把 context 设成/。项目里出现sb-admin-2.css这种后台模板说明前端大量引入第三方静态资源路径问题尤其要注意。启动前还要确认jdbc.properties里的数据库名、用户名、密码和本机一致。常见错误是只改了库名没改端口或者密码含特殊字符时没有做转义。数据库连接串可以写成jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8useSSLfalse jdbc.usernameroot jdbc.password123456useUnicodetruecharacterEncodingutf8是中文项目最容易漏的两项漏掉后 JSP 页面显示正常但写入数据库后中文变成“???”。useSSLfalse是为了规避 MySQL 5.7 与 Connector/J 的 SSL 握手警告。如果使用 Druid 连接池还会在spring-dao.xml里看到maxActive、initialSize这些参数平时调试可以调小一点避免连接占满。2.4 启动失败先看日志头三行SSM 项目启动报错先不要翻到异常栈最下面直接看第一行 Caused by。整理几个高频情况ClassNotFoundException: org.springframework.web.servlet.DispatcherServlet说明 Tomcat 部署的工件没有把 Maven 依赖带进去在 Artifacts 里把lib目录加入WEB-INF/lib。Could not resolve placeholder jdbc.url说明spring-dao.xml里context:property-placeholder locationclasspath:jdbc.properties/的路径和实际文件名不一致。Invalid bound statement (not found): com.xxx.RegisterMapper.insert说明 Mapper 接口已经扫描但 XML 文件不在mybatis.mapper-locations指定的路径下。这三种错误占了这个项目启动问题的绝大多数按上面顺序检查即可。3. 挂号、就诊、缴费链路中的SSM三层实现拆解3.1 门诊业务表如何拆门诊管理系统的核心不是医生表而是“挂号单”的状态。只要把t_register表的状态字段设计清楚后面的就诊、缴费、退号都只是状态迁移。一个比较合理的表结构如下表名关键字段作用t_userusername,password,role注册登录与角色区分t_patientpatient_name,id_card,phone患者基础信息挂号时关联t_doctordoctor_name,department_id,remain_count医生信息与号源余量t_registerregister_no,patient_id,doctor_id,status挂号主表状态贯穿全流程t_prescriptionregister_id,medicine_id,total_price处方明细缴费时汇总status字段建议用字符串枚举WAIT表示待就诊TREATING表示就诊中FINISH表示已诊完PAID表示缴费完成CANCEL表示退号。用字符串枚举比用 0/1/2/3 好在答辩时直观页面上也能少一层转换逻辑。挂号时插入一条WAIT状态的记录就诊时更新为TREATING开完处方再更新为FINISH缴费成功后置为PAID。3.2 Controller 层挂号入口怎么写挂号模块的前端表单通常只提交两个参数patientId和doctorId。后端 Controller 要做的是把参数收下来交给 Service再返回 JSON 给页面。下面的代码是一个典型的 SpringMVC 接口Controller public class RegisterController { Autowired private RegisterService registerService; RequestMapping(/register/add) ResponseBody public MapString, Object addRegister(RequestParam Integer patientId, RequestParam Integer doctorId) { int registerId registerService.createRegister(patientId, doctorId); MapString, Object result new HashMap(); result.put(success, registerId 0); result.put(registerId, registerId); return result; } }ResponseBody会把返回的 Map 序列化成 JSON前端直接用data.success判断是否成功。RequestParam从 query string 或表单体取参数默认是必填参数。如果前端传参名叫patient_id这里就得写RequestParam(patient_id)否则会直接 400。这里只负责参数接收和响应封装真正的业务判断必须到 Service 层。3.3 Service 层事务号源扣减与挂号记录必须原子操作挂号最容易被答辩老师追问的问题是多个患者同时挂同一个医生怎么办如果先查余号、再插入挂号、最后扣减余号三步操作必须放在同一个事务里。常见实现是Service public class RegisterServiceImpl implements RegisterService { Autowired private RegisterMapper registerMapper; Autowired private DoctorMapper doctorMapper; Override Transactional(rollbackFor Exception.class) public int createRegister(Integer patientId, Integer doctorId) { Doctor doctor doctorMapper.selectById(doctorId); if (doctor.getRemainCount() 0) { throw new BizException(当前医生号源已约满); } Register record new Register(); record.setPatientId(patientId); record.setDoctorId(doctorId); record.setStatus(WAIT); record.setRegisterTime(new Date()); registerMapper.insert(record); doctorMapper.decreaseRemainCount(doctorId); return record.getId(); } }Transactional(rollbackFor Exception.class)是为了让 RuntimeException 和普通 Exception 都触发回滚。默认情况下Spring 只对 RuntimeException 回滚如果这里抛出的是受检异常不加rollbackFor就会出现“挂号单插进去了余号却没有扣减”的脏状态。BizException是自定义业务异常抛出后由全局异常处理器转成 JSON 返回给前端。3.4 MyBatis 映射insert 要拿到自增主键挂号记录由数据库自增主键生成MyBatis 里必须配置useGeneratedKeys否则record.getId()永远返回 null。推荐映射写法insert idinsert parameterTypeRegister useGeneratedKeystrue keyPropertyid INSERT INTO t_register(patient_id, doctor_id, status, register_time) VALUES(#{patientId}, #{doctorId}, #{status}, #{registerTime}) /insert update iddecreaseRemainCount parameterTypeint UPDATE t_doctor SET remain_count remain_count - 1 WHERE id #{id} AND remain_count 0 /updateuseGeneratedKeys要对应数据库自增列keyProperty对应实体类的主键属性。第二个 SQL 里AND remain_count 0是非常实用的并发兜底即使在 Service 层判断过余号数据库层面也保证不会把余号扣成负数。影响行数为 0 时事务会因抛出的自定义异常而回滚。3.5 缴费模块处方明细与状态更新的顺序缴费模块不建议直接用UPDATE t_register SET statusPAID一条语句完成因为页面要展示缴费明细数据来源是t_prescription表。更合理的顺序是先按registerId汇总处方金额插入缴费流水再更新挂号状态。用 SQL 模拟就是SELECT SUM(total_price) FROM t_prescription WHERE register_id 1; INSERT INTO t_payment(register_id, total_amount, pay_time) VALUES(1, 68.5, NOW()); UPDATE t_register SET status PAID WHERE id 1;这里的t_payment表可以看作是流水记录答辩时可以讲它的作用是为了财务对账而不只是改一个状态字段。前端缴费按钮点击后AJAX 请求/payment/pay后端在一个事务里完成以上三步。4. MyBatis映射与BootstrapAJAX的页面联调4.1 JSP静态资源路径统一用上下文前缀项目静态资源包含sb-admin-2.css、bootstrap.css、fontawesome.css等。它们通常会放在webapp/static/css和webapp/static/js目录下。JSP 页面如果直接写link relstylesheet href/static/css/bootstrap.css一旦部署时Application context不是/这个绝对路径就指向了服务器根目录而不是项目上下文。我一般会在 JSP 顶部声明一个全局变量% String ctx request.getContextPath(); request.setAttribute(ctx, ctx); % link relstylesheet href${ctx}/static/css/bootstrap.css script src${ctx}/static/js/jquery.min.js/script script src${ctx}/static/js/bootstrap.js/script这样无论部署在/还是/hospital资源都能正常加载。使用sb-admin-2.css这类后台模板时还需要注意它依赖 jQuery 和 Bootstrap 的加载顺序jQuery 必须在前Bootstrap JS 在后否则下拉菜单和弹窗组件无法初始化。4.2 用AJAX局部刷新替代整页跳转门诊选择科室后医生列表应该跟着变化。常见做法是页面先加载科室下拉框用户选择后再请求医生列表。后端接口可以设计为RequestMapping(value /doctor/listByDepartment, produces application/json;charsetUTF-8) ResponseBody public ListDoctor listByDepartment(RequestParam Integer deptId) { return doctorService.listByDepartment(deptId); }前端 JS 通过 jQuery 发起请求$.ajax({ url: ctx /doctor/listByDepartment, data: { deptId: deptId }, dataType: json, success: function (list) { var html ; for (var i 0; i list.length; i) { html option value list[i].id list[i].doctorName 剩余: list[i].remainCount /option; } $(#doctorSelect).html(html); }, error: function () { alert(医生列表加载失败); } });url里的ctx是上面定义的上下文变量。deptId是从科室下拉框取到的值。这样处理比整页刷新更符合“智慧门诊”的交互体验也更容易在答辩中展示知识点AJAX 请求、JSON 响应、DOM 动态更新。要注意的是如果后端实体类字段是doctorNameJackson 默认会把属性名序列化成doctorName所以两端对齐时按驼峰规则写。4.3 组合查询用 动态拼接信息管理模块通常有关键字查询、科室筛选、状态筛选。如果给每一个查询条件写一个 SQL 方法不仅冗长后期加条件还得改接口。MyBatis 的whereif能在一个方法里完成动态 SQLselect idselectRegisterPage parameterTypemap resultTypeRegisterVO SELECT r.id, r.register_no, p.patient_name, d.doctor_name, r.status, r.register_time FROM t_register r LEFT JOIN t_patient p ON r.patient_id p.id LEFT JOIN t_doctor d ON r.doctor_id d.id where if testpatientName ! null and patientName ! AND p.patient_name LIKE CONCAT(%, #{patientName}, %) /if if testdoctorId ! null AND r.doctor_id #{doctorId} /if if teststatus ! null and status ! AND r.status #{status} /if /where ORDER BY r.register_time DESC /selectwhere标签会自动去掉第一个条件前面的AND这是比手动写WHERE 11更规范的做法。LIKE CONCAT(%, #{patientName}, %)使用参数占位符而不是字符串拼接可以避免 SQL 注入。RegisterVO是一个视图对象用于关联查询展示它不是简单对应一张表而是拼接了患者和医生的冗余字段。4.4 联调时最容易踩的五个问题现象原因处理点击挂号按钮无反应JS 文件加载失败jQuery 未定义打开开发者工具看 Network 里 JS 状态码请求返回 404Context path 没带前缀检查所有ctx 拼接是否遗漏JSON 返回中文乱码生产 JSON 时未指定 UTF-8produces application/json;charsetUTF-8提交两次挂号单双击按钮触发两次请求提交后禁用按钮成功再移除数据库中文成问号连接串无characterEncodingutf8检查 jdbc url 参数这些坑在我看过的 SSM 项目里出现频率最高。前端问题优先去看浏览器的 Network 和 Console后端问题优先看 Tomcat 的 catalina.out。联调阶段的思路应该是先用纯 JSON 接口验证后端再加页面交互减少两边同时出错的可能性。5. 答辩自测清单与数据库初始化技巧5.1 一条完整业务路径跑到底拿到源码后不要只登录看主页否则答辩时一被追问“缴费之后数据怎么变”就卡住。按下面顺序测一遍注册一个新用户确认t_user新增记录且密码加密。维护一条患者信息用该患者挂号。选择医生后注意remain_count减 1。进入就诊更新诊断信息。开处方到缴费页看到金额汇总。缴费完成后检查挂号状态从FINISH变为PAID。每一步都在数据库里执行对应查询例如SELECT status, register_time FROM t_register ORDER BY id DESC; SELECT doctor_name, remain_count FROM t_doctor;5.2 数据库初始化脚本的细节多数课程设计项目会附带.sql脚本。如果脚本导入失败常见原因是字符集和外键顺序。推荐在脚本开头加上SET FOREIGN_KEY_CHECKS 0; DROP TABLE IF EXISTS t_payment; DROP TABLE IF EXISTS t_prescription; DROP TABLE IF EXISTS t_register; -- 其他表依次删除 SET FOREIGN_KEY_CHECKS 1;建表时统一使用utf8mb4比utf8更兼容手机号里的特殊字符。如果使用 MySQL 5.7创建表时没有指定时间默认值插入数据会因为register_time不允许为空而失败。顺手加上register_time DATETIME DEFAULT CURRENT_TIMESTAMP5.3 答辩前重点验证的三个边界并发挂号开两个浏览器窗口同时提交挂号看remain_count是否会变成负数。如果变负说明 mapper 没有加AND remain_count 0。重复缴费缴费成功后再次点击缴费按钮看是否产生两条流水。正确实现应该在 Service 层判断status不是PAID才允许支付。中文查询在患者姓名输入“张”能查到“张三”说明LIKE CONCAT写法正确也侧面验证了数据库连接串的编码参数。最后一个验证技巧把 Tomcat 的访问日志打开server.xml里配置pattern%h %m %U %s刷新页面后能看到每条请求的真实 URL 与状态码能快速定位是前端路径问题还是后端逻辑问题。打开日志后重点观察一下/register/add和/payment/pay这两个接口的返回时间就足够判断系统整体是否健康了。本文还有配套的精品资源点击获取
