1. 项目整体设计与需求拆解1.1 医疗物资管理的核心痛点与解决思路做计算机毕业设计选医疗物资管理系统这个方向的人不少但真正能把它讲清楚、做扎实的没几个。我在实际做这套基于JavaSpringBoot的医疗物资仓储管理平台时最大的感受是这个题目表面上看是个普通的CRUD项目但实际上涉及到了库存管理、出入库流程、权限控制、数据一致性等一整套企业级Web系统的基础能力。医院物资和普通商品不一样口罩、试剂、药品、耗材每一种都有批次、有效期、库存上下限甚至部分物资需要冷链追溯。手工台账或者Excle登记的方式在人数少的小诊所还勉强能撑一旦到医院这种规模物资种类几百上千、日常出入库频繁、科室领用量大就很容易出现账实不符、过期浪费、应急物资短缺这些问题。所以这套系统要解决的不是能不能记录一条出入库数据这种表面问题而是如何在多人协作、高频操作的情况下保住库存数据的准确性。毕设选题如果只说做一个物资管理系统答辩时老师一问你做这个系统的价值是什么就会卡壳。把思路聚焦到仓储管理和出入库流转控制上再配合预警、追溯、权限这些具体能力整个项目的技术含量和业务价值就立起来了。这套系统适合两类人参考一类是需要快速搞定毕业设计、但又不想做纯增删改查的同学另一类是刚入职想做Web开发练手、想了解SpringBoot如何落地真实业务的初学者。1.2 技术栈选型为什么是JavaSpringBoot组合选JavaSpringBoot这个组合在当下的Web项目里几乎就是标准答案。SpringBoot的自动配置大大简化了传统SSH项目的XML配置内置Tomcat一个main方法就能启动项目。对于毕设来说这意味着你不用在环境搭建上耗费太多精力可以把时间花在业务逻辑和功能实现上。而且Java在就业市场上的需求量大用SpringBoot做出来的项目后续拓展成微服务、对接消息队列、集成分布式缓存都有清晰的演进路径面试时也能顺着这个话题展开。我见过有人用SSMSpringSpringMVCMyBatis做这个题目也能做但配置繁琐也有人用若依这种脚手架直接改改完了自己都不知道代码在哪答辩一问就露馅。SpringBoot的优势在于约定大于配置再加上MyBatis-Plus做ORM、MySQL做存储几乎是国内中小型Web系统最成熟的组合。技术选型不需要花哨能把业务模型讲清楚、把事务和并发处理明白比堆一堆中间件更实在。Web端我采用的是模板引擎加少量前端组件的方式整个系统跑在浏览器里不依赖微信小程序或独立App管理部门随时打开电脑就能操作这是最贴合医院实际使用场景的形态。1.3 功能模块划分与业务流程先把需求拆成几个模块基础信息维护、物资出入库管理、库存查询与预警、系统用户与权限、统计报表。这些模块不是平级的而是有一条主链路——物资从供应商入库经过院内的科室领用出库最终形成消耗记录。系统需要跟踪的是每一次出入库的来龙去脉而不是只维护一个当前库存数。出库的时候要关联到具体科室入库的时候要关联到供应商和批次号这样后续做溯源和统计才有数据支撑。业务流程上最简单的设计是先入后出、批次管理。入库单创建后系统自动增加对应物资的可用库存出库单创建时可以选择先进先出FIFO或指定批次扣减库存。每一次操作都生成一条独立的流水记录库存在数据库里是一个冗余字段平时查询直接读这个字段但写入时必须通过事务保证流水记录插入 库存字段更新是原子的。这个设计思路也是后期排查账实不符问题的关键。功能逻辑理清之后下一步就是设计数据库表结构。2. 数据库设计与后端核心实现2.1 数据表设计与关系建模数据库是这个系统的地基表设计得是否合理直接决定后面写代码是顺畅还是痛苦。我做这套系统时把表拆成了九张用户表sys_user、角色表sys_role、用户角色关联表、物资信息表material_info、供应商表supplier、入库单表stock_in_order、入库明细表stock_in_item、出库单表stock_out_order、出库明细表stock_out_item。还有一个可选的预警记录表如果不想单独建表可以用SQL实时查询过期或低库存的物资。物资信息表是核心主数据字段包括物资编码、名称、规格型号、计量单位、分类药品/耗材/器械等、库存上下限、是否冷链、存储条件、有效期天数。这里有一个容易被忽视的点批次信息。同一款物资不同批次进价可能不同有效期也不同。我采用的方式是把批次信息嵌入出入库明细表入库时记录批次号出库时记录是从哪个批次出的库存表里用物资ID批次号作为粒度。不建议把批次单独建一张大表除非做很精细的批次追踪否则明细表冗余一个批次号字段就够了。数据库字符集统一用utf8mb4排序规则用utf8mb4_general_ci避免中文乱码和特殊字符问题。2.2 SpringBoot项目结构与MVC分层SpringBoot的项目结构看似简单但很多人会踩坑Controller里写业务逻辑、Service层全是空壳、SQL直接拼字符串。我建议按标准的分层来别偷懒。包结构大致是这样com.hospital.material ├── controller // 接收请求校验参数返回结果 ├── service // 业务逻辑事务控制 ├── mapper // MyBatis-Plus的数据访问接口 ├── entity // 数据库实体 ├── dto // 前端交互的数据对象 ├── common // 统一返回结果、异常处理、工具类 └── config // 配置类比如拦截器、跨域、自定义序列化Controller层只做参数接收和结果封装业务判断全部下沉到Service层。比如创建出库单时Service层要做的工作包括校验库存、校验有效期、生成出库单号、写入明细、更新库存、记录操作日志这个过程必须加上Transactional注解任何一个环节失败整体回滚。很多毕设项目看起来功能齐全但一遇到并发操作就库存变负数原因就是没有处理好事务和锁。MyBatis-Plus可以用Update自定义SQL做库存扣减时自动加上stock #{num}条件这样比先查再更新更安全。统一返回结果类我用的是ResultT包含code、message、data三个字段。所有Controller方法都返回这个类型前端拿到后统一判断code200再渲染否则弹出错误提示。异常处理则用一个RestControllerAdvice全局拦截业务异常返回400未知异常返回500这样调试起来也很方便不需要在Controller里到处写try-catch。2.3 关键业务逻辑库存扣减与事务控制库存扣减是整个系统最容易出问题的环节。我先说一个常见错误写代码时先查库存判断够不够然后再执行update扣减。这个过程在单用户单线程下没问题但多人同时操作时就会产生并发问题——两个人同时查到库存为10各自都判断够用然后都去执行出库8个最后库存变成2而不是变成-6或者6这就出现了超卖。在库存系统里超卖意味着医院实际物资和系统记录不一致这是不能接受的。解决方案有两种。第一种是乐观锁在material_info表加一个version字段更新时UPDATE material_info SET stock stock - #{num}, version version 1 WHERE id #{id} AND version #{oldVersion}如果影响行数为0就说明数据被改了需要重新查询并提示用户。第二种是直接更新时加条件stock #{num}MyBatis-Plus里写自定义SQL即可。我实际更推荐第二种逻辑更直白扣减库存的SQL语句里带上库存充足条件数据库层面保证不会把库存扣成负数。这两种方案都比把Service方法加synchronized靠谱因为多实例部署时synchronized只能锁单机。出库单号我生成的规则是前缀CK加年月日加四位流水比如CK202501120013。这种编号不仅好看在后续按单号检索时也方便。生成编号时要加并发控制我简单用UUID做备用但可读性差如果你想让编号更专业可以建一张编号表用数据库的REPLACE INTO方式生成唯一序号。事务控制方面出库单主表插入、明细表批量插入、库存扣减、操作日志写入这四个操作必须在一个事务方法里。SpringBoot里Transactional默认只回滚运行时异常如果你在代码里catch了异常然后又抛出也要注意事务是否会失效。3. Web端界面与交互实现3.1 前端方案的取舍服务端渲染还是前后端分离Web版系统的前端怎么做我自己的经验是除非你对Vue、Node、Nginx这一套非常熟否则不要轻易引入一个完整的前后端分离架构。毕设项目要把更多精力留给业务和后端前端用SpringBoot默认集成的Thymeleaf模板引擎就够用。Thymeleaf的好处是Java后端可以直接通过ModelAndView带数据渲染页面不用额外做跨域、不用单独部署前端静态资源打包后就是一个jar包运行起来就能访问。但如果你已经会Vue或者为了给答辩加分想展示前后端分离这种现代Web开发方式那我也说下怎么整合。用Vue3或Vue2写页面build之后会生成dist目录里面有static资源和一个index.html。把static资源复制到SpringBoot的src/main/resources/static目录把index.html放到templates目录下然后在pom.xml里添加对Vue路由的支持——关键是配置一个转发规则让SpringBoot把除接口以外的路径转发到index.html。这个操作在热词里也经常被搜到很多人卡在这一步核心就是重写WebMvcConfigurer实现addViewControllers把多个路径映射到forward:/index.html。我在这套系统里采用了比较折中的方案核心页面物资台账、出入库、库存预警用Thymeleaf配合服务端渲染另外用原生JavaScript和AJAX调接口动态刷新局部数据。这样做的好处是页面首屏速度快、不用担心SEO、也不需要在SpringBoot里面捣鼓前端router。如果你想在履历里写熟悉Vue建议还是单独做一个简单的Vue管理后台但把接口预留好这种经验更值钱。3.2 核心页面设计与操作流程页面设计不需要特别花哨关键是信息结构清晰。登录页就不说了系统主界面左侧是菜单栏右侧是内容区。我用的是layout片段模板把侧边栏、顶栏、页脚抽成公共fragment维护起来很方便。物资台账页面必须有一个多条件查询区物资名称、分类、库存状态、有效期状态下面用表格展示物资编码、名称、批次、库存、上下限、状态。表格支持分页这里要注意SpringBoot集成PageHelper很成熟但如果你用MyBatis-Plus可以用它的Page对象配合IPageT接口不需要额外引入PageHelper了。入库页面我设计的是主单明细的结构上半部分是供应商、入库类型、入库日期、经手人下半部分是物资明细列表。点击添加物资按钮弹出一个物资选择弹窗支持按编码或名称搜索选择后自动带入该物资的默认信息只需要填数量和批次号。出库页面类似区别是出库时要关联领用科室并且必须在明细里实时校验可出库库存是否充足。我在出库明细行上做了一个输入框用户填入数量后前端立刻调用接口查询该物资当前库存如果不足就红字提示并且禁止提交。这个细节在验收时非常加分老师会认为你真的在考虑实际业务。库存预警页面用来展示两类物资低于库存下限的和即将过期的。低于下限的用黄色高亮过期的用红色高亮。这个页面用一个SQL查询就能搞定material_info表里加上stock_low_limit和expiry_date字段查出来再判断。我是做了一个定时任务Scheduled每天凌晨执行扫描所有物资的有效期生成待办提醒存到一张notice表里用户登录后右上角弹出提醒数字。这种主动提醒的机制让系统不再只是被动的记录工具而是真的能辅助管理人员做决策。3.3 Web页面PDF打印、搜索排序等实用功能集成毕设项目如果能集成一些看起来不难但很实用的功能整体观感会提升一个档次。热词里提到web页面pdf打印这在医院物资管理里的实际场景是要打印入库单、出库单、盘点表然后签字存档。我用的方案是浏览器自带的window.print()配合CSS打印样式不需要额外引入PDF库。做法是给打印区域加一个idprintArea打印前把不需要的内容隐藏掉使用media print样式设置页面边距和字体大小。如果你非要生成真正的PDF文件可以在后端用OpenPDF或iText操作PDF模板然后填充数据。但从成本和易用性来看浏览器打印足够覆盖毕设场景。搜索排序方面主要是在物资台账和出入库明细页做。物资台账默认按物资编码升序前端可以根据用户点击表头切换排序字段。搜索框我做了模糊匹配支持编码、名称、规格三个字段。这里要注意SQL注入MyBatis-Plus的like方法会自动转义但如果你用自定义SQL写LIKE CONCAT(%, #{keyword}, %)只要用#{}而不是${}就没有问题。另外在医疗物资导航中科室领用记录经常要按月统计我用MySQL的DATE_FORMAT函数对出库日期做了分组按月份统计出库量。排序功能别做太复杂能解释清楚原理面试官基本不会揪着不放。4. 部署发布与常见问题排查4.1 将Web项目打包部署到服务器毕设验收通常要求能现场运行最稳妥的方式是把SpringBoot项目打包成可执行的jar包在服务器或本机安装JDK和MySQL后直接启动。步骤很简单在项目的根目录执行mvn clean package -DskipTests生成的jar包在target目录里。然后在服务器上执行java -jar medical-material-system.jar如果是在本机运行默认端口8080启动完成后访问http://localhost:8080即可。但这里有几个坑我必须提醒。一是打包时如果使用SpringBoot内置的Tomcat一定不要引入外部的javax.servlet-api依赖否则打包后启动会报NoClassDefFoundError。二是数据库连接信息不要写死在application.yml里用环境变量或外部配置文件的方式比如java -jar app.jar --spring.profiles.activeprod这样到不同环境部署就不用改代码重新打包。三是如果你的服务器上已经有其他项目占用了8080端口可以在启动命令后加--server.port8081或者在application.yml里修改配置。热词里提到springboot版本太高很多人在用较新的SpringBoot3时如果依赖的MyBatis-Plus还是旧版本会因为javax与jakarta命名空间不一致导致启动失败。解决办法是统一升级到适配SpringBoot3的依赖版本比如使用mybatis-plus-spring-boot3-starter。4.2 常见异常与解决方案速查我把实际操作中遇到过的问题列成一个速查表方便大家复制粘贴直接排查。现象可能原因解决方案启动时端口占用本机已有其他服务占用8080修改server.port或杀掉占用进程中文乱码数据库字符集不是utf8mb4或JDBC连接未指定编码建库时使用utf8mb4URL后加useUnicodetruecharacterEncodingutf8库存出现负数并发扣减未加条件update语句加stock #{num}条件访问静态资源404前端资源未放在正确目录资源放static或public目录controller不要覆盖映射事务不回滚在方法内catch了RuntimeException不抛出或配置类没加EnableTransactionManagement异常抛出不要catch后吞掉确认注解生效启动报ClassNotFoundException引入包使用了不同命名空间检查SpringBoot版本与依赖是否匹配javax与jakarta不能混用跨域问题前后端分离部署且未配置CORS重写addCorsMappings或部署时用Nginx同源代理上面这些坑基本覆盖了毕设项目90%的启动和运行问题。还有一个很隐蔽的问题MyBatis-Plus的字段自动填充功能如果在插入数据时没有指定create_time字段数据库会自动填充当前时间但从数据库查询时发现时间差8个小时。这是因为服务器时间时区与MySQL时区不一致解决方案是在JDBC连接串上加serverTimezoneAsia/Shanghai。类似这种细节做完一个项目记录下来答辩或者面试时都是很好的实战素材。4.3 答辩前必看的亮点整理与演示路径毕设答辩和写代码是两个能力有些系统做得不错但演示时没有逻辑老师看完觉得平淡。我在演示这套医疗物资管理系统时会固定走一条最有戏的路径先登录系统打开物资台账页面指出某一种物资库存低于下限页面有预警提示然后创建一张出库单选择该物资提交时故意填一个大于库存的数量系统提示库存不足剩余xx件再改成合法数量提交库存数量和台账页立即发生变化最后打开出入库流水页面展示刚才的操作记录和操作人。这条路径展示了预警、异常校验、事务处理、数据一致性四个亮点老师看到的不是一个CRUD系统而是一个有完整闭环的业务系统。技术上要重点解释的两个点是库存扣减时如何防止超卖以及出库单主副表的数据如何保持一致性。回答超卖问题时可以提使用数据库条件更新替代先查后改回答一致性时可以提通过Transactional保证同一事务内完成所有写操作。如果老师问到权限控制说明自己用的是Spring Security或者自定义拦截器按角色区分菜单和数据权限即可。不必说得太深但一定要把为什么这么设计讲清楚。5. 给后来者的操作建议与经验笔记这套系统做下来最花时间的不是代码而是理解业务。我一开始也走了弯路把精力全部扑在界面上结果后端数据模型一塌糊涂。后来我重建了数据表重新梳理了物资、批次、库存、流水四者之间的关系项目才真正立得住。给后来者一个建议先不要急着打开IDE写代码拿一张纸把供应商-入库-库存-出库-科室这条链走一遍标注每一步需要哪些数据字段想清楚了再动工后面会顺很多。另外一个体会是医疗物资管理系统和普通商城系统的最大区别在于它很看重权限审计和批次追溯。谁在什么时间、经手哪笔出入库、涉及哪个批次的物资这些信息在审计时非常重要。所以我在设计时把操作日志独立成表记录操作人、操作类型、业务单号、操作时间并且在业务表里都保留创建人、创建时间、更新人、更新时间这些字段。虽然会增加一些编码工作量但这些细节恰恰是区分课程设计和毕业设计的地方。最后分享一个小技巧在开发过程中我会经常使用Slf4j在每个关键业务方法里记录日志比如出库单生成时打印入参和库存变化结果。这些日志在调试时帮了大忙尤其是排查为什么库存对不上这种问题只要看日志里每个操作前后的库存值就能快速定位是哪一笔数据出了问题。希望这篇分享能帮到正在做这个题目的你。