宠物医院信息管理系统设计与实现：Java+SSM+Flask完整方案

做个宠物医院信息管理系统这个题目，我前前后后经手过好几个版本，但真正交付出去能在一个小诊所里稳定跑起来的，靠的从来不是堆页面和CRUD代码，而是对业务链路的透彻理解。这篇文章把我的设计方案、开发思路和踩过的坑完整写一遍，适合正在准备Java方向毕设的同学，也适合想给自己的小门诊配一套内部管理系统的朋友参考。项目整体结构是Java+SSM作为核心业务后端，Flask作为辅助服务，覆盖宠物档案、挂号、病历、开药、收费、库存、疫苗提醒和统计报表这些关键环节，配套源码、文档、调试说明都能一起交付，照着这个思路做，整体流程不会偏。

1. 项目定位与技术选型：医院管理系统的第一刀

1.1 先想清楚宠物医院的业务是怎么回事

很多人一拿到这种题目就开始建表、写登录、做增删改查，做完才发现跟真实诊所对不上号。我自己动手之前，专门在两家小型宠物医院蹲过几天，观察前台和医生的真实操作流程，才发现这里面的核心不是“宠物信息管理”，而是“一次就诊到底经历了哪些状态变化”。

一次完整的就诊业务是这样的：主人带宠物到前台，挂号，系统给这只宠物和医生建立一次关联；医生在诊室里看到待诊列表，叫号，然后开始问诊、检查、写病历；检查完如果开了药，处方流到收费处；收费完成之后，药房从库存里扣减对应药品；最后如果这只宠物需要打疫苗或者复诊，还要在档案里留下记录，方便后续提醒。

这条链路上至少有五个角色：前台、医生、收费员、药房、宠物主人。每个角色关心的数据不一样，页面和操作权限也不一样。这个理解定下来之后，系统的模块划分和数据库设计才不会有大的返工。你看很多管理系统做出来不好用，普遍原因是把系统做成了“信息录入工具”，而不是“流程支撑工具”，宠物医院的管理系统尤其吃这一套，就诊流程走不顺，代码写得再多也白搭。

1.2 为什么核心用SSM，又额外加一个Flask

关于为什么选SSM而不是Spring Boot，肯定有人纠结。我的考虑是：这是课程设计或毕业设计场景里非常经典的一组搭配，Spring+SpringMVC+MyBatis三件套的学习资料最全，面试被问到的概率也高，团队里的同学多多少少都接触过，上手成本低。如果放在真实企业内部，我会建议直接上Spring Boot，但作为学习和交付型项目，SSM反而能让人把“配置是怎么工作的”这件事学透，部署时也少很多黑盒，对答辩也有好处。

Flask加进来干什么？起初我也想过一套技术栈全干完，但做到疫苗提醒和统计报表的时候遇到了现实问题：每隔几分钟要扫描一次免疫记录，把近7天内到期的宠物筛选出来，同时还要更新提醒标记；每个月要按医生、按科室、按药品维度导出好几份Excel报表。这种定时任务和文件导出逻辑如果混在核心业务工程里，会让代码不断膨胀，也给核心事务链路添乱。所以我把这类相对独立的功能拆成了Flask子服务，通过共用数据库和HTTP接口来做整合。

顺带说下为什么没选FastAPI。FastAPI的异步性能确实好，文档也漂亮，但在这个场景里根本没有高并发压力，Flask的生态更成熟、部署示例更多、遇到问题随便一搜全是答案。技术选型不是越新越好，而是在交付周期里找到一个所有人都能维护的组合，够用且稳定，才是做项目选型的第一原则。

2. 核心功能模块与数据库设计：先把地基画对

2.1 功能模块全景图

整个系统的模块我归纳成八块，不多不少，每一块都对应真实业务角色：

模块	核心功能	面向角色
用户与权限	登录、角色控制、菜单动态渲染	所有用户
宠物档案	主人信息管理、宠物档案增改查、历史病历查询	前台、医生
挂号就诊	挂号、取消、待诊队列、就诊状态流转	前台、医生
电子病历	症状、诊断、医嘱、复诊记录	医生
处方与收费	处方录入、明细计价、收费结算、退费	医生、收费员
药品进销存	药品档案、入库、库存预警、出库扣减	药房
疫苗提醒	免疫记录、到期扫描、提醒消息	系统自动+前台
统计报表	就诊量统计、营收统计、药品消耗排行	院长/管理员

这里要特别说一句：权限不能做成摆设。我见过不少管理系统登录之后所有菜单全平铺出来，这种系统在真实诊所里根本没法用。我的做法是设计用户表、角色表、菜单表三张基础表，再通过两张关联表把用户和角色、角色和菜单关联起来。登录时查出用户的角色，再根据角色查出菜单树，前端只渲染当前角色可见的菜单。这个设计在答辩时也很加分，因为它说明你不是只做了CRUD，而是真的考虑到了实际管理里的权限隔离需求。

