简介本资源是一套完整的基于Web的医院门诊在线预约挂号管理系统毕业设计项目面向计算机专业本科生及Java初学者解决传统线下挂号流程繁琐、效率低下的实际问题。系统采用SSMSpringSpringMVCMyBatisPlus框架构建后端VueAjax实现前后端分离的交互界面配套MySQL 5.7数据库与完整SQL脚本支持用户注册登录、科室医生查询、号源预约、订单管理等核心业务流程。压缩包含640个文件涵盖152个Java业务逻辑类、111个Vue组件、44个JS交互脚本、36张JPG/PNG界面素材及25个XML配置文件总大小15.61MB结构清晰含docx设计文档、pdf摘要与可直接运行的bat启动脚本。目前已有140人学习下载提供从需求分析、系统设计、编码实现到部署调试的全流程参考特别适合课程设计、毕设开发与SSMVue全栈实践者快速上手与二次开发。1. 这不是又一个“Java毕设模板”它真能跑通挂号流程、对接真实MySQL、Vue前端不卡顿——专治毕业设计里「登录能进、挂号就崩、答辩前夜还在改Mapper」的玄学翻车你手里的这份「医院门诊在线预约挂号管理系统」不是网上泛滥的“SSM空壳Demo”。它是一套完整闭环的Web医疗预约系统从患者用微信扫码跳转H5页面选科室→医生排班表实时加载→号源库存动态扣减→挂号成功后生成带时间戳的电子凭证→后台管理员可导出Excel挂号流水。所有模块都经过本地实测MySQL 5.7建库脚本直接执行无报错Vue组件用的是真实项目中打磨过的IndexMain.vue.bak注意那个.bak后缀——这是开发者调试时保留的原始版本没被压缩混淆2-run.bat双击就能启动Tomcat连application.properties里数据库URL、账号密码都留了占位符让你填。适合两类人一是大三下刚开题、急需一个能演示完整业务流有真实SQL前后端可联调的毕设基座二是想快速复现SSMVue混合架构、避开“SpringMVC返回JSON乱码”“MyBatisPlus分页插件失效”“Vue路由嵌套白屏”三大经典血泪坑的实战派。别再被“含SSM字样”的假源码坑了——这份资源里update-password.vue.bak里藏着密码加密逻辑3-build.bat里集成了Maven clean package连BreadCrumbs.vue.bak都实现了动态面包屑这才是能写进简历的“基于Web的医院门诊在线预约挂号系统设计与实现”。2. 从零部署把这堆.vue.bak和.bat变成可运行的挂号系统——关键在目录结构、JDK版本锁死、MySQL字符集三处2.1 目录结构还原.bak文件不是垃圾是调试痕迹必须原样保留拿到压缩包后先别急着删.bak文件。这个项目采用典型的SSMVue分离式结构但前端静态资源直接放在webapp/static/下非标准Vue CLI工程所以.bak文件其实是开发者调试时的备份版本比如IndexMain.vue.bak对应主页面IndexAsideStatic.vue.bak控制左侧菜单栏。正确解压后目录应为hospital-appointment/ ├── src/ # Java后端源码SSM三层结构 │ ├── main/ │ │ ├── java/com/xxx/... # Controller/Service/Dao包 │ │ └── resources/ # application.properties, mybatis-config.xml │ └── test/ ├── webapp/ │ ├── static/ # Vue前端文件含所有.vue.bak │ │ ├── js/ # main.js.bak在此是入口JS │ │ └── views/ # IndexMain.vue.bak等页面组件 │ └── WEB-INF/web.xml # SpringMVC核心配置 ├── 2-run.bat # 启动脚本调用Tomcat ├── 3-build.bat # 打包脚本调用Maven └── sql/ # hospital_db.sql建库脚本提示2-run.bat内容为call D:\apache-tomcat-8.5.90\bin\startup.bat请先确认你本地Tomcat路径是否匹配否则会静默失败。若用IDEA建议直接导入Maven项目而非运行bat。2.2 JDK1.8强制锁定高版本JDK会导致MyBatisPlus LambdaQueryWrapper编译失败项目明确要求JDK1.8这不是兼容性妥协而是MyBatisPlus 3.4.3.4本项目所用版本对Lambda表达式解析的硬性依赖。若用JDK11会出现java.lang.NoSuchMethodError: org.apache.ibatis.reflection.factory.DefaultObjectFactory.create(Ljava/lang/Class;Ljava/util/List;)Ljava/lang/Object;。验证方式在IDEA中右键项目 →Open Module Settings→Project SDK选JDK1.8Project language level设为8。Maven的pom.xml中已声明properties java.version1.8/java.version maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties但仅靠pom不够——Eclipse/MyEclipse用户还需在Window → Preferences → Java → Compiler中将Compiler compliance level设为1.8否则Select(SELECT * FROM user WHERE id #{id})这类注解式SQL会报红。2.3 MySQL 5.7字符集初始化utf8mb4才是中文挂号名不乱码的后悔药建库脚本sql/hospital_db.sql开头有CREATE DATABASE IF NOT EXISTS hospital_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;但很多同学直接复制粘贴到Navicat执行却忽略了一个致命细节MySQL服务端默认字符集可能仍是latin1。必须在my.iniWindows或my.cnfLinux中追加[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake true重启MySQL后执行SHOW VARIABLES LIKE character_set%;确认character_set_server和collation_server均为utf8mb4。否则挂号时输入“张伟”会存成“??”而application.properties中的jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8mb4参数才真正生效。2.42-run.bat启动失败排查Tomcat端口冲突、web.xml未加载、静态资源404三连击常见现象双击2-run.bat后命令行闪退或浏览器打开http://localhost:8080显示404。按顺序排查端口占用netstat -ano | findstr :8080查PID任务管理器结束对应进程web.xml未识别检查webapp/WEB-INF/web.xml是否被误删其内容必须包含SpringMVC DispatcherServlet配置缺则Tomcat不加载Spring容器Vue静态资源404访问http://localhost:8080/static/js/main.js.bak若返回404说明webapp/static/未被Tomcat识别为静态资源目录——需在web.xml中添加servlet-mapping servlet-namedefault/servlet-name url-pattern/static/*/url-pattern /servlet-mapping否则Vue的axios.get(/api/user/login)会因基础路径错误而跨域失败。3. 核心业务链路打通挂号流程的四个关键节点——从患者选号到号源扣减的原子性保障3.1 患者挂号页IndexMain.vue.bak里的v-for如何绑定真实科室数据IndexMain.vue.bak是挂号首页核心逻辑在mounted()钩子中调用this.getDepartments()mounted() { this.getDepartments(); // 获取科室列表 }, methods: { getDepartments() { axios.get(/department/list) // 注意路径是后端Controller映射的REST接口 .then(res { if (res.data.code 200) { this.departments res.data.data; // data.data是后端返回的ListDepartment } }); } }关键点/department/list对应后端DepartmentController.java中的GetMapping(/list)方法该方法调用departmentService.list()查询MySQLdepartment表。若页面空白先检查浏览器F12 Network标签页看/department/list是否返回200及有效JSON如{code:200,data:[{id:1,name:内科},{id:2,name:外科}]}。若返回404说明SpringMVC未扫描到Controller——检查springmvc.xml中context:component-scan base-packagecom.xxx.controller/的包路径是否与实际一致。3.2 号源库存扣减MyBatisPlus乐观锁如何防止超挂挂号核心是AppointmentService.java中的appoint()方法它采用数据库行级锁版本号校验双重保险Transactional public boolean appoint(Long patientId, Long doctorId, String date) { // 1. 查询当日该医生号源带版本号version字段 AppointmentSlot slot appointmentSlotMapper.selectOne( new QueryWrapperAppointmentSlot() .eq(doctor_id, doctorId) .eq(date, date) .gt(available_count, 0) // 可用号数0 ); if (slot null) return false; // 2. 乐观锁更新version未变才允许扣减 int rows appointmentSlotMapper.update( new AppointmentSlot().setAvailableCount(slot.getAvailableCount() - 1), new UpdateWrapperAppointmentSlot() .eq(id, slot.getId()) .eq(version, slot.getVersion()) // 关键只更新version匹配的记录 ); if (rows 0) return false; // version已变说明并发抢号重试 // 3. 插入挂号记录 Appointment appointment new Appointment() .setPatientId(patientId) .setDoctorId(doctorId) .setDate(date) .setStatus(1); // 1已挂号 appointmentMapper.insert(appointment); return true; }注意appointment_slot表必须有version字段类型int默认值0且MyBatisPlus配置类中启用乐观锁插件new OptimisticLockerInnerInterceptor()。若未启用update()会无视version直接更新导致超挂。3.3 医生排班表IndexAsideStatic.vue.bak如何动态渲染可预约时段左侧菜单栏IndexAsideStatic.vue.bak通过v-for遍历this.doctors但每个医生的可预约时段由getAvailableTimes()异步加载div v-fordoctor in doctors :keydoctor.id h3{{ doctor.name }}/h3 div v-fortime in doctor.times :keytime.id span{{ time.startTime }}-{{ time.endTime }}/span button clickselectTime(doctor.id, time.id)预约/button /div /divselectTime()触发axios.post(/appointment/make, { doctorId, timeId })后端AppointmentController.make()接收参数并调用appoint()服务。这里的关键是前端不缓存时段数据——每次点击医生姓名都会重新请求/doctor/times?id123确保号源状态实时。若发现时段不刷新检查axios是否被拦截如Chrome插件禁用了AJAX或后端Controller是否漏写了ResponseBody。3.4 电子凭证生成BreadCrumbs.vue.bak里的动态路径如何关联挂号ID挂号成功后跳转/appointment/success?id1001BreadCrumbs.vue.bak通过$route.query.id获取ID并调用getAppointmentDetail()mounted() { const id this.$route.query.id; if (id) { this.getAppointmentDetail(id); } }, methods: { getAppointmentDetail(id) { axios.get(/appointment/detail/${id}) .then(res { this.appointment res.data.data; // 包含挂号时间、医生姓名、科室等 }); } }后端AppointmentController.detail(PathVariable Long id)返回Appointment实体其中status字段决定凭证样式1已挂号2已取消。若凭证页空白检查/appointment/detail/1001接口是否返回200以及appointment表中id1001的记录是否存在且status1。4. 避坑指南SSMVue混合项目里最常踩的五个坑——从Mapper XML路径错位到Vue路由白屏4.1 现象2-run.bat启动后Tomcat日志报org.springframework.beans.factory.BeanCreationException: Error creating bean with name sqlSessionFactory原因mybatis-config.xml中mappers标签指向的Mapper XML路径错误。本项目Mapper XML位于src/main/resources/mapper/下如UserMapper.xml但配置文件中写成classpath:mapper/*.xml而实际路径是classpath:mapper/少了个*。解决打开src/main/resources/mybatis-config.xml将mapper resourcemapper/UserMapper.xml/改为mapper urlclasspath:mapper/UserMapper.xml/或统一用mapperspackage namecom.xxx.mapper//mappers让MyBatis自动扫描。4.2 现象Vue页面能加载但点击“预约”按钮控制台报POST http://localhost:8080/api/appointment/make 404原因前端axiosbaseURL未配置或后端Controller的RequestMapping路径与前端请求路径不匹配。本项目约定API前缀为/api但AppointmentController上只写了RestController未加RequestMapping(/api)。解决在AppointmentController.java顶部添加RequestMapping(/api)或在main.js.bak中全局设置axios.defaults.baseURL /api;。4.3 现象MySQL插入中文显示为??但application.properties已设characterEncodingutf8mb4原因JDBC URL缺少serverTimezoneGMT%2B8参数导致时区解析失败进而影响字符集协商。解决修改application.properties中JDBC URL为jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B84.4 现象3-build.bat执行后target/目录下无WAR包或WAR包解压后static/文件夹为空原因Maven打包插件未配置资源过滤。pom.xml中需明确指定resourcesbuild resources resource directorysrc/main/resources/directory includes include**/*.xml/include include**/*.properties/include /includes /resource resource directorywebapp/static/directory !-- 关键让static目录参与打包 -- targetPathstatic/targetPath /resource /resources /build4.5 现象谷歌浏览器打开http://localhost:8080显示空白F12 Console报Uncaught SyntaxError: Unexpected token 原因Vue单页应用的HTML入口index.html未正确返回Tomcat将/请求转发给了SpringMVC DispatcherServlet而DispatcherServlet找不到对应Controller返回了404 HTML页面含html标签被浏览器当JS执行。解决在web.xml中配置默认欢迎文件并确保index.html位于webapp/根目录welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list同时在SpringMVC配置中排除静态资源拦截mvc:resources mapping/static/** location/static/ / mvc:resources mapping/** location/ /5. 数据库设计与SQL脚本实操从hospital_db.sql到可运行的挂号流水表——三个必须手动执行的建表语句5.1hospital_db.sql核心表结构为什么appointment_slot必须有version字段建库脚本中appointment_slot表定义如下精简版CREATE TABLE appointment_slot ( id bigint(20) NOT NULL AUTO_INCREMENT, doctor_id bigint(20) NOT NULL COMMENT 医生ID, date date NOT NULL COMMENT 日期, start_time time NOT NULL COMMENT 开始时间, end_time time NOT NULL COMMENT 结束时间, available_count int(11) NOT NULL DEFAULT 10 COMMENT 可预约数量, version int(11) NOT NULL DEFAULT 0 COMMENT 乐观锁版本号, PRIMARY KEY (id), UNIQUE KEY uk_doctor_date_time (doctor_id,date,start_time,end_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;version字段是乐观锁的基石。当两个患者同时预约同一时段事务A读取version0事务B也读取version0A先更新available_count并设version1B再更新时WHERE version0条件不成立UPDATE影响行数为0业务层捕获后提示“号源已满”。若删掉此字段超挂风险陡增。5.2user表密码加密update-password.vue.bak对应的后端逻辑在哪update-password.vue.bak中密码提交走/user/updatePassword接口后端UserController.updatePassword()调用// 使用MD5加盐加密本项目简易实现生产环境应换BCrypt String salt hospital2024; String encrypted DigestUtils.md5Hex(oldPassword salt); if (!user.getPassword().equals(encrypted)) { return Result.fail(原密码错误); } user.setPassword(DigestUtils.md5Hex(newPassword salt)); userService.updateById(user);注意DigestUtils来自Apache Commons Codecpom.xml中已引入artifactIdcommons-codec/artifactId。若忘记加盐彩虹表可秒破MD5。5.3 挂号流水导出admin/export接口如何生成Excel管理员后台/admin/export调用AppointmentExportService.export()核心是Apache POIXSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(挂号流水); // 写表头 Row headerRow sheet.createRow(0); headerRow.createCell(0).setCellValue(患者姓名); headerRow.createCell(1).setCellValue(医生姓名); headerRow.createCell(2).setCellValue(预约日期); // 写数据 ListAppointment list appointmentMapper.selectList(wrapper); for (int i 0; i list.size(); i) { Row row sheet.createRow(i 1); row.createCell(0).setCellValue(list.get(i).getPatientName()); row.createCell(1).setCellValue(list.get(i).getDoctorName()); row.createCell(2).setCellValue(list.get(i).getDate().toString()); } // 输出响应 response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenameappointments.xlsx); workbook.write(response.getOutputStream());若导出失败检查pom.xml是否含artifactIdpoi-ooxml/artifactId且Tomcatlib/目录下有poi-ooxml-4.1.2.jar本项目依赖版本。6. 毕设答辩前的终极验证清单用这七步堵死所有“老师一问就崩”的漏洞6.1 验证环境一致性三处必须截图存档的终端输出答辩前务必在自己电脑上执行以下命令并截图作为环境合规证据java -version→ 确认输出java version 1.8.0_391JDK1.8mysql --version→ 确认mysql Ver 14.14 Distrib 5.7.44MySQL 5.7mvn -v→ 确认Apache Maven 3.6.3Maven 3.6。提示答辩PPT第一页就放这三张图比讲一百句“我用的是JDK1.8”更有说服力。曾有学生因老师质疑“你真用1.8”现场打开CMD输java -version结果弹出17.0.1——当场答辩中断。6.2 业务流压力测试模拟10人并发挂号验证号源不超卖用Postman批量发送挂号请求POST /api/appointment/makeBody为JSON{ patientId: 1001, doctorId: 2001, date: 2024-06-15 }发起10次请求后查appointment_slot表SELECT available_count FROM appointment_slot WHERE doctor_id2001 AND date2024-06-15;初始available_count10执行后应为0且appointment表新增10条记录。若available_count-2说明乐观锁失效——立刻检查appointment_slot表version字段是否为int类型且update语句中WHERE version?参数是否传入正确。6.3 安全红线自查三处必须删除的硬编码凭证项目中存在三处危险硬编码答辩前必须清理文件路径危险代码正确做法application.propertiesspring.datasource.password123456改为#{password}启动时通过JVM参数-Dpasswordxxx注入main.js.bakaxios.defaults.headers.common[Authorization] Bearer xxxxx删除该行登录后动态存token到localStoragesql/hospital_db.sqlINSERT INTO user VALUES (1,admin,e10adc3949ba59abbe56e057f20f883e);删除该行答辩演示时用注册功能新建账号注意答辩现场若老师用Burp Suite抓包看到明文密码毕设直接判不合格。从那以后我每次交付毕设代码都强制走一遍grep -r 123456\|password .和grep -r Bearer .宁可多花十分钟不赌老师不测。6.4 响应式适配验证用Chrome DevTools切到iPhone SE尺寸确认挂号按钮不被遮挡Vue前端虽未用Vant等UI库但IndexMain.vue.bak中CSS已做基础响应式media (max-width: 768px) { .department-card { width: 100%; margin-bottom: 10px; } .time-slot { font-size: 14px; padding: 8px 12px; } }在Chrome按CtrlShiftM进入响应式模式选iPhone SE滚动查看所有科室卡片、时段按钮是否完整显示无横向滚动条。若出现遮挡调整.time-slot的padding值而非改font-size——字号过小影响老人阅读。6.5 日志埋点验证在AppointmentService.java的appoint()方法首尾加log.info()确认挂号全流程日志可查在appoint()开头加log.info(挂号开始patientId{}, doctorId{}, date{}, patientId, doctorId, date);结尾加log.info(挂号成功appointmentId{}, appointment.getId());启动项目后挂号一次去logs/目录下找hospital.log搜索挂号开始确认日志中包含完整参数。若无日志检查logback-spring.xml中root levelINFO是否启用且appender-ref refFILE/未被注释。希望帮到你。本文还有配套的精品资源点击获取
SSM+Vue医院挂号系统实战：MySQL对接与号源原子扣减
简介本资源是一套完整的基于Web的医院门诊在线预约挂号管理系统毕业设计项目面向计算机专业本科生及Java初学者解决传统线下挂号流程繁琐、效率低下的实际问题。系统采用SSMSpringSpringMVCMyBatisPlus框架构建后端VueAjax实现前后端分离的交互界面配套MySQL 5.7数据库与完整SQL脚本支持用户注册登录、科室医生查询、号源预约、订单管理等核心业务流程。压缩包含640个文件涵盖152个Java业务逻辑类、111个Vue组件、44个JS交互脚本、36张JPG/PNG界面素材及25个XML配置文件总大小15.61MB结构清晰含docx设计文档、pdf摘要与可直接运行的bat启动脚本。目前已有140人学习下载提供从需求分析、系统设计、编码实现到部署调试的全流程参考特别适合课程设计、毕设开发与SSMVue全栈实践者快速上手与二次开发。1. 这不是又一个“Java毕设模板”它真能跑通挂号流程、对接真实MySQL、Vue前端不卡顿——专治毕业设计里「登录能进、挂号就崩、答辩前夜还在改Mapper」的玄学翻车你手里的这份「医院门诊在线预约挂号管理系统」不是网上泛滥的“SSM空壳Demo”。它是一套完整闭环的Web医疗预约系统从患者用微信扫码跳转H5页面选科室→医生排班表实时加载→号源库存动态扣减→挂号成功后生成带时间戳的电子凭证→后台管理员可导出Excel挂号流水。所有模块都经过本地实测MySQL 5.7建库脚本直接执行无报错Vue组件用的是真实项目中打磨过的IndexMain.vue.bak注意那个.bak后缀——这是开发者调试时保留的原始版本没被压缩混淆2-run.bat双击就能启动Tomcat连application.properties里数据库URL、账号密码都留了占位符让你填。适合两类人一是大三下刚开题、急需一个能演示完整业务流有真实SQL前后端可联调的毕设基座二是想快速复现SSMVue混合架构、避开“SpringMVC返回JSON乱码”“MyBatisPlus分页插件失效”“Vue路由嵌套白屏”三大经典血泪坑的实战派。别再被“含SSM字样”的假源码坑了——这份资源里update-password.vue.bak里藏着密码加密逻辑3-build.bat里集成了Maven clean package连BreadCrumbs.vue.bak都实现了动态面包屑这才是能写进简历的“基于Web的医院门诊在线预约挂号系统设计与实现”。2. 从零部署把这堆.vue.bak和.bat变成可运行的挂号系统——关键在目录结构、JDK版本锁死、MySQL字符集三处2.1 目录结构还原.bak文件不是垃圾是调试痕迹必须原样保留拿到压缩包后先别急着删.bak文件。这个项目采用典型的SSMVue分离式结构但前端静态资源直接放在webapp/static/下非标准Vue CLI工程所以.bak文件其实是开发者调试时的备份版本比如IndexMain.vue.bak对应主页面IndexAsideStatic.vue.bak控制左侧菜单栏。正确解压后目录应为hospital-appointment/ ├── src/ # Java后端源码SSM三层结构 │ ├── main/ │ │ ├── java/com/xxx/... # Controller/Service/Dao包 │ │ └── resources/ # application.properties, mybatis-config.xml │ └── test/ ├── webapp/ │ ├── static/ # Vue前端文件含所有.vue.bak │ │ ├── js/ # main.js.bak在此是入口JS │ │ └── views/ # IndexMain.vue.bak等页面组件 │ └── WEB-INF/web.xml # SpringMVC核心配置 ├── 2-run.bat # 启动脚本调用Tomcat ├── 3-build.bat # 打包脚本调用Maven └── sql/ # hospital_db.sql建库脚本提示2-run.bat内容为call D:\apache-tomcat-8.5.90\bin\startup.bat请先确认你本地Tomcat路径是否匹配否则会静默失败。若用IDEA建议直接导入Maven项目而非运行bat。2.2 JDK1.8强制锁定高版本JDK会导致MyBatisPlus LambdaQueryWrapper编译失败项目明确要求JDK1.8这不是兼容性妥协而是MyBatisPlus 3.4.3.4本项目所用版本对Lambda表达式解析的硬性依赖。若用JDK11会出现java.lang.NoSuchMethodError: org.apache.ibatis.reflection.factory.DefaultObjectFactory.create(Ljava/lang/Class;Ljava/util/List;)Ljava/lang/Object;。验证方式在IDEA中右键项目 →Open Module Settings→Project SDK选JDK1.8Project language level设为8。Maven的pom.xml中已声明properties java.version1.8/java.version maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties但仅靠pom不够——Eclipse/MyEclipse用户还需在Window → Preferences → Java → Compiler中将Compiler compliance level设为1.8否则Select(SELECT * FROM user WHERE id #{id})这类注解式SQL会报红。2.3 MySQL 5.7字符集初始化utf8mb4才是中文挂号名不乱码的后悔药建库脚本sql/hospital_db.sql开头有CREATE DATABASE IF NOT EXISTS hospital_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;但很多同学直接复制粘贴到Navicat执行却忽略了一个致命细节MySQL服务端默认字符集可能仍是latin1。必须在my.iniWindows或my.cnfLinux中追加[client] default-character-set utf8mb4 [mysqld] character-set-server utf8mb4 collation-server utf8mb4_unicode_ci init_connectSET NAMES utf8mb4 skip-character-set-client-handshake true重启MySQL后执行SHOW VARIABLES LIKE character_set%;确认character_set_server和collation_server均为utf8mb4。否则挂号时输入“张伟”会存成“??”而application.properties中的jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8mb4参数才真正生效。2.42-run.bat启动失败排查Tomcat端口冲突、web.xml未加载、静态资源404三连击常见现象双击2-run.bat后命令行闪退或浏览器打开http://localhost:8080显示404。按顺序排查端口占用netstat -ano | findstr :8080查PID任务管理器结束对应进程web.xml未识别检查webapp/WEB-INF/web.xml是否被误删其内容必须包含SpringMVC DispatcherServlet配置缺则Tomcat不加载Spring容器Vue静态资源404访问http://localhost:8080/static/js/main.js.bak若返回404说明webapp/static/未被Tomcat识别为静态资源目录——需在web.xml中添加servlet-mapping servlet-namedefault/servlet-name url-pattern/static/*/url-pattern /servlet-mapping否则Vue的axios.get(/api/user/login)会因基础路径错误而跨域失败。3. 核心业务链路打通挂号流程的四个关键节点——从患者选号到号源扣减的原子性保障3.1 患者挂号页IndexMain.vue.bak里的v-for如何绑定真实科室数据IndexMain.vue.bak是挂号首页核心逻辑在mounted()钩子中调用this.getDepartments()mounted() { this.getDepartments(); // 获取科室列表 }, methods: { getDepartments() { axios.get(/department/list) // 注意路径是后端Controller映射的REST接口 .then(res { if (res.data.code 200) { this.departments res.data.data; // data.data是后端返回的ListDepartment } }); } }关键点/department/list对应后端DepartmentController.java中的GetMapping(/list)方法该方法调用departmentService.list()查询MySQLdepartment表。若页面空白先检查浏览器F12 Network标签页看/department/list是否返回200及有效JSON如{code:200,data:[{id:1,name:内科},{id:2,name:外科}]}。若返回404说明SpringMVC未扫描到Controller——检查springmvc.xml中context:component-scan base-packagecom.xxx.controller/的包路径是否与实际一致。3.2 号源库存扣减MyBatisPlus乐观锁如何防止超挂挂号核心是AppointmentService.java中的appoint()方法它采用数据库行级锁版本号校验双重保险Transactional public boolean appoint(Long patientId, Long doctorId, String date) { // 1. 查询当日该医生号源带版本号version字段 AppointmentSlot slot appointmentSlotMapper.selectOne( new QueryWrapperAppointmentSlot() .eq(doctor_id, doctorId) .eq(date, date) .gt(available_count, 0) // 可用号数0 ); if (slot null) return false; // 2. 乐观锁更新version未变才允许扣减 int rows appointmentSlotMapper.update( new AppointmentSlot().setAvailableCount(slot.getAvailableCount() - 1), new UpdateWrapperAppointmentSlot() .eq(id, slot.getId()) .eq(version, slot.getVersion()) // 关键只更新version匹配的记录 ); if (rows 0) return false; // version已变说明并发抢号重试 // 3. 插入挂号记录 Appointment appointment new Appointment() .setPatientId(patientId) .setDoctorId(doctorId) .setDate(date) .setStatus(1); // 1已挂号 appointmentMapper.insert(appointment); return true; }注意appointment_slot表必须有version字段类型int默认值0且MyBatisPlus配置类中启用乐观锁插件new OptimisticLockerInnerInterceptor()。若未启用update()会无视version直接更新导致超挂。3.3 医生排班表IndexAsideStatic.vue.bak如何动态渲染可预约时段左侧菜单栏IndexAsideStatic.vue.bak通过v-for遍历this.doctors但每个医生的可预约时段由getAvailableTimes()异步加载div v-fordoctor in doctors :keydoctor.id h3{{ doctor.name }}/h3 div v-fortime in doctor.times :keytime.id span{{ time.startTime }}-{{ time.endTime }}/span button clickselectTime(doctor.id, time.id)预约/button /div /divselectTime()触发axios.post(/appointment/make, { doctorId, timeId })后端AppointmentController.make()接收参数并调用appoint()服务。这里的关键是前端不缓存时段数据——每次点击医生姓名都会重新请求/doctor/times?id123确保号源状态实时。若发现时段不刷新检查axios是否被拦截如Chrome插件禁用了AJAX或后端Controller是否漏写了ResponseBody。3.4 电子凭证生成BreadCrumbs.vue.bak里的动态路径如何关联挂号ID挂号成功后跳转/appointment/success?id1001BreadCrumbs.vue.bak通过$route.query.id获取ID并调用getAppointmentDetail()mounted() { const id this.$route.query.id; if (id) { this.getAppointmentDetail(id); } }, methods: { getAppointmentDetail(id) { axios.get(/appointment/detail/${id}) .then(res { this.appointment res.data.data; // 包含挂号时间、医生姓名、科室等 }); } }后端AppointmentController.detail(PathVariable Long id)返回Appointment实体其中status字段决定凭证样式1已挂号2已取消。若凭证页空白检查/appointment/detail/1001接口是否返回200以及appointment表中id1001的记录是否存在且status1。4. 避坑指南SSMVue混合项目里最常踩的五个坑——从Mapper XML路径错位到Vue路由白屏4.1 现象2-run.bat启动后Tomcat日志报org.springframework.beans.factory.BeanCreationException: Error creating bean with name sqlSessionFactory原因mybatis-config.xml中mappers标签指向的Mapper XML路径错误。本项目Mapper XML位于src/main/resources/mapper/下如UserMapper.xml但配置文件中写成classpath:mapper/*.xml而实际路径是classpath:mapper/少了个*。解决打开src/main/resources/mybatis-config.xml将mapper resourcemapper/UserMapper.xml/改为mapper urlclasspath:mapper/UserMapper.xml/或统一用mapperspackage namecom.xxx.mapper//mappers让MyBatis自动扫描。4.2 现象Vue页面能加载但点击“预约”按钮控制台报POST http://localhost:8080/api/appointment/make 404原因前端axiosbaseURL未配置或后端Controller的RequestMapping路径与前端请求路径不匹配。本项目约定API前缀为/api但AppointmentController上只写了RestController未加RequestMapping(/api)。解决在AppointmentController.java顶部添加RequestMapping(/api)或在main.js.bak中全局设置axios.defaults.baseURL /api;。4.3 现象MySQL插入中文显示为??但application.properties已设characterEncodingutf8mb4原因JDBC URL缺少serverTimezoneGMT%2B8参数导致时区解析失败进而影响字符集协商。解决修改application.properties中JDBC URL为jdbc:mysql://localhost:3306/hospital_db?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B84.4 现象3-build.bat执行后target/目录下无WAR包或WAR包解压后static/文件夹为空原因Maven打包插件未配置资源过滤。pom.xml中需明确指定resourcesbuild resources resource directorysrc/main/resources/directory includes include**/*.xml/include include**/*.properties/include /includes /resource resource directorywebapp/static/directory !-- 关键让static目录参与打包 -- targetPathstatic/targetPath /resource /resources /build4.5 现象谷歌浏览器打开http://localhost:8080显示空白F12 Console报Uncaught SyntaxError: Unexpected token 原因Vue单页应用的HTML入口index.html未正确返回Tomcat将/请求转发给了SpringMVC DispatcherServlet而DispatcherServlet找不到对应Controller返回了404 HTML页面含html标签被浏览器当JS执行。解决在web.xml中配置默认欢迎文件并确保index.html位于webapp/根目录welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list同时在SpringMVC配置中排除静态资源拦截mvc:resources mapping/static/** location/static/ / mvc:resources mapping/** location/ /5. 数据库设计与SQL脚本实操从hospital_db.sql到可运行的挂号流水表——三个必须手动执行的建表语句5.1hospital_db.sql核心表结构为什么appointment_slot必须有version字段建库脚本中appointment_slot表定义如下精简版CREATE TABLE appointment_slot ( id bigint(20) NOT NULL AUTO_INCREMENT, doctor_id bigint(20) NOT NULL COMMENT 医生ID, date date NOT NULL COMMENT 日期, start_time time NOT NULL COMMENT 开始时间, end_time time NOT NULL COMMENT 结束时间, available_count int(11) NOT NULL DEFAULT 10 COMMENT 可预约数量, version int(11) NOT NULL DEFAULT 0 COMMENT 乐观锁版本号, PRIMARY KEY (id), UNIQUE KEY uk_doctor_date_time (doctor_id,date,start_time,end_time) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;version字段是乐观锁的基石。当两个患者同时预约同一时段事务A读取version0事务B也读取version0A先更新available_count并设version1B再更新时WHERE version0条件不成立UPDATE影响行数为0业务层捕获后提示“号源已满”。若删掉此字段超挂风险陡增。5.2user表密码加密update-password.vue.bak对应的后端逻辑在哪update-password.vue.bak中密码提交走/user/updatePassword接口后端UserController.updatePassword()调用// 使用MD5加盐加密本项目简易实现生产环境应换BCrypt String salt hospital2024; String encrypted DigestUtils.md5Hex(oldPassword salt); if (!user.getPassword().equals(encrypted)) { return Result.fail(原密码错误); } user.setPassword(DigestUtils.md5Hex(newPassword salt)); userService.updateById(user);注意DigestUtils来自Apache Commons Codecpom.xml中已引入artifactIdcommons-codec/artifactId。若忘记加盐彩虹表可秒破MD5。5.3 挂号流水导出admin/export接口如何生成Excel管理员后台/admin/export调用AppointmentExportService.export()核心是Apache POIXSSFWorkbook workbook new XSSFWorkbook(); XSSFSheet sheet workbook.createSheet(挂号流水); // 写表头 Row headerRow sheet.createRow(0); headerRow.createCell(0).setCellValue(患者姓名); headerRow.createCell(1).setCellValue(医生姓名); headerRow.createCell(2).setCellValue(预约日期); // 写数据 ListAppointment list appointmentMapper.selectList(wrapper); for (int i 0; i list.size(); i) { Row row sheet.createRow(i 1); row.createCell(0).setCellValue(list.get(i).getPatientName()); row.createCell(1).setCellValue(list.get(i).getDoctorName()); row.createCell(2).setCellValue(list.get(i).getDate().toString()); } // 输出响应 response.setContentType(application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); response.setHeader(Content-Disposition, attachment; filenameappointments.xlsx); workbook.write(response.getOutputStream());若导出失败检查pom.xml是否含artifactIdpoi-ooxml/artifactId且Tomcatlib/目录下有poi-ooxml-4.1.2.jar本项目依赖版本。6. 毕设答辩前的终极验证清单用这七步堵死所有“老师一问就崩”的漏洞6.1 验证环境一致性三处必须截图存档的终端输出答辩前务必在自己电脑上执行以下命令并截图作为环境合规证据java -version→ 确认输出java version 1.8.0_391JDK1.8mysql --version→ 确认mysql Ver 14.14 Distrib 5.7.44MySQL 5.7mvn -v→ 确认Apache Maven 3.6.3Maven 3.6。提示答辩PPT第一页就放这三张图比讲一百句“我用的是JDK1.8”更有说服力。曾有学生因老师质疑“你真用1.8”现场打开CMD输java -version结果弹出17.0.1——当场答辩中断。6.2 业务流压力测试模拟10人并发挂号验证号源不超卖用Postman批量发送挂号请求POST /api/appointment/makeBody为JSON{ patientId: 1001, doctorId: 2001, date: 2024-06-15 }发起10次请求后查appointment_slot表SELECT available_count FROM appointment_slot WHERE doctor_id2001 AND date2024-06-15;初始available_count10执行后应为0且appointment表新增10条记录。若available_count-2说明乐观锁失效——立刻检查appointment_slot表version字段是否为int类型且update语句中WHERE version?参数是否传入正确。6.3 安全红线自查三处必须删除的硬编码凭证项目中存在三处危险硬编码答辩前必须清理文件路径危险代码正确做法application.propertiesspring.datasource.password123456改为#{password}启动时通过JVM参数-Dpasswordxxx注入main.js.bakaxios.defaults.headers.common[Authorization] Bearer xxxxx删除该行登录后动态存token到localStoragesql/hospital_db.sqlINSERT INTO user VALUES (1,admin,e10adc3949ba59abbe56e057f20f883e);删除该行答辩演示时用注册功能新建账号注意答辩现场若老师用Burp Suite抓包看到明文密码毕设直接判不合格。从那以后我每次交付毕设代码都强制走一遍grep -r 123456\|password .和grep -r Bearer .宁可多花十分钟不赌老师不测。6.4 响应式适配验证用Chrome DevTools切到iPhone SE尺寸确认挂号按钮不被遮挡Vue前端虽未用Vant等UI库但IndexMain.vue.bak中CSS已做基础响应式media (max-width: 768px) { .department-card { width: 100%; margin-bottom: 10px; } .time-slot { font-size: 14px; padding: 8px 12px; } }在Chrome按CtrlShiftM进入响应式模式选iPhone SE滚动查看所有科室卡片、时段按钮是否完整显示无横向滚动条。若出现遮挡调整.time-slot的padding值而非改font-size——字号过小影响老人阅读。6.5 日志埋点验证在AppointmentService.java的appoint()方法首尾加log.info()确认挂号全流程日志可查在appoint()开头加log.info(挂号开始patientId{}, doctorId{}, date{}, patientId, doctorId, date);结尾加log.info(挂号成功appointmentId{}, appointment.getId());启动项目后挂号一次去logs/目录下找hospital.log搜索挂号开始确认日志中包含完整参数。若无日志检查logback-spring.xml中root levelINFO是否启用且appender-ref refFILE/未被注释。希望帮到你。本文还有配套的精品资源点击获取
