Huigr王带毕业设计这几年，我见过太多“看着什么功能都有、实际上什么业务都没跑通”的项目。这套基于 springboot+Java 的医药管理系统，属于典型的中型业务系统：前端后端、权限控制、库存流转、单据报表、异常处理它全都沾边。说它是计算机毕业设计里的“六边形题目”一点不过分，但也正因为覆盖的知识点多，很多同学上手就蒙，最后把代码跑起来就算完工，答辩一追问业务逻辑就卡壳。
这篇文章我会把整套系统的核心设计思路、模块拆分、关键技术实现和实操踩坑从头捋一遍。如果你正在做这个题目，或者想用 springboot 做一套药品进销存项目当 Java 面试的项目经验，可以直接拿我的做法当底稿。全文不讲虚的，直接给结论和能落地的方案。
1. 为什么是“基于springboot+Java的医药管理系统”
1.1 选题逻辑：这个题目到底在考什么
很多人选毕设题目时有个误区，觉得越偏门越容易过，结果网上资料少得可怜，连报错都搜不到解决方案。医药管理系统不一样，它有明确的管理对象，也就是药品的进销存和处方流转，数据关系清楚，角色边界分明。
这个题目的核心考点是传统的业务 CRUD 能力和工程化落地能力。你写一个单表增删改查，那叫练习；你把用户、角色、菜单、药品分类、供应商、采购单、入库单、出库单、库存预警、销售记录这些模块串成一条完整链路，并且用 springboot 的标准分层架构优雅地组织起来，这就叫系统设计。导师和评审老师看重的不是你会不会背框架，而是你能不能把一个模糊的需求拆成表结构和接口。
另外，“医药”这个业务背景天然带合规属性，比如处方药流程、批量号、有效期管理、库存上下限。这些约束让系统不至于沦为空壳，也给你的论文增加了业务分析素材。说白了，一个会讲业务场景的毕设，比一个只会上拉下拉页面的项目高一个档次。
1.2 适合谁做和核心功能定位
如果你是以下三类人，这套基于 springboot 的实现思路可以直接参考：第一类是计算机相关专业做毕业设计的本科生；第二类是准备跳槽或找实习、需要一个完整 springboot 项目经验的 Java 后端新人；第三类是培训机构的项目课老师，需要一个能适配教学节奏的案例。
核心功能定位不用贪多，按业务重要度排序，六个模块足够撑起整套系统：
- 用户与权限管理：登录、角色分配、菜单权限，管理员、药师、采购员分权操作。
- 药品基础信息管理：药品名称、通用名、规格、生产厂家、批准文号、有效期、储存条件。
- 供应商管理：供应商档案、资质信息、联系方式、合作状态。
- 采购与入库：采购订单生成、验收入库、入库单回写库存。
- 库存管理：库存查询、库存预警、出库/销售扣减、报损报溢。
- 统计报表：进出库流水、库存总额、药品销售排行、效期预警。
这些模块听起来多，但数据模型是收敛的。最核心的表其实就五到六张，其他都是辅助扩展。真正花时间的是把库存流转的规则想清楚，比如“入库单审核后库存增加，退货单审核后库存减少，报损单审核后库存冻结再扣减”，这一套逻辑在论文里能写出至少三页纸。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与整体设计拆解
2.1 springboot + Java 的组合为什么稳妥
springboot 在这几年已经成了 Java 后端开发的默认起点，原因不是它“比 SSM 高级”，而是它把配置的复杂度降下来了。以前用 SSH 或者 SSM 搭环境，光 XML 配置文件就能写半天，现在 springboot 靠自动配置和内嵌 Tomcat，一个 main 方法就能起服务。毕设答辩现场最怕环境崩，springboot 至少降低了 50% 的现场翻车概率。
Java 本身在业务系统里的优势是稳定性强、生态完整。集合框架处理批量数据非常顺手，比如药品库存盘点时候的按批号分组，用 HashMap 或 Stream 分组器轻松搞定；面对对象的设计思路让实体类和业务对象一一对应，写作代码的时候人脑和代码能对得上。很多人 Java 面试被卡在集合和线程池，但做这个项目你会反复用到 List、Map、Stream，等于把基础语法真正用活了。
2.2 分层架构和项目结构怎么组织
毕设项目不需要上微服务，单体应用加清晰分层就是最优解。controller 负责接收参数、service 负责业务逻辑、mapper 负责数据库操作，这三层足够应对医药管理系统的全部需求。我的习惯是再加一个 common 包放统一返回结果、异常处理、工具类，一个 config 包放配置类，这样分工边界很清楚。
拿我的项目结构举例：
code复制com.pharma
├── controller // 前端接口入口，只做参数接收和结果封装
├── service // 业务逻辑层，事务控制在这里
├── mapper // MyBatis 接口，SQL 写在 XML 或注解里
├── entity // 数据库表对应的实体类
├── dto // 接口传参对象，避免直接暴露实体
├── vo // 返回给前端的数据对象
├── common // 统一结果类、异常类、常量
├── config // 跨域、拦截器、分页插件配置
├── utils // 日期处理、Excel 导入导出工具
这里有个容易忽略的点：实体类和 VO 类一定要分开。很多同学图省事直接把实体返回给前端，短期看没问题，但药品实体里如果有库存成本字段，直接暴露给前端非常危险。用 VO 做数据隔离，一是安全，二是接口返回字段可控，三是后期加需求不用改数据表结构。
2.3 数据库设计的三个关键决策
数据库这块我建议 MySQL 8.x，字符集统一 utf8mb4，排序规则 utf8mb4_general_ci，不然存个特殊符号就乱码。核心表的设计有三个决策直接决定系统能不能跑顺。
第一个是药品库存表要不要冗余药品信息。我的做法是药品主表存固定属性，库存表存批次、数量、入库单价、生产日期、有效期。为什么这么设计？因为同一款药品可能来两批货，批号不同、效期不同、进价不同。如果只存药品表，做效期管理和先进先出就无从谈起。评审老师看到你按批号管理库存，会认为你有真实业务意识。
第二个是单据编号怎么生成。采购单、入库单、出库单都要有业务流水号，格式类似 RK202501150001，由日期加当天序号组成。这个号不要用自增 ID，自增 ID 容易暴露业务量，而且不符合单据号规范。我的实现是写一个订单号生成工具，根据日期查当天已有单据数量加一，用 synchronized 控制并发重复。
第三个是逻辑删除。药品档案、供应商档案都不要物理删除，加一个 deleted 字段标记即可。原因很简单，历史单据要追溯，你把供应商删了，采购单上的供应商 ID 就成死链了。我见过不少毕设在这里用物理删除，答辩演示时候删一条药品数据，关联的历史记录全乱，当场尴尬。
3. 核心功能实现与实操过程
3.1 环境准备：Java 安装与 idea 创建 springboot 项目
先说环境，这里踩坑的人最多。JDK 建议直接用 JDK 8 或者 JDK 17，具体看你的 springboot 版本。springboot 2.x 用 JDK 8 最稳，springboot 3.x 必须 JDK 17 及以上。我推荐毕业生用 springboot 2.7 + JDK 8 的组合，网上资料最多，遇到问题随便一搜就是答案。
记得先把 JAVA_HOME 配置好。Windows 上安装 JDK 后，新建系统变量 JAVA_HOME，指向 JDK 安装目录，然后在 Path 里加 %JAVA_HOME%\bin。命令行输入 java -version 能正确输出版本才算配好。这一步看似基础，但每年都有一批同学卡在这，IDE 打不开、Maven 编译不了，基本都是环境变量没配好。
IDEA 创建 springboot 项目不需要手动建目录。File -> New -> Project -> Spring Initializr，选好 Java 版本和依赖：Spring Web、MyBatis、MySQL Driver、Lombok。如果你是前后端分离，再加上 Spring Security 或 JWT 相关依赖。这里建议不要勾选太多用不上的组件，依赖越多，启动越慢，报错越难排查。
3.2 登录鉴权与角色权限怎么落地
登录模块我推荐 JWT + Spring Security 或 JWT + 拦截器两种方案。如果对自己代码能力有信心，用拦截器方案就够，代码量少，逻辑直观；如果想给项目加分，就上 Spring Security，把过滤链和认证管理器写清楚，这能成为答辩时的一个亮点。
我这次用的是 JWT 拦截器方案。登录成功后用 userId、用户名、角色 code 生成 token，前端每次请求把 token 放在 header 里，后端写一个拦截器统一校验。角色权限不是细粒度到每个按钮，而是控制到菜单和接口层级：管理员可以访问所有接口，药师只能访问药品查询和处方相关接口，采购员只能访问供应商和采购模块。
这里给大家一个后端接口权限控制的简单实现思路：在拦截器里先从 token 里取出角色 code，然后校验请求的 URI 是否包含该角色允许访问的前缀。比如 /api/purchase/** 只允许 PURCHASE_ADMIN 和 ADMIN 两个角色通过。权限够用，代码也就三十行。
3.3 药品录入与库存预警的实现细节
药品信息录入要把表单校验做扎实。生产日期不能晚于当前日期，有效期截至日期必须晚于生产日期，批准文号要符合格式，计量单位用下拉框限定而不是手填。前端校验只是第一道坎，后端也要做一遍校验，因为接口可以被直接调用。很多毕设系统就是栽在“前端做了校验，后端裸奔”这个问题上。
库存预警算法不难，关键是触发条件要定义清楚。药品表里加一个 stock_upper_limit 和 stock_lower_limit，库存表里用当前总库存和最低库存比较，低于最低则标记预警。查询的时候用一个 SQL case when 判断当前库存和上下限的关系，返回状态字段：充足、预警、超储。
我写得比较细的一个地方是入库时自动更新预警状态。入库完成后重新计算该药品的库存总量，如果低于下限，系统自动生成一条预警记录存入预警表。这样可以做一个独立的预警列表页，而不是每次都要全表扫描算一遍。预警记录表可以设计为药品 ID、当前库存、下限值、创建时间、处理状态五列，非常清晰。
3.4 mybatis 分页插件的接入与踩坑
列表页面基本都要分页。MyBatis 的分页插件 PageHelper 用得最多，但在 springboot 里接入需要注意版本匹配。我用的 springboot 2.7，PageHelper 选 5.3.x 对应 mybatis-spring-boot-starter 2.2 左右。很多人直接引入最新版，结果和 Spring Boot 3 冲突，一启动就报错。
接入方式很固定：先在 application.yml 里配 pagehelper.helper-dialect=mysql、reasonable=true、support-methods-arguments=true，然后在 service 层查询前写 PageHelper.startPage(pageNum, pageSize)，后面紧跟一条 Mapper 查询语句，分页就生效了。注意 startPage 只对紧接着的第一条 SQL 生效，不要在它前面干别的查询。
我踩过的坑主要是两个：第一个是分页插件和 MyBatis 二级缓存同时开启时，统计查询会异常；第二个是在循环里调用分页查询，每次都忘了 reset，导致后面几条 SQL 全部被套上分页条件。解决办法很简单，循环内每PageHelper 查询前都重新 startPage，或者把查询提取到循环外统一处理。
3.5 报表导出与单据打印怎么实现
医药系统离不开库存报表和进销存统计。有一个常见需求是导出 Excel 或在页面上打印入库单。导出 Excel 我用的方法是 Apache POI，配合一个通用导出工具类，把列名、数据列表传进去，几秒钟生成 xlsx 文件。这个工具类不需要多复杂，一百行代码搞定，但非常实用。
如果导师要求图表报表，可以在 springboot 后端把统计数据查出来封装成 JSON，前端用 ECharts 渲染折线图或饼图。药品销售排行用柱状图，近六个月库存变化用折线图，供应商采购金额占比用饼图，这三类图足够应付毕业设计。
有人问 java poi 能不能在 Word 里生成图表，答案是能，POI 的 XWPFChart 支持插入图表，但格式控制比较繁琐，数据处理和样式不如图表库灵活。我更建议把统计图表放到前端渲染，后端只提供数据接口，这样职责清晰，工作量也小。如果你的系统里还接了报表服务器做复杂打印模板，那另说，常规毕设没必要上那么重。
4. 常见问题排查与避坑实录
4.1 “java: 警告: 源发行版 17 需要目标发行版 17”怎么处理
这大概是 java 入门阶段被问烂的问题，但仍然是毕业设计季永恒的热搜。出现这个警告的原因是 IDEA 里项目的编译级别和 JDK 版本不匹配，比如你装了 JDK 17，但 IDEA 的 Project Structure 里 Project SDK 配错了，或者 Maven 的 compiler 插件指定了旧版本。
处理方式两步：第一步，打开 File -> Project Structure -> Project，把 SDK 改成你本机装的 JDK 版本；第二步，检查 pom.xml 里 maven-compiler-plugin 的 source 和 target 是否和 JDK 一致。如果是 JDK 17 就写 17，如果是 JDK 8 就写 8。改完重新 mvn clean compile，警告自然消失。这个警告本身不影响程序运行，但答辩时被问住很丢分，最好提前处理掉。
4.2 全局过滤器处理上传 PDF 时的 XSS 问题
做管理系统一定会做 XSS 过滤，但如果你写一个全局过滤器拦截所有请求，并且对参数做转义，那就掉坑里了。我实际遇到的情况是：上传 PDF 文件时，过滤器把二进制流也当字符串处理，结果 PDF 文件被污染，上传到服务器后打不开。
解决办法是过滤器要做内容类型判断。PDF 的 Content-Type 是 application/pdf，二进制流数据不应该走字符串转义逻辑。更稳妥的做法是：只在处理 JSON 请求体或表单文本参数时做 XSS 清洗，遇到文件上传就走白名单直接放行。可以维护一个多媒体类型列表，只要 Content-Type 不在列表里，就不做任何修改。这个坑在毕设演示里很容易踩到，因为你可能提前测试没发现，现场演示上传处方单 PDF 时当场打不开。
4.3 mybatis 分页查询不生效或者查出来的数据不对
分页不生效最常见的原因有两个。第一个是 PageHelper.startPage 后没有紧跟查询语句，中间隔了其他 SQL 或非 Mapper 操作，导致分页参数没有绑定到目标查询上。第二个是 PageHelper 的依赖和 MyBatis 版本冲突，启动时不报错，但分页时拦截器没有执行。
排查思路是先看控制台输出的 SQL 里有没有 LIMIT ?，没有就是插件没生效。再看 PageInfo 的总记录数对不对，如果总数一直是 -1，说明 count SQL 没有执行成功，通常是插件配置里的 count 属性被改了。我建议直接用 PageInfo 包装返回值，统一用它的 total、list、pageNum、pageSize 四个字段给前端，不要自己手动组装分页结果。
还有一些同学分页数据对不上，原因是排序字段写死了。如果查询里有 order by id，但数据表的主键不是 id，排序就乱了，分页看起来像“重复数据”。建议排序条件用时间字段或真实主键，保证分页间的数据不重叠。
4.4 前后端联调时的跨域和鉴权问题
用 springboot 做后端、Vue 做前端的时候，跨域问题绕不开。后端启动在 8080，前端在 5173 或 8081，端口不同就是跨域。最简单的方式是后端写一个 CORS 配置类，允许指定前端地址访问。千万别用 allowCredentials 配 * 的写法，那是安全隐患。我一般把 origin 配成具体域名或本地地址，比如 http://localhost:8081。
鉴权方面的联调问题更隐蔽。很多同学把 token 记在 localStorage 里，但没有封装 axios 拦截器，导致每个请求都要手写 header，非常容易漏。建议统一封装一个 request.js 工具，在请求拦截器里统一从 localStorage 取出 token，塞到 header 里，响应拦截器里统一处理 401 状态跳转到登录页。这样后续所有接口只管传业务参数，不用关心鉴权细节。
4.5 关于“把 jar 包反编译成项目”的学习提醒
每年都有人问能不能把别人的 springboot jar 反编译成完整项目改一改直接交。技术上确实有工具可以反编译 class 文件，比如一些 Java 反编译工具能在 IDEA 里查看反编译源码。但我得泼一盆冷水：反编译拿到的代码没有注释、没有资源文件、没有原来的目录结构，而且很多商业项目做了混淆，你拿到也是一堆读不懂的类名。
毕设的核心是过程，不是产物。你可以参考别人项目的数据表设计和思路，但代码必须自己写一遍。哪怕写得丑点，你能讲清楚每个方法在干什么，答辩就稳了。直接把反编译代码交上去，导师一问“你这行的业务含义是什么”，当场就露馅。我见过太多学生在这个坑里翻车，真的不值得。
5. 让答辩和交付更有分量的实用打法
5.1 演示路径怎么设计才不容易翻车
答辩演示不是把系统全部功能点一遍，而是讲一条主线业务流。我建议按“管理员创建账号 -> 分配角色权限 -> 采购员新增供应商 -> 创建采购单 -> 入库审核 -> 库存增加 -> 药师销售出库 -> 库存减少 -> 触发预警 -> 管理员查看统计报表”这条链路走一遍。
这条链路能把权限、采购、库存、销售、预警、报表六个核心模块全部串起来，而且逻辑通顺，评委跟着你的思路走，不容易问碎问题。演示时要注意提前准备几条测试数据，不要现场临时录入，避免手滑选错日期或者输入非法字符。数据库里先造好三个角色的账号和一组完整的业务数据，演示前把页面刷新干净。
5.2 毕业论文和文档怎么写得有深度
文档这块不要抄模板。常见的问题是“系统功能概述”写得像需求说明书，“系统设计”直接甩几张表结构图。我认为最有效的写法是：每个模块先讲业务痛点，再讲表怎么设计解决这个痛点，最后讲代码里怎么实现。
以库存预警为例，文档流程可以写：药品库存存在过期风险；因此在药品表设计效期字段；在库存表设计批号和数量；在入库时校验效期并更新库存；在查询时判断库存是否低于下限；低于下限生成预警记录；管理员看到预警后生成采购单。这样一段流程写下来，业务、数据、实现全部闭环，评委想看细节也有东西可看。
5.3 代码层面还能加哪些亮点
如果时间充裕，我建议加三个低成本但高回报的亮点。第一个是全局异常处理，用 @RestControllerAdvice 统一处理业务异常和参数校验异常，接口返回格式保持稳定。第二个是操作日志记录，简单写一个注解，拦截方法记录操作人、操作时间、操作内容。第三个是导出 PDF 采购单的功能，用模板填充数据，效果比 Excel 更直观，也贴近医药场景的纸质归档需求。
这三个功能单独拎出来都不复杂，每个也就一两百行代码，但放在毕设项目里一下子就能撑起“非教学 demo”的体量。答辩时你可以主动说：“系统不止做了 CRUD，还做了操作留痕和异常兜底”，这比被动回答问题要加分得多。
我自己每年带这么多项目，最深的体会是：毕设系统能不能拿到高分，关键不在用没用最新的技术，而在逻辑是不是自洽、代码是不是规范、答辩能不能讲清楚。医药管理系统这套题只要把库存流转、权限控制、预警闭环这三条主线做明白，无论是用于毕业拿学位，还是后续在面试时讲成一个有条理的 Java 项目案例，都足够打透。最后提一个小建议，趁做项目期间把过程中踩过的坑记录下来，比如 PageHelper 的分页失效、XSS 过滤器误伤 PDF、跨域配置，这些在面试时是极具说服力的真实经历，比背一百道 java 面试八股文都有用。