2.2 表结构设计：哪些字段一定是必须的

数据库设计是整个项目里最值得花时间的地方，表结构错了，后面写多少代码都是在打补丁。我的核心表有这么几张：主人信息表、宠物档案表、挂号表、病历表、处方主表、处方明细表、药品表、用户表。看里层最关键的几张表：

宠物档案表（pet）：

字段	类型	说明
id	bigint	主键
owner_id	bigint	关联主人表
name	varchar(50)	宠物名
species	varchar(20)	物种：犬、猫、其他
breed	varchar(50)	品种
birth_date	date	出生日期
weight	decimal(6,2)	体重，按公斤
is_deleted	tinyint	软删除标记

挂号表（registration）：

字段	类型	说明
id	bigint	主键
pet_id	bigint	关联宠物
doctor_id	bigint	关联医生
visit_date	datetime	就诊时间
status	tinyint	1待诊 2就诊中 3已完成 4已取消

处方明细表（prescription_item）：

字段	类型	说明
id	bigint	主键
prescription_id	bigint	关联处方主表
drug_id	bigint	关联药品
quantity	int	数量
unit_price	decimal(10,2)	单价，下单时冗余存储
amount	decimal(10,2)	金额小计

这里有几个从实战里总结出来的要点。金额字段一律用decimal(10,2)，不要用float或者double，宠物医疗一针也要几十上百，浮点误差在收费环节完全不能容忍。宠物档案一定要加is_deleted软删除，医疗记录是连续数据，一旦误删整个治疗链路就断了，软删除可以随时恢复。处方明细里要把单价冗余存进去，因为药品价格调整以后，历史处方金额不能跟着变，这是财务凭证最基本的“不可变”思路。状态字段用tinyint，代码里配上统一的状态枚举类，不要在业务代码中到处写魔法数字1、2、3，否则后面维护的人会很痛苦。

另外还有一张容易忽略的表是药品库存表。我最初只设计了药品主表，库存字段直接挂在主表里，后来发现入库批次、入库单价、效期管理根本没法做，才补了一张入库流水表。所以建议一开始就把药品主表和入库流水分开，哪怕是做简化版，至少也能应对两个月的数据积累。

2.3 从实体类直接生成建表SQL的小技巧

当前讨论度很高的一个点是“根据Java实体类生成创建表的SQL语句”，我实际项目里就是这么做的。做法是先在Java实体类里把每个字段写清楚，尤其是字段注释一定要完整，然后用一个小工具把实体类反射解析成建表语句，批量生成数据库表。这样维护实体类的时候，数据库结构能保持一致，省去了大量手写CREATE TABLE的时间，也避免了注释和字段类型不一致的问题。

我的具体套路是这样：写实体类时严格遵循统一规范，主键字段标@TableId，逻辑删除字段标@TableLogic，其他字段用@TableField注明数据库列名和注释。生成SQL的工具读这些注解，自动拼接出CREATE TABLE IF NOT EXISTS语句，工具本身代码不多，能跑就行，不追求通用。如果你用的是MyBatis-Plus，它的代码生成器可以反向根据表生成实体类，但从实体类正向生成建表语句，往往需要自己写点工具。我始终坚持以实体类为基准，数据库脚本靠工具生成，这个习惯后来帮我省了很多维护成本，改字段时只改一处，刷新下脚本就行。

3. 实战开发：从挂号到收费的完整链路怎么落地

3.1 SSM项目骨架与配置

核心后端用Maven管理，工程结构按Controller、Service、Mapper、entity分层。SSM的配置有几个翻车高发点，我踩过之后总结成三条。第一，Spring的扫描包不要和SpringMVC的扫描包重叠，Spring只管Service、Mapper这些业务组件，SpringMVC只管Controller，重叠会导致Service被初始化两遍，事务代理失效。第二，数据库连接池直接上Druid，配置好监控页面后，慢SQL和连接情况一目了然，调试的时候真的爽。第三，MyBatis的全局配置里开启下划线转驼峰映射，这样数据库列名和实体类属性名才能自动对应，减少大量重复的resultMap编写。

启动Tomcat之前，我本机装了多个JDK版本，因为有的老SSM项目对JDK版本敏感，有的新工具链又要求更高版本。这里分享一个多JDK切换的经验：尽量不要频繁改系统环境变量JAVA_HOME，而是用IDEA的Project Structure给不同项目分配独立SDK，再在运行配置里指定JRE，这样能同时维护JDK8和JDK11的项目，互不干扰。

3.2 挂号、病历、开药、收费一条链路

