疫苗预约系统实战：Java+SSM与Flask混合开发及并发控制解析

做过疫苗预约系统的朋友应该都有同感这个项目乍一看不复杂无非是选疫苗、选时间、提交预约但真要做得能演示、能答辩、能跑起来不出幺蛾子里面藏的细节比想象中多得多。我这次用的是JavaSSM作为主后端Flask作为辅助服务端配合MySQL作为数据存储最后交付了源码、LW论文/文档、调试文档和讲解视频全套。这篇文章就把整个项目的拆解思路、核心表结构、两套技术栈的分工、实际调试踩过的坑以及部署跑通的经验一次性讲透适合拿它做毕业设计、课程设计或者想快速上手SSMFlask混合开发的读者参考。1. 项目拆解疫苗预约系统到底在解决什么问题1.1 核心业务需求从排队到线上预约疫苗预约系统的本质是帮接种点把“线下排队、人工登记、口头通知”的流程搬到线上。很多人一开始会把需求想得太简单认为只要做一个“填表提交”的页面就够了但实际上一个合格的预约系统至少要覆盖三个角色普通用户注册登录、查看可预约疫苗、选择接种点与时间段、提交预约、查询预约记录、取消预约。接种点管理员管理疫苗批次、设置每日可预约名额、审核或确认预约状态、查看接种名单。系统管理员管理用户、管理接种点信息、统计预约数据、维护基础数据。这里最容易被忽略的是“时间窗口”和“名额控制”。疫苗预约跟餐厅排号不一样每天每个接种点的接种能力是有限的不同疫苗的库存批次也不同。比如某接种点上午8:00到11:00能接待100人下午14:00到17:00能接待80人系统就必须把时间段拆成多个slot每个slot绑定剩余名额用户选完一个slot后名额减一。没有这个设计预约系统就只是一个“留言板”不具备实际管理价值。1.2 为什么同时使用JavaSSM和Flask两套技术栈很多同学拿到题目“基于JavaSSMFlask疫苗预约系统”之后会有个疑问SSM和Flask一个重一个轻为什么放在同一个项目里这并不是为了炫技而是有实际的分工逻辑。JavaSSMSpringSpringMVCMyBatis是这个项目的主心骨负责核心业务逻辑和持久化操作。Spring管对象生命周期、SpringMVC管请求路由、MyBatis管数据库映射。这一套组合在校园项目里非常成熟资料多、代码风格统一、面试也经常问适合放那些需要严格事务控制的模块比如用户注册、预约记录的写入、库存扣减这些。因为预约操作涉及数据库的update和insert一旦中间出错必须有事务回滚来保证数据一致性。Flask在这套系统里的角色更像一个辅助服务解决SSM不太方便做的轻量场景。比如我用了Flask写了一个独立的“预约统计与疫苗信息快速查询”接口通过简单的Python代码对MySQL做只读聚合输出JSON给管理端前端做展示。这样做的好处是不需要改动SSM主工程的代码就能快速加一个统计差值接口调试起来非常快。所以你可以把SSM看作“正式业务系统”把Flask看作“轻量数据服务”二者通过HTTP接口协作互不干扰。1.3 功能模块总览与角色权限项目整体按角色拆模块我实际划分是这样的角色核心功能典型页面/接口普通用户注册、登录、疫苗查询、预约、我的预约、取消预约register.jsp / book.do / myAppoint.do接种点管理员库存维护、预约审核、记录导出admin/vaccineManage.jsp系统管理员接种点管理、用户冻结/解冻、公告管理admin/userManage.jsp公共模块首页疫苗列表、接种点地图、统计图表Flask接口 /statistics权限控制我用了SSM的拦截器通过Session判断用户角色路径上做简单的前缀隔离比如/admin/*需要管理员身份/user/*需要登录用户身份。这里没有引入Shiro或Spring Security主要是因为课程设计项目重在展示业务逻辑用拦截器足够轻量也更容易跟面试官讲清楚。2. 数据库设计与核心表结构2.1 表设计思路用户表、疫苗库存表、预约记录表数据库是疫苗预约系统的地基。我总共设计了6张核心表分别为用户表、疫苗接种点表、疫苗信息表、疫苗批次表、预约时段表、预约记录表。这里重点说三张。用户表是最简单的字段包括用户名、密码用了MD5加盐、真实姓名、手机号、身份证号、角色、注册时间、状态。需要注意手机号和身份证号要加唯一索引避免测试数据重复导致逻辑混乱。疫苗信息表里存疫苗名称、生产企业、适用人群、接种剂次等基础信息。疫苗批次表跟疫苗信息表是多对一的关系存批号、入库时间、库存数量、有效期。为什么要拆成两张表因为同一种疫苗可能有多批入库记录不同批次的有效期和库存也不同。实际做预约减库存时要先根据疫苗ID和到期时间选出“未过期且库存充足”的批次然后在该批次上扣减数量。预约时段表是核心中的核心。它把接种点一天的接待能力拆成若干个时间段例如“2024-06-01 08:30-09:30”total_capacity50appointed_count0。用户预约时系统检查该时段是否未满然后新增一条预约记录并把appointed_count加1。这个表让“能否预约”的判断变得非常简单也方便管理员后续查看某个时段是否排满。2.2 库存扣减与并发控制的关键点疫苗预约最容易出现的线上问题就是“超卖”——明明只剩最后1个名额两个人同时提交最后都成功了。解决这个问题最直接的办法是给预约时段表加一个MySQL行锁在更新名额之前先select ... for update锁住当前时段的记录。我实际是用MyBatis写了一个自定义SQL来实现的核心逻辑如下-- 原子更新只有当剩余名额大于0时才扣减 UPDATE vaccine_slot SET appointed_count appointed_count 1 WHERE slot_id #{slotId} AND appointed_count total_capacity;执行完这条SQL后再通过int rows mapper.updateSlotCount(slotId);判断影响行数如果影响行数为0就直接返回“该时段已约满”。这种做法比“先查再改”安全很多因为update语句本身具有原子性在默认的MySQL事务隔离级别下两个并发请求同时执行这条SQL时行锁会保证一次只有一个事务能成功更新。最后在Service层给整个预约流程加上Transactional注解保证“扣减名额”和“插入预约记录”这两个操作要么都成功要么都回滚。这一点特别重要。我调试的时候就遇到过先扣了名额但没有插入预约记录的情况原因就是Service方法内抛了异常但事务没有生效后来检查发现是事务注解被写在了Controller层SpringAOP没拦截到改成Service层后就好了。2.3 时间窗口与预约规则如何落到字段预约规则不能只写在代码里要能通过数据库字段控制。我在预约时段表里设计了以下字段字段名含义示例start_time时段开始时间2024-06-01 08:30:00end_time时段结束时间2024-06-01 09:30:00total_capacity总名额50appointed_count已预约数32vaccine_id关联疫苗ID2vaccination_point_id关联接种点ID1status状态开启/关闭1在代码里判断是否还能预约的逻辑是当前时间小于end_time减去某个提前量比如30分钟并且appointed_count小于total_capacity。这样就把“提前多久截止预约”“某时段是否还能约”这些规则数据化了不用每次改规则都改代码。另一个容易漏的点是“一个用户同一疫苗只能预约一次”我在预约记录表上建了用户ID和疫苗ID的联合唯一索引防止重复预约。3. SSM端与Flask端的分工与实现细节3.1 SSM后端预约管理与数据持久化SSM后端承担了绝大部分的正式业务接口。我在Controller层按资源划分Restful路径比如POST /user/register用户注册POST /user/login登录GET /vaccine/list疫苗列表POST /appointment/apply提交预约GET /appointment/my我的预约记录POST /appointment/cancel取消预约Service层里AppointmentService是最核心的一个类它的applyAppointment方法执行了前面提到的原子扣减和事务控制。SpringMVC配置里我额外加了JSON序列化配置使用Jackson把Java对象输出成前端友好的JSON而不是传统的ModelAndView跳转。因为管理端页面要用Ajax异步刷新所有接口都设计成返回统一的结果对象Result里面包含code、message、data三个字段前端拿到code判断成功与否。MyBatis的Mapper层我用的是XML映射文件因为SQL复杂的时候注解式写起来太乱。特别是多表联查比如查询“我的预约列表”时需要同时联用户表、疫苗表、接种点表、时段表一条SQL拿到所有展示字段。XML方式可以直观调试SQL而且用MyBatis的二级缓存也能方便地加在查询上。3.2 Flask轻量服务给管理端补一个快速查询/统计接口Flask部分我单独建了一个flask_service目录包含app.py、db_config.py、requirements.txt。它主要负责两块内容一是疫苗接种点的热力图数据统计二是按日期维度的预约量趋势。技术上非常简单就是用PyMySQL连接MySQL写几个只读查询然后用Flask返回JSON。比如要查询“近7天每天的预约量”核心代码大约是这样from flask import Flask, jsonify import pymysql app Flask(__name__) app.route(/api/statistics/daily) def daily_statistics(): db pymysql.connect(hostlocalhost, userroot, password123456, dbvaccine_db, charsetutf8mb4) cursor db.cursor() sql SELECT DATE_FORMAT(appoint_time, %Y-%m-%d) as day, COUNT(*) FROM appointment WHERE appoint_time DATE_SUB(CURDATE(), INTERVAL 7 DAY) GROUP BY day cursor.execute(sql) rows cursor.fetchall() cursor.close() db.close() return jsonify({code: 0, data: rows})这样管理端前端的ECharts图表就可以直接请求Flask的接口拿数据SSM端完全不用管。这里有个小小的设计心得在正式的项目中一个系统通常不会因为要加一个统计功能就引入一套Python服务但在课程设计里这样能展示你对两种技术栈的掌握又不会把主工程搞乱反而是一个亮点。3.3 前后端衔接接口统一与协议约定两套后端服务都要给前端提供数据所以接口协议必须一致。我的做法是统一使用JSON格式并且统一字段命名风格为code、message、data三层结构。这样前端在处理SSM接口和Flask接口时只需要写一个通用的handleResponse方法即可。跨域的问题也要处理一下。Flask服务运行在5000端口而SSM工程跑在8080端口管理端页面从8080请求5000端口时浏览器会拦截跨域请求。我在Flask里加了CORS支持最简单的方法是用flask-corsfrom flask_cors import CORS CORS(app)SSM端本身没有跨域问题因为JSP页面和Controller同源。如果你用的是前后端分离模式那就需要统一在后端网关或Controller上加CORS配置不过这个项目里没有用到。4. 完整实操流程从导入源码到本地跑通4.1 环境准备与版本选择JDK、Maven、MySQL、Python跑通这个项目的第一步是环境。我的建议是不要全用最新版而是要选稳定搭配否则光排版本坑就要好几天。JDK1.8SSM框架在JDK8下最稳不要用JDK17跑老项目容易遇到反射和代理的兼容问题。Maven3.6.3或3.8.x配置阿里云镜像否则依赖下载会让人崩溃。MySQL5.7或8.0均可注意MySQL8的驱动必须是com.mysql.cj.jdbc.Driver并且URL要加useSSLfalseserverTimezoneAsia/Shanghai。Python3.8以上Flask 2.x均可PyMySQL按需安装。我用的IDE是IDEAPython侧用PyCharm或者是IDEA自带的Python插件都行问题不大。4.2 配置文件的调整数据库连接与端口SSM工程的关键配置文件有三个applicationContext.xml、springmvc.xml、mybatis-config.xml但真正需要改的是数据库连接池配置。我用的是Druid连接池配置位于applicationContext.xml中你需要根据自己的MySQL账号密码修改url、username、password。Flask端的配置就简单了直接在db_config.py里改数据库信息DB_CONFIG { host: localhost, port: 3306, user: root, password: 123456, db: vaccine_db, charset: utf8mb4 }另外一个容易忽略的地方是日志文件路径。项目里用了log4j输出日志如果你在Windows上运行要确保log4j.properties里配置的日志输出路径存在否则启动时日志无法写入但错误提示又不够明确很多人会误以为是框架配置文件写错了。4.3 初始化数据与测试流程数据库初始化我用的是一个init.sql脚本里面包括建库、建表、插入基础数据。基础数据主要有3个接种点社区卫生服务中心、医院预防接种门诊、临时接种点5种疫苗信息未来7天每天4个时段的预约时段记录这里的疫苗信息我用的是通用占位名称不含具体品牌。插入预约时段数据时用了一个小技巧在SQL脚本里通过日期函数动态生成未来7天的时段而不是手动写几百行insert这样脚本更简洁重新部署时也不会因为日期过期导致没有可预约时段。测试时我推荐按照以下顺序启动Flask服务访问http://localhost:5000/api/statistics/daily确认能返回JSON。启动Tomcat访问SSM工程首页确认跳转到登录页。注册一个新用户然后去预约一个疫苗。去数据库查appointment表确认有记录同时vaccine_slot表的appointed_count增加了1。再用同一个用户重复预约同一疫苗确认提示“不可重复预约”。整套流程跑通之后这个项目的核心逻辑就没有大问题了。5. 调试过程中踩过的坑与排查方法5.1 数据库中文乱码与时区问题这是我在这个项目里第一个遇到的坑。插入的中文数据在数据库里显示为乱码用命令查出来是???。原因有两层一层是数据库连接URL没有加characterEncodingutf8另一层是MySQL表本身的字符集不是utf8mb4。解决办法是两处都改连接池URL加上characterEncodingutf8useUnicodetrue然后在init.sql里显式指定CREATE DATABASE vaccine_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;时区问题则表现为存入数据库的时间比本地时间少8小时或者Tomcat启动时提示The server time zone value CST is unrecognized。这个是最常见的问题归根结底是MySQL8对时区更严格了。直接在JDBC URL后面加serverTimezoneAsia/Shanghai即可。5.2 预约时间重叠的并发问题我用JMeter模拟100个用户同时预约同一个时段结果发现预约成功数超过了total_capacity。原因是我最初写的逻辑是先执行查询判断appointed_count total_capacity然后在Service层拼SQL去更新这中间存在时间差高并发下多个请求都能通过判断。后来改成用单条update语句原子更新前面提到的那条SQL再用影响行数判断问题就解决了。通过这种测试也能直观理解“高并发下的超卖问题”这是面试时很容易被追问的点强烈建议你亲手测一遍能讲出细节。5.3 Flask跨域与Session共享问题管理端页面在8080端口Flask在5000端口一开始我直接从JS请求Flask接口浏览器控制台报CORS错误。解决办法前面说了用flask-cors的CORS(app)即可。还有一个隐蔽的问题是Session共享。SSM端用Tomcat Session保存登录状态Flask端如果需要知道当前登录用户是谁就不能直接读同一个Session。我的处理方案是Flask只管公开的统计数据和疫苗信息不需要用户身份。如果你的项目里有“管理端登录后才能看统计数据”的需求一个简单的做法是让SSM端在登录成功后生成一个token存Redis或数据库前端请求Flask时带上tokenFlask再验证但这样就多了一套组件课程设计里我建议你把需要权限的数据接口放回SSMFlask只做公开接口。6. 部署上线与交付文档的整理心得6.1 部署到服务器时需要注意的细节本地跑通之后还要部署到云服务器或者答辩用的机器上。这一步我建议至少保留一个干净的部署文档因为现场演示时如果启动失败有文档可以快速排查。部署时比较常见的坑包括Tomcat默认8080端口被占用需要改端口或关闭其他Java进程。服务器的MySQL版本与本机不一致导致连接驱动不匹配。Flask服务没有设置host0.0.0.0只能本机访问前端页面从外部访问时接口报错。启动改成app.run(host0.0.0.0, port5000)就好。Linux环境下没有放行防火墙端口8080和5000都需要在安全组里开启。生产环境下的MySQL密码一定要改不要用代码里的弱口令。同时建议把数据库脚本和初始数据单独导出部署后用source /xx/init.sql重新初始化一遍避免数据不一致。6.2 调试文档和讲解视频的配套价值这份项目交付的时候包含源码、LW设计论文/文档、调试文档和讲解视频。调试文档真的太关键了。我见过的很多课程设计项目源码能跑但运行步骤写得极其敷衍评审老师照着文档跑第一步就卡住。好的调试文档至少应该包含环境要求JDK版本、Maven版本、MySQL版本、Python版本。导入工程步骤是IDEA导入Maven工程还是Eclipse导入要不要转换。数据库初始化命令具体到执行哪条SQL。修改哪些配置列出所有需要改密码/账号的地方。启动顺序先启动Flask还是先启动Tomcat访问哪个URL。常见错误对照表比如404、连接失败、端口冲突分别怎么解决。讲解视频我建议控制在15到20分钟讲清楚三件事整体架构、核心表结构、预约流程代码。不要对着PPT念直接跑一遍系统然后在IDE里把AppointmentService的核心方法逐行讲这个思路最容易被听明白。另外源码的命名规范也很影响口碑。Controller、Service、Mapper不要用Test1、Demo2这种名字类名和方法名尽量让人看一眼就知道干什么。代码里的注释不用太多但关键的业务判断比如扣减名额和事务边界都要写清楚为什么这样做。项目的可读性直接影响答辩的效率和印象分这一点是很多人会忽略的。最后再分享一个小经验把所有配置文件里的绝对路径都改成了相对路径日志输出目录用的是项目目录下logs文件夹避免换台机器就找不到日志。这个细节看似不起眼但在最终验收的机器上往往就是这些小事决定了运行是否顺畅。希望这份拆解能帮到你按着这个思路把项目跑通你就能在答辩的时候理直气壮地说这个疫苗预约系统是我完整做出来的。