SpringBoot+SSM实战：中药材店铺管理系统设计与实现

最近几年，JavaWeb方向的项目需求基本被两类东西承包了：一类是各种“管理系统”，另一类还是各种“管理系统”。而中药材店铺管理系统，算是这类项目里比较有代表性的一个。它表面上是一个进货、卖货、管库存的进销存系统，实际却把权限管理、商品管理、订单流程、统计报表这些JavaWeb的核心知识点全串起来了，所以不管是Java课程设计、毕业设计，还是想练手SpringBoot+SSM整合的同学，这个题目都挺值得细看的。

这篇博文就围绕这个项目标题展开，从需求拆解、技术选型、数据库设计、核心功能实现，到本地部署和常见坑位，一条线讲清楚。内容来源于我做同类项目时的实践经验，代码风格和实现细节会偏“课设/毕设能用、能跑、能讲明白”的方向，适合直接拿来参考。

1. 项目整体拆解：中药材店铺管理系统到底在管什么

1.1 核心需求分析

把项目标题里的几个词拆开看，“中药材店铺管理系统”本质上是一个面向中小型中药材门店的进销存平台。它要解决的核心问题不是“药怎么种”，而是“店怎么管”。

中药材门店和普通超市、便利店比，有几个很不一样的地方：

• 药材种类杂，规格多。同一种药材可能有不同产地、不同等级、不同炮制规格，比如黄芪就有生黄芪、炙黄芪之分，价格差得还不少。
• 库存有保质期和存储要求。药材怕潮、怕虫、怕串味，库存周转和有效期管理比普通商品更敏感。
• 进销存流程链条长。从供应商采购、入库验收、门店销售到库存盘点，每一步都要留痕。
• 日常经营需要看数据。哪些药材卖得快、哪些压在库里半年没动、这个月毛利是多少，老板都得心里有数。

所以一套完整的中药材店铺管理系统，至少要覆盖用户登录、员工权限、药材信息管理、分类管理、供应商管理、采购入库、销售出库、库存预警、统计报表、操作日志这几个模块。模块之间不是孤立的，而是通过订单和库存两条主线串联：采购单影响入库和库存增加，销售单影响库存减少和营业额累计。

从代码层面看，这个项目走的是典型的“表现层-业务层-数据层”三层结构。前端页面发起请求，Controller接收参数，Service层处理业务逻辑，Mapper层和数据库打交道。这种结构在课程设计和实际企业项目里都是主流，逻辑清楚，也好答辩。

1.2 适合谁来做、用来干什么

这类项目最大的价值，是它把JavaWeb开发里最常用的一整套技术栈实打实地串了一遍。如果你正处在下面这几个阶段，这个项目是很好的练手对象：

• 正在准备Java课程设计或毕业设计，需要一个能写、能跑、能讲的完整项目。
• Java基础已经学完，但不知道SSM框架到底怎么配合工作，想通过一个实际项目把Spring、SpringMVC、MyBatis的关系彻底搞懂。
• 想快速体验SpringBoot的开发效率，同时又想保留SSM的分层思路，做一个不算太复杂但五脏俱全的Web应用。
• 后续想找工作，简历上缺一个能拿得出手、能讲清楚业务和数据表关系的项目。

有一点要说清楚：这个项目的难点不在于某个单一技术有多深，而在于“整合”和“闭环”。SpringBoot负责自动装配，SpringMVC负责请求分发，MyBatis负责数据库操作，三者怎么无缝衔接；前端表单提交的数据怎么经过校验、业务处理最终落库；一张销售单产生后，库存是怎么被扣减的——把这条链路跑通，你对JavaWeb的理解会上一个台阶。

2. 技术栈选型的实际考量与数据库设计

2.1 为什么是SpringBoot + SSM这套组合

很多初学者会有一个疑问：SSM指的是Spring + SpringMVC + MyBatis，而SpringBoot本身是用来简化Spring配置的，这两个说法是不是冲突？

其实不冲突。SpringBoot并没有替代SpringMVC和MyBatis，它做的是把以前需要大量XML配置的Spring生态“自动配置化”。你现在用SpringBoot建一个Web项目，底层依然是Spring IOC和SpringMVC那套请求处理机制，数据层依然可以用MyBatis来写SQL。所以“SpringBoot + SSM”这个说法，准确理解是：用SpringBoot作为项目的基础框架和启动入口，整合SpringMVC作为Web层，整合MyBatis作为持久层。