这个项目的主业务链路，我把它处理成一条事务链。前台挂号时，插入挂号记录，把宠物状态更新为“就诊中”；医生完成问诊后填写病历，插入medical_record；开药时插入处方主表和处方明细表；收费员结算时插入收费记录，并把药品库存扣减掉。这条链路任何一个环节失败都要整体回滚，不能出现“挂号成功但病历只存了一半”这种脏数据。

这里有个容易被忽略的细节，就是扣库存。一开始我用的是“先查库存，判断库存够不够，再update扣减”，但多人同时操作时，库存会被扣成负数。后来改成一行SQL：

update drug set stock = stock - #{quantity} where id = #{drugId} and stock >= #{quantity}

执行后受影响行数为0，就说明库存不足，直接抛业务异常结束事务。这样是用数据库的行锁解决了并发问题，不需要引入Redis或分布式锁那些额外复杂度，在诊所这种并发量场景下完全够用。

接口设计我习惯按资源来命名，比如挂号对应POST /api/registration，保存病历对应POST /api/medicalRecord，开处方对应POST /api/prescription，收费结算对应POST /api/payment。响应统一用一个Result对象包装，固定三个字段：code、message、data。所有业务异常都由全局异常处理器接住，返回友好提示，而不是把Java异常堆栈直接甩给页面。

前端页面我这里用的是JSP渲染，配合一套简洁的后台管理模板，登录页和主框架是静态布局，菜单由后端根据角色动态渲染。写JSP时踩过最大的坑是EL表达式和JSTL标签库的版本冲突，后来统一了Servlet 3.1以上版本配套的依赖才解决。如果你不想用JSP，也可以换成Vue通过Ajax调后端接口，展示效果更现代，但工作量会大一些。作为毕设交付，JSP方案的好处是每个页面功能都能直接被老师点开看到，不需要额外启动一个前端工程。

这里还要补充一个我在权限部分的具体实现思路：用户登录后，后端把该用户的菜单清单一次性返回，前端渲染成侧边栏，同时后端在每一个Controller接口上做角色校验。权限校验千万不要只在前端做，因为接口是可以被直接调用的，只隐藏菜单不校验接口等于没设防。

3.3 Flask子服务：疫苗提醒和报表导出

Flask在这里承担的是两个相对独立的辅助任务。第一个是疫苗提醒，因为疫苗记录是持续性的，主人经常忘记下一次注射时间，系统需要定期扫描疫苗记录表，找出未来7天内到期的宠物，然后生成提醒记录。我使用APScheduler作为定时任务框架，每天凌晨跑一次扫描，扫描逻辑很简单：查询所有免疫记录，计算下次免疫日期和当前日期之差在7天以内，且没有被标记为已提醒的记录，就生成提醒。这里有个经验：提醒状态标记不要让Flask直接更新主库的核心业务表，更稳妥的做法是Flask调用SSM提供的一个内部HTTP接口，由核心系统去完成状态更新，这样写操作的入口始终收敛在一套代码里，避免两边同时写库造成数据不一致。

第二个是统计报表导出。就诊量、营收、药品消耗排行这些数据如果让管理员在页面上慢慢翻，体验很差，所以我做了报表下载接口：从数据库统计汇总后，用openpyxl生成Excel文件，前端点击按钮直接下载。生成Excel时要注意设置列宽、表头和自动筛选，这些细节虽然不起眼，但直接关系到使用的人愿不愿意真的把报表用起来。Flask端不需要做登录页，因为它是内部服务，只对核心系统暴露几个简单接口，定位很轻，代码量也很小，维护起来非常方便。

3.4 两个技术栈联调时最容易翻车的三个点

这种多技术栈项目联调时最容易出问题。第一个坑是JSON字段命名不一致，Java后端习惯用驼峰，Python端用字典的键直接取，很容易对不上。我的解决办法是确立统一标准：所有对外接口的字段名一律用小写下划线，由Java端做序列化配置统一输出，Python端直接按下划线处理。

第二个坑是时间字段格式和时区。Java的LocalDateTime默认序列化出来是数组格式，Python端根本没法直接解析；数据库连接的serverTimezone没设置好的话，查出来还会差8个小时。我在两个服务里统一约定时间全部用字符串格式yyyy-MM-dd HH:mm:ss传输，入库前再按统一格式解析，项目跑起来之后没再因为时间问题折腾过。

第三个坑是字符集。MySQL连接URL上必须加characterEncoding=utf8，Tomcat的URIEncoding也要设成UTF-8，否则中文数据在页面和接口之间传几次就乱码。别再等到数据写脏了再回头排查，最省事的办法是一开始就统一编码。

4. 部署、调试与常见问题排查实录

4.1 本地调试环境的配置清单