这么选最大的好处是两个字：省事。以前搞一个SSM项目，要手工配web.xml、Spring配置文件、SpringMVC配置文件、MyBatis配置文件，还有各种包扫描、视图解析器、数据源，配置半天才能跑一个HelloWorld。SpringBoot把这些默认配置都帮你准备好了，你只需要在application.yml里写数据库连接信息，再在启动类上标注@SpringBootApplication，项目就能起来。

对中药材店铺管理系统这种业务型项目来说，SpringBoot的价值还不只是开发爽，更重要的是部署调试方便。项目内置Tomcat，本地调试不需要单独装Tomcat再丢war包，直接运行main方法就能看到效果。这在做课设和答辩演示时特别占优势——现场出问题概率降低一个档次。

2.2 数据库设计：数据表到底该怎么建

数据表设计是这种管理系统的灵魂。表建得好，后面写业务代码就是一把梭；表建得乱，业务逻辑写起来全是补丁。

中药材店铺管理系统我建议至少建这几张表：

这里有个很关键的设计思路：采购和销售都拆成主表 + 明细表两张表。为什么要拆？因为一张采购单里通常有多种药材，如果只建一张表，每种药材一条记录，还要重复存储采购单号、供应商、总金额这些信息，数据冗余，而且修改其中一部分会很痛苦。拆成主表和明细表后，主表存“这次采购是谁家的、总共多少钱”，明细表存“具体买了哪几味药、各多少钱”，通过外键关联，符合第三范式的思路。

库存预警阈值warning_stock这个字段也要单独说。它不是一个固定值，而是每种药材根据自己的销售速度、采购周期单独设置。比如黄芪这种卖得快的，阈值设高一点比如50公斤；有些冷门药材设5公斤就够了。在查询药材列表时，用stock <= warning_stock就能把需要补货的药材筛出来。

3. 核心功能实现与关键代码解读

3.1 用户登录与权限拦截是怎么做的

管理系统的第一道关卡是登录认证。这个项目的用户表里有role字段，用来区分管理员和普通员工。管理员的权限包括用户管理、供应商管理、采购入库这些；普通员工主要负责销售开单和库存查询。

登录的核心逻辑不复杂：前端提交用户名和密码，Controller调Service查询用户表，比对密码是否一致，一致就把用户信息放进Session，然后跳转到首页。密码这块要注意，不能明文存数据库，建议用MD5加盐或者BCrypt加密存储，防止数据库泄露后密码被直接看到。

代码结构大致是这样的：

@Controller public class LoginController { @Autowired private UserService userService; @PostMapping("/login") public String login(String username, String password, HttpSession session, Model model) { User user = userService.login(username, MD5Util.md5(password)); if (user == null) { model.addAttribute("error", "用户名或密码错误"); return "login"; } session.setAttribute("loginUser", user); return "redirect:/index"; } @RequestMapping("/logout") public String logout(HttpSession session) { session.invalidate(); return "redirect:/login"; } }

登录之后的权限控制，这个项目用拦截器就能搞定，没必要上Spring Security这么重的框架。写一个LoginInterceptor，实现HandlerInterceptor接口，在preHandle方法里判断Session中是否有登录用户，没有就重定向到登录页。

public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); User user = (User) session.getAttribute("loginUser"); if (user == null) { response.sendRedirect("/login"); return false; } return true; } }

然后在SpringBoot的配置类里注册拦截器，并配置排除路径，比如登录接口、静态资源不拦截。

@Configuration public class WebConfig implements WebMvcConfigurer { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns("/**") .excludePathPatterns("/login", "/css/**", "/js/**", "/images/**"); } }

如果还要区分管理员和普通员工的操作范围，可以再写一个AdminInterceptor，专门拦截那些只有管理员能访问的URL，比如用户管理、供应商管理这些。这种做法在答辩时也比较好讲：先做登录认证，再做功能授权，两层控制思路清晰。

3.2 库存管理：入库、出库与预警阈值的计算逻辑

库存是整个系统的核心资产，入库和出库逻辑如果写不好，库存数据就会变成一团乱账。这个项目的库存变动建议统一走stock_log流水表，而不是散落在一段段零散的update语句里。