这个项目要顺畅跑起来，环境整理顺序很重要。先装JDK和Maven，JDK8就可以；然后用IDEA导入后端工程，配置好Maven仓库；MySQL建好库，执行生成的建表脚本和初始化数据。Flask端建议用虚拟环境，把依赖固定在requirements.txt里，一次pip install -r requirements.txt装完。装好之后先单独确认Flask服务能起来，再启动Tomcat，最后联调。分段启动的好处是出问题时能第一时间定位是哪个技术栈的事情。

端口规划我固定为：Tomcat跑8080，Flask跑5001，两个服务分开端口避免冲突。前端页面通过8080访问，页面中需要调用Flask接口的地方，通过后端服务内部调用。因为不是浏览器直接跨域访问，跨域问题基本不存在。如果以后要把Flask接口直接暴露给前端Ajax调用，那就需要单独处理跨域配置。

4.2 部署上线：war包、gunicorn与进程守护

如果要把项目部署到服务器，SSM部分我会打成war包放进Tomcat的webapps目录启动，而不是用IDEA里集成的Tomcat去跑。原因很简单，IDE里的运行方式依赖开发环境，换个机器就不好复现，而war包部署是标准套路，答辩和交付时随便找一台装好Tomcat的服务器就能跑起来。数据库连接信息、账号密码全部放在配置文件里，部署时替换成服务器真实值，正式交付时还会把敏感信息单独抽出来维护，避免源码里直接带密码。

Flask部分部署时不要用自带的开发服务器，那个只适合作本地调试。我用gunicorn起多进程，启动命令大致是gunicorn -w 4 -b 0.0.0.0:5001 app:app，4个worker对辅助任务足够。再用systemd做进程守护，保证进程挂掉后能自动拉起。这在正式跑业务时特别重要，定时任务如果因为进程挂了没跑，疫苗提醒全会漏掉，这种情况我真实遇到过，后来加了进程守护才解决。

4.3 常见问题速查表

现象	原因	解决办法
中文乱码	数据库连接或Tomcat编码未设置	连接URL加characterEncoding=utf8，Tomcat配置URIEncoding=UTF-8
Service事务不生效	Spring和SpringMVC扫描包重叠，Service被初始化两遍	Spring只扫描service和mapper，SpringMVC只扫描controller
扣库存出现负数	并发更新没加条件	用update drug set stock=stock-? where id=? and stock>=?，影响行数为0则提示库存不足
Flask连MySQL报认证错误	MySQL8默认caching_sha2_password认证插件冲突	创建用户时指定mysql_native_password，或做兼容处理
Java时间序列化成数组	LocalDateTime默认序列化格式问题	统一配置Jackson格式为yyyy-MM-dd HH:mm:ss
接口500但日志没输出	MyBatis SQL日志级别太高或日志配置缺失	把mapper包日志级别设为DEBUG
部署后页面资源404	context-path和请求路径不一致	核对Tomcat应用名，前端加统一前缀

这张表就是我调试阶段挨个踩过的坑汇总，可以直接当成排查手册用。再说一句经验之谈：遇到问题先看SQL日志，再看HTTP状态码，再看控制台异常，最后才去怀疑配置。排查顺序反了，一个小问题能查一下午。

4.4 交付项目时源码和文档怎么组织

标题里提到的源码、LW、调试文档和讲解，我整理了一套目录结构，也推荐你这么做。第一类是源码工程，Java后端工程、Flask子服务、数据库脚本分别放独立目录，每个工程都带README，写清楚JDK版本、依赖安装方式、启动步骤。第二类是数据库脚本，建表SQL和初始化数据放一个sql目录。第三类是配套文档，包括设计文档、需求说明、操作手册、答辩PPT，其中设计文档要重点写数据库设计和接口设计，老师翻得最多的就是这两块。第四类是调试文档，记录主要问题和解决过程，也就是前面那张速查表的完整版。

有了这四类内容，哪怕三个月后自己回来看这个项目，也能快速把环境跑起来，不只是给老师看，更是给自己省时间。至于讲解视频或者讲解录音，我的建议是不要照着PPT念，按“业务是什么→流程怎么走→代码怎么落→问题怎么解”这个顺序来讲，演示时先跑一遍真实流程，再切到关键代码位说明设计意图，听的人才会相信你是真的懂。

最后说一点我个人的体会。做完这套系统最深的感受是：技术选型再花哨，不如把一条业务链路理顺；与其纠结SSM和Flask哪个更好，不如先把挂号到收费的每一步状态流转写清楚。如果你后面想在这个项目上继续扩展，建议从微信预约、在线问诊、电子发票这几个方向去加，这些都是宠物医院真实存在的需求，每补一块，系统离“真正能用”就更近一步。