先看采购入库。采购员录入一张采购单，勾选几种药材，填上数量和采购单价，提交后系统要做两件事：第一，往purchase_order和purchase_item里插入采购单数据；第二，更新medicine表里对应药材的库存数量和最新采购价。

这里最简单的实现方式是：先插入主表拿到自增id，再遍历明细列表插入子表，同时更新库存。为了保证“采购单保存成功但库存没更新”这种情况不出错，整个操作要加@Transactional事务注解。一旦中间某一步失败，全部回滚，数据库不会留下半截数据。

@Transactional public void addPurchase(PurchaseOrder order, List<PurchaseItem> items) { purchaseOrderMapper.insert(order); for (PurchaseItem item : items) { item.setPurchaseId(order.getId()); purchaseItemMapper.insert(item); // 更新库存和流水 medicineMapper.increaseStock(item.getMedicineId(), item.getQuantity()); stockLogMapper.insert(new StockLog(item.getMedicineId(), "采购入库", item.getQuantity())); } }

销售出库的逻辑是镜像操作，但多了一个校验：卖出去的药，库存不能是负数。所以在销售提交时，要先查当前库存，判断库存是否充足，不足就直接抛出异常，提示“库存不足”。

public void addSale(SaleOrder order, List<SaleItem> items) { for (SaleItem item : items) { Medicine medicine = medicineMapper.findById(item.getMedicineId()); if (medicine.getStock() < item.getQuantity()) { throw new RuntimeException(medicine.getName() + " 库存不足，当前库存：" + medicine.getStock()); } } // 校验通过才开始插入销售单 saleOrderMapper.insert(order); for (SaleItem item : items) { item.setSaleId(order.getId()); saleItemMapper.insert(item); medicineMapper.decreaseStock(item.getMedicineId(), item.getQuantity()); stockLogMapper.insert(new StockLog(item.getMedicineId(), "销售出库", -item.getQuantity())); } }

库存预警的SQL也简单，查询的时候带上一个条件：

SELECT * FROM medicine WHERE stock <= warning_stock;

如果老板想看到底哪些药材要补货，可以在首页加一个“库存预警”列表，把stock <= warning_stock的药材按缺口从小到大排列，缺口就是warning_stock - stock。这个列表甚至可以做成醒目的红色高亮，方便店员一眼看到。

3.3 销售管理：订单创建与收银台交互

销售模块是整个系统里用户最常用、最影响体验的功能。现实中门店收银的场景是收银员扫一眼顾客拿的药材，在系统里搜索药材名称，加入订单列表，改数量，最后计算总价，收钱。

在Web页面实现这个流程，一般是这样一个交互：左侧是药材搜索框，输入关键词实时联查；中间是选中药材清单，包含单价、数量、小计；下方是总金额和结算按钮。前端用jQuery + Ajax就能做得比较顺手，不用上Vue这种重框架。

后端接收销售订单时，Controller里要处理两类数据：订单头信息和商品明细列表。前端通过Ajax提交一个JSON，结构大概是这样：

{ "payType": "现金", "items": [ { "medicineId": 1, "quantity": 2 }, { "medicineId": 3, "quantity": 1 } ] }

Controller接收时用一个SaleVO对象来承接：

@PostMapping("/sale/add") @ResponseBody public Result addSale(@RequestBody SaleVO saleVO, HttpSession session) { User loginUser = (User) session.getAttribute("loginUser"); SaleOrder order = new SaleOrder(); order.setUserId(loginUser.getId()); order.setPayType(saleVO.getPayType()); saleService.addSale(order, saleVO.getItems()); return Result.success(); }

注意这里要把当前登录用户也放到订单里，这样后续查销售记录时能追踪到是哪位店员卖的，做业绩统计和操作追溯都方便。

销售单号我习惯生成一个带日期和随机码的单号，比如“XS2025011516230001”，就是“XS + 年月日时分秒 + 随机四位”。这样有个好处：销售单号本身就有时间信息，不需要专门去查创建时间，打印小票时也直观。

3.4 统计报表：让数据会说话

管理系统如果不带统计功能，老板用几天就会觉得“这系统就是个电子台账，还不如我的Excel”。所以在报表这块，至少要提供三个维度的数据：

第一是销售趋势。按天统计最近一个月的销售额，可以画出柱状图或折线图，看门店的生意波动。SQL用DATE_FORMAT函数按天分组就能搞定：

SELECT DATE_FORMAT(create_time, '%Y-%m-%d') AS day, SUM(total_amount) AS amount FROM sale_order WHERE create_time >= #{startTime} GROUP BY day ORDER BY day;

第二是热销药材排行。统计每种药材卖了多少数量、贡献了多少销售额，看哪些是店里的顶梁柱。这个从sale_item里按medicine_id分组求和：

SELECT m.name, SUM(si.quantity) AS total_quantity, SUM(si.amount) AS total_amount FROM sale_item si LEFT JOIN medicine m ON si.medicine_id = m.id GROUP BY si.medicine_id ORDER BY total_quantity DESC LIMIT 10;

第三是库存周转情况。结合库存流水，看看哪些药材只进不出、压在库里占资金。我的做法是把近三个月没有销售记录但库存大于预警值的药材筛出来，单独做一个“滞销药材”列表。

图表展示方面，这个项目不需要接ECharts那样的大前端库，用简单的CSS柱状图或者引入一个轻量的Chart.js就够。答辩时能展示出一张能随日期变化的销售趋势图，已经比绝大多数同题目的作业要完整了。

4. 项目跑起来：环境准备与本地部署完整流程

4.1 环境清单与版本匹配

说句实话，这个系统一类的问题，十次里有七次是环境问题，不是代码问题。版本不匹配、依赖下载不下来、数据库字符集不对，都可能导致项目启动失败。所以先把环境版本定死。

我推荐的环境组合是这样的：

这里要提醒一句：如果你的SpringBoot版本是2.5，那就别再手贱把JDK换成11或者17，虽然SpringBoot 2.5官方说支持JDK8到JDK17，但实际开发中JDK8是最稳的。JDK版本过高反而容易出现一些奇怪的字节码兼容问题。

4.2 从源码到本地运行的完整步骤

拿到源码包之后，不管是从什么地方下载的，第一步一定是解压后先看目录结构。一个规范的项目压缩包应该包含这几部分：

project-root/ ├── src/ # 项目源代码 ├── sql/ # 数据库脚本文件 ├── README.md # 项目说明文档 ├── pom.xml # Maven配置 └── docs/ # LW（论文或说明文档）、调试文档等

然后按照下面这个顺序操作：

第一步，把项目导入IDEA。File -> New -> Project from Existing Sources，选择项目根目录，Maven会自动开始下载依赖。这个过程可能需要几分钟，取决于网速和Maven镜像配置。如果下载很慢，建议在settings.xml里配置阿里云镜像。

第二步，创建数据库。打开Navicat或者命令行工具，执行sql目录里的database.sql脚本。脚本里通常包含建库、建表和初始化数据。注意执行前看一眼脚本的创建库语句，确认数据库名称，比如叫db_herb_store，后面连接要用。

第三步，修改数据库连接配置。打开src/main/resources下的application.yml或application.properties文件，修改数据库的host、端口、用户名、密码：

spring: datasource: url: jdbc:mysql://localhost:3306/db_herb_store?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver

第四步，启动项目。运行启动类，通常在某个包下形如HerbStoreApplication的类，右键Run。看到“Tomcat started on port(s): 8080”日志就说明启动成功了。

第五步，浏览器访问。打开http://localhost:8080，使用初始化好的管理员账号登录。管理员账号密码一般在README或数据库脚本的注释里，常见的是admin/admin123。

4.3 调试文档和讲解视频应该怎么用

这个项目标题里带了“LW+调试文档+讲解”，这些附加资料的实际价值，很多人其实没有吃到位。

LW（论文/说明文档）的正确用法，不是照着抄，而是对照它理解系统设计思路。写毕业论文或课设报告时，重点看它的摘要、需求分析、数据库设计、系统测试这几个章节怎么写，因为这些东西老师最看重。代码实现相关的部分，反而可以当作参考，完全照搬反而容易被查重。

调试文档是用来救命的。它通常记录了项目运行过程中可能出现的典型问题，比如数据库连接失败怎么处理、端口被占用怎么解决、Maven依赖报红怎么处理。建议在启动项目前先把调试文档从头到尾扫一遍，大概知道哪些是常见坑，出了问题时按图索骥找答案，比自己上网乱搜高效得多。

讲解视频/讲解PPT的作用是帮助你在答辩时讲出逻辑来。很多人代码是自己写的，但被老师一问“这个表的字段为什么这样设计”就卡壳。视频里通常会把设计思路、核心功能流程讲一遍，把这块消化掉，答辩就很难被问倒。

5. 常见问题与排查技巧实录

5.1 启动报错的几个高频原因

做这个项目的人群主要集中在学生，我见过的问题里，启动阶段的高频bug基本固定，这里直接整理成一张速查表：

端口占用是最常遇到的。查看端口占用用一句话命令就能定位：

netstat -ano | findstr 8080

这会列出所有监听8080端口的进程，记下PID，然后：

taskkill /PID 这里写PID号 /F

如果项目用的JSP作为视图层，还要特别注意JSP文件的位置。SpringBoot对JSP的支持和传统war包项目不一样，JSP页面必须放在src/main/webapp/WEB-INF/views目录下，并且pom.xml里要有对应的依赖，否则会出现“Whitelabel Error Page”404。

5.2 功能异常排查与避坑经验

项目跑起来之后，接踵而来的就是各种功能层面的bug。有几个问题属于“没人提醒就一定会踩”的级别。

第一个是库存变负数。销售功能如果没有做库存校验，或者校验和扣减不在一个事务里，在高并发或快速点击的情况下，库存很容易被扣成负数。解决办法就是前面代码里写的，先循环校验库存再统一提交，同时整个方法加上事务。

第二个是新增药材时，分类下拉框没有绑定两级分类。如果分类表里有父子关系，但前端只查了顶级分类，二级分类的药材就显示不出来。解决方法是分类下拉框做联动：选中父分类后，Ajax查询子分类。

第三个是操作日志记录不完整。很多系统只做了登录日志，忘了记录用户的新增、修改、删除操作。一旦数据出问题想追溯是哪位员工改的，就无从下手。我的建议是做一个简单的AOP切面，拦截所有带有@Log注解的方法，自动记录操作人和操作内容：

@Aspect @Component public class OperateLogAspect { @Around("@annotation(operateLog)") public Object around(ProceedingJoinPoint point, OperateLog operateLog) throws Throwable { long startTime = System.currentTimeMillis(); Object result = point.proceed(); long costTime = System.currentTimeMillis() - startTime; // 从Session获取当前操作人 User loginUser = (User) RequestContextHolder.getRequestAttributes().getAttribute("loginUser", 0); operateLogService.save(new OperateLog(loginUser != null ? loginUser.getUsername() : "匿名", operateLog.value(), costTime + "ms")); return result; } }

第四个是Redis或JWT相关的内容，这类课设项目里大概率用不上。有些同学看到简历上的项目都写“基于SpringBoot+Redis+JWT实现无状态登录”，就把这个项目硬改成那样，结果画虎不成反类犬。中药材店铺管理系统就是传统Session会话最适合的应用场景，硬上JWT反而复杂化了，答辩时还容易露怯。技术选型要匹配业务，这点很重要。

还有一个容易被忽略的是分页查询。药材数量一多，不分页的话页面会卡。推荐用PageHelper插件，在pom.xml引入依赖，然后在Mapper查询前写一行：

PageHelper.startPage(pageNum, pageSize); List<Medicine> list = medicineMapper.selectByCondition(condition); PageInfo<Medicine> pageInfo = new PageInfo<>(list);

PageHelper的原理是通过MyBatis拦截器，在SQL执行前自动拼接LIMIT语句。它把分页参数自动追加到第一条查询语句上，所以PageHelper.startPage()这行代码必须紧跟查询语句，中间不能穿插其他SQL查询，否则会报“分页插件查询异常”或者分页失效。这个小细节很多人踩坑。

最后说点我自己的体会。做这种管理系统类的项目，最大的收获不是你背下来某个注解、某条SQL，而是建立了一种“从需求到落库”的整体思维：老板要什么功能，对应到哪张表、哪个接口、哪个页面；一条数据从产生到最后被统计，经过了哪些环节、在哪里有可能出错。这套思维方式，不管是继续做后端开发，还是干别的需要统筹规划的活儿，都通用。你在跑通这个项目的过程中每一次断点调试、每一回对着报错日志翻代码，都是实打实在积累经验。如果是在做课程设计或毕业设计，建议别把“跑起来”当终点，试着改动一两个小需求，比如给销售模块加个会员折扣、给库存预警接个邮件通知，你会发现自己对这套代码的理解又上了一个台阶。