SSM药房管理系统源码拆解：环境配置、数据库设计与避坑指南

简介：一套基于SSM框架的药房管理系统毕业设计项目，面向计算机相关专业学生以及需要SSM项目实战的Java开发者。项目经导师指导认可，评审分为98分，源码全部本地编译调试通过，附带数据库脚本，可直接导入运行。系统覆盖药品入库、库存预警、处方管理、供应商信息维护等典型药房业务，前端采用JSP与EasyUI组合，后端以Spring、SpringMVC、MyBatis分层实现，适合作为毕业设计参照或课程设计进阶练习。

资源包共1222个文件，压缩后大小19.56MB，其中包含48个Java源码文件、70个JSP页面、256个HTML页面、227个CSS样式、207个JS脚本，以及SQL数据库脚本、XML配置文件、JAR依赖库等。静态页面、业务逻辑与数据表结构均有对应内容，目录结构清晰，便于分模块学习与二次开发。目前已有174人学习或下载，下载即可获得可运行的完整工程、数据库初始化脚本及配置说明，能够帮助快速跑通项目，并理解SSM框架整合与药房业务流程。

1. SSM 药房管理系统：值得下载的 Java 毕业设计源码到底解决什么问题

做 Java 毕设最怕的不是需求复杂，而是系统看起来完整、实际跑不起来。这套基于 SSM 框架的药房管理系统，属于典型的"业务闭环"型项目：药品信息管理、供应商管理、入库出库、库存预警、销售记录都用同一个技术栈串了起来，前端用 EasyUI 做后台界面，数据库脚本直接导入 MySQL 就能出演示数据。评审分 98 分、源码本地编译可运行，这些信息说明它不是纯理论拼凑，而是按完整工程的标准交付的。

适合两类人：一类是正在做 Java 毕业设计、需要一个能讲清楚"业务逻辑+表结构+框架配置"三件事的完整项目；另一类是刚学完 SSM、想找一个非教学 Demo 级别的实战源码来练手的人。这篇笔记会把我的拆解过程、环境配置、表结构逻辑和踩过的坑全部摊开讲。

2. 先看懂底座：SSM 整合、核心数据表和前端角色分工

2.1 Spring、SpringMVC、MyBatis 在这个项目里各管什么

SSM 是老牌 Java Web 组合，但很多人只是背了概念，没理解它在落地时的分工。你自己打开这份源码后会发现，工程结构其实非常规整：controller、service、dao、entity、mapper五个核心包挨个排好，配置集中在resources下。

Spring 负责的是对象管理，也就是把Service层的类交给容器托管，让Controller里可以直接注入，不再自己new。SpringMVC 负责请求分发，前端页面提交的 URL 会通过web.xml里配置的DispatcherServlet进入对应的Controller方法。MyBatis 负责 SQL 那一层，每个dao接口对应一个mapper.xml，里面的resultMap和select/insert/update标签直接定义了 Java 对象与数据库字段的映射关系。

提示：打开工程后先看web.xml，里面会同时配置 Spring 的ContextLoaderListener和 SpringMVC 的DispatcherServlet，这两个配置的加载顺序决定项目能不能正常启动。

2.2 数据库脚本里的核心表结构：药品、供应商、入库、出库

这套系统的数据库脚本是打包下载里最关键的部分。按药房管理业务的常见设计，脚本会包含这几类表：

看这套表结构时，我建议你重点盯drug_info和入库、出库两张关联表，因为药房系统最核心的业务逻辑就是"库存同步"——药品表里的stock字段是一个冗余值，实际库存应该等于所有入库数量减去所有出库数量，这在答辩里是最好问、也最好答的点。

2.3 前端用的 EasyUI 和 Bootstrap：后台管理界面的实现思路

源码包里出现了easyui.css、bootstrap.css、animate.css这些静态资源文件，对应的是后台管理界面常见的组合方案。EasyUI 是做后台管理系统比较省事的组件库，它的datagrid组件直接和 JSON 数据对接：后端返回一个PageResult对象（含total和rows），前端就能自动渲染成带分页的表格。bootstrap.css在这里主要用来兜底样式，animate.css是给页面切换加一点动效，让演示时看起来更自然。

这个组合说明项目的前后端交互方式是典型的"页面差一个 JSON、后端差一个请求"，也就是 JSP 页面通过 jQuery$.ajax或者 EasyUI 封装的datagrid请求 URL，后端返回 JSON。你在写开题报告和答辩 PPT 时，"基于 EasyUI 的快速开发后台界面"是可以放在技术选型章节的观点。

3. 把项目跑起来：环境配置、导入步骤和数据库初始化

3.1 版本清单：JDK、MySQL、Tomcat、Maven 怎么选

这套源码基于 SSM，属于传统 Servlet 容器项目，不是 Spring Boot，所以环境版本不能乱配。我建议按下面的组合来装，兼容性最好：

提示：如果你电脑上装的是 MySQL 8.0，也可以跑，但要把驱动换成mysql-connector-java8.x 版本、驱动类改为com.mysql.cj.jdbc.Driver，还要在连接串里加上时区参数。这个细节在后面避坑章节我会详细说。

3.2 导入 Eclipse 工程到 IDEA：处理.classpath和依赖缺失

源码包里有.classpath这个文件，说明原开发环境大概率是 Eclipse 或 MyEclipse。如果你用的是 IntelliJ IDEA，不要直接Open文件夹，正确做法是：File -> New -> Project from Existing Sources，找到工程目录，然后选择Eclipse导入方式，IDEA 会识别.classpath中记录的源目录和输出目录。

很多人在这一步翻车，就是因为导入后项目结构识别错了。这里有一个判断技巧：项目根目录下如果有.classpath和.project，就按 Eclipse 工程导入；如果只有pom.xml，才按 Maven 工程直接打开。工程导入后，先执行一次 Mavenreimport（IDEA 右侧 Maven 面板点刷新按钮），等依赖下载完成再继续。如果项目里已经带了lib目录，说明原项目可能不是纯 Maven 管理的，这时候要检查WEB-INF/lib里是否有必需的 jar 包，没有的话需要手动从 Maven 仓库补齐。

3.3 初始化数据库：用脚本建库、建表、灌入演示数据

拿到数据库脚本后，不要直接双击打开灌 SQL，最好用命令行方式，这样报错信息更清晰。假设脚本文件名为pharmacy.sql，执行命令如下：

mysql -u root -p < pharmacy.sql

执行完之后，登录 MySQL 确认结果：

mysql -u root -p show databases; use pharmacy; show tables; select count(*) from drug_info;

执行逻辑说明：mysql 命令会逐条执行脚本文件里的 SQL 语句，脚本里通常包含CREATE DATABASE、CREATE TABLE和INSERT INTO三个部分。如果脚本里没有建库语句，说明它默认是在pharmacy库内建表，你需要先手动执行CREATE DATABASE pharmacy DEFAULT CHARACTER SET utf8;。

参数说明：-u root是用户名，-p会提示输入密码。如果脚本文件很大，可以加--default-character-set=utf8参数强制客户端用 UTF-8 编码发送 SQL，避免中文注释和中文数据写入时变成乱码。

3.4 修改配置文件并启动到登录页

数据库初始化完成后，打开resources目录下的数据库连接配置文件（常见名是jdbc.properties或db.properties），把账号密码改成你本机的：

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/pharmacy?useUnicode=true&characterEncoding=utf8 jdbc.username=root jdbc.password=123456

配置说明：useUnicode=true和characterEncoding=utf8这两个参数必须保留，否则后续页面上药品名称等中文会乱码。3306是 MySQL 默认端口，如果你安装时改过端口，这里要同步改。然后把项目部署到 Tomcat：IDEA 里配置 Tomcat 8.5，Deployment选项卡添加war exploded或者war包，Application context设置为/pharmacy，启动后浏览器访问http://localhost:8080/pharmacy/就能看到登录页。

4. 核心业务怎么落地的：药品管理和入库出库的数据流转

4.1 药品增删改查：从 Controller 到 Mapper XML 的完整调用链

药品管理是这套系统的门面功能。前端 EasyUI 的datagrid在加载时会向后端发送请求，URL 类似/drug/list?page=1&rows=10。后端DrugController接收参数后调用 Service 层，Service 再调 DAO 接口，由 MyBatis 的 Mapper 执行 SQL。代码逻辑大概是这样的：

@Controller @RequestMapping("/drug") public class DrugController { @Autowired private DrugService drugService; // 分页查询药品列表，返回 easyui datagrid 需要的 JSON 格式 @RequestMapping("/list") @ResponseBody public PageResult list(Drug drug, int page, int rows) { PageResult result = new PageResult(); // 计算分页起始位置 int start = (page - 1) * rows; result.setTotal(drugService.count(drug)); result.setRows(drugService.selectList(drug, start, rows)); return result; } // 新增或修改药品 @RequestMapping("/save") @ResponseBody public JsonResult save(Drug drug) { if (drug.getId() == null) { drugService.insert(drug); } else { drugService.update(drug); } return JsonResult.success(); } }

逻辑说明：@Autowired是 Spring 依赖注入，@ResponseBody会把PageResult对象序列化成 JSON 字符串写回前端。EasyUI 表格收到{"total": 10, "rows": [...]}后自动渲染分页列表，这是这类系统最常见的返回格式。

参数说明：page是当前页码，rows是每页条数，这两个参数名是 EasyUI 默认发送的。如果你改前端表格组件，记得后端这里的参数名也要对得上。

4.2 库存出库逻辑：数量扣减和事务处理的实现要点

药房系统的出库操作比单纯的增删改查复杂一些，它涉及两张表的数据变更：先在sale_record表插入一条销售记录，再更新drug_info表的stock字段。这两个操作必须在一个事务里完成，否则会出现"销售记录有了但库存没扣"的问题。源码里的 Service 层一般会用 Spring 的事务注解：

@Service public class SaleServiceImpl implements SaleService { @Autowired private SaleMapper saleMapper; @Autowired private DrugMapper drugMapper; @Override @Transactional(rollbackFor = Exception.class) public void saleDrug(SaleRecord record) { // 1. 插入销售记录 saleMapper.insert(record); // 2. 扣减库存，SQL 里会带上 stock >= quantity 的条件 int updated = drugMapper.decreaseStock(record.getDrugId(), record.getQuantity()); if (updated == 0) { // 库存不足时抛出异常，事务回滚 throw new RuntimeException("库存不足"); } } }

逻辑说明：decreaseStock对应的 Mapper SQL 通常是这样写的：UPDATE drug_info SET stock = stock - #{quantity} WHERE id = #{drugId} AND stock >= #{quantity}。这里把"库存是否足够"的判断放到 SQL 的WHERE条件里，而不是先查一次再判断，是为了避免并发场景下两个请求同时读到同一个库存值然后一起扣减。

参数说明：@Transactional默认只在抛出RuntimeException时回滚，rollbackFor = Exception.class是让所有受检异常也触发回滚。如果你在二次开发时新增了会抛出异常的操作，记得保持这个约定，不然会出现数据不一致。

4.3 权限控制：不同登录角色看到不同菜单的实现

药房系统一般分管理员和普通操作员两个角色。源码里最可能采用的是"登录后 Session 存角色信息 + 拦截器拦请求"的方案。LoginInterceptor会检查未登录的请求，而菜单的显示则根据角色字段在前端 JSP 页面里做判断。

<mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <mvc:exclude-mapping path="/login"/> <mvc:exclude-mapping path="/css/**"/> <mvc:exclude-mapping path="/js/**"/> <mvc:exclude-mapping path="/images/**"/> <bean class="com.pharmacy.interceptor.LoginInterceptor"/> </mvc:interceptor> </mvc:interceptors>

配置说明：mvc:exclude-mapping是白名单，登录页和静态资源不拦。其他所有路径都要经过LoginInterceptor，这个 Java 类里做的事情非常简单：从session里取loginUser，如果不存在就response.sendRedirect("/pharmacy/login")。静态资源放行是一个容易忽略的点，如果没配，CSS 和 JS 文件会被拦截器挡掉，页面变成无样式状态。

5. 避坑指南：从导入源码到答辩演示的 5 个高频问题

5.1 Tomcat 启动报ClassNotFoundException: com.mysql.jdbc.Driver

现象：启动 Tomcat 时后台日志直接报找不到驱动类，或者页面访问数据库时报同样的错。

原因：数据库连接是由 Tomcat 或 Web 应用加载驱动类的，如果mysql-connector-java这个 jar 包没有打到WEB-INF/lib目录下（Eclipse 项目常见），Tomcat 运行时根本找不到这个类。还有一种情况是 MySQL 8 环境下驱动类名变成com.mysql.cj.jdbc.Driver，而你用的还是老名字。

解决：打开项目结构，确认WEB-INF/lib下存在mysql-connector-java-x.x.x.jar；如果不存在，在 Maven 依赖里找到对应 jar 后手动复制进去。同时核对你的 MySQL 版本，如果数据库是 8.x，把jdbc.properties里的驱动类改成com.mysql.cj.jdbc.Driver，并给 URL 加上serverTimezone=Asia/Shanghai。

5.2 页面中文显示乱码：药品名称全是"???"

现象：数据库表和页面上显示的中文全部变成问号，或者登录用户名显示乱码。

原因：乱码有三个独立链路，任何一个断了都会出问题：第一，MySQL 表结构和连接的字符集不是utf8；第二，JSP 页面没有声明pageEncoding="UTF-8"；第三，SpringMVC 的CharacterEncodingFilter没配置，POST 请求的中文参数没有被正确解码。

解决：按顺序检查三层。先看jdbc.properties里有没有characterEncoding=utf8；再查表结构：SHOW CREATE TABLE drug_info;，如果DEFAULT CHARSET不是utf8，用ALTER TABLE drug_info CONVERT TO CHARACTER SET utf8;转换；最后看web.xml里是否配置了CharacterEncodingFilter且forceEncoding=true。最容易被忽视的是第三个，因为 GET 请求乱码偶尔被浏览器掩盖，但 POST 提交时一定暴露。

5.3 Tomcat 启动正常，但访问页面报 404，而登录页单独访问没问题

现象：输入http://localhost:8080/pharmacy/后返回 404，但直接访问/pharmacy/login.jsp又能打开。

原因：这说明项目部署的上下文路径和你访问的路径不一致。如果Application context配的是/pharmacy，但页面里的链接写的是绝对路径/login，跳转时会到http://localhost:8080/login，自然 404。

解决：在 IDEA 的 Tomcat 配置里确认Deployment选项卡下面的Application context到底是什么，然后在浏览器访问时用完整路径：http://localhost:8080/项目上下文/login。如果源码里使用了<%=request.getContextPath()%>拼接路径，就不会有这个问题；没有的话，二次开发时建议统一改成这种写法。

5.4 登录后页面样式全部丢失，表格错乱

现象：登录成功进入主界面，页面 CSS 和 JS 全是"裸奔"状态，表格堆在一起没有任何样式。

原因：页面里引入的easyui.css、bootstrap.css用的是绝对路径（比如/static/css/easyui.css），而项目上下文路径不是根路径，导致浏览器实际请求的是http://localhost:8080/static/...，资源找不到。

解决：把 JSP 页面里的静态资源引用改成使用 EL 表达式拼路径：<link href="${pageContext.request.contextPath}/static/css/easyui.css">。用全局搜索在源码里找出所有以href="/或src="/开头的引用，统一改成上面这种写法，然后重启 Tomcat 就好了。

5.5 数据库脚本导入时外键约束报错，建表失败

现象：执行mysql -u root -p < pharmacy.sql时，报Cannot add foreign key constraint的错误。

原因：脚本里表之间的外键依赖顺序不对，比如sale_record表的外键引用了drug_info，但drug_info还没创建出来。也可能是两张表的引擎不一致，一个用InnoDB、一个用MyISAM，外键只能在InnoDB上生效。

解决：不要直接放弃，先看报错语句是哪一条，找到依赖的表名。如果脚本顺序是乱的，最简单的办法是手工调整：把报错的那张表拆到单独的文件执行。也可以用SET FOREIGN_KEY_CHECKS=0;放在脚本开头暂时关闭外键检查，导入完成后再恢复为1。注意后者只是权宜之计，如果你后续要正常使用外键约束，还是建议把建表顺序理清楚。

6. 二次开发与验证：把系统变成真正能答辩的项目

6.1 增加"药品批次"概念：一张表补全库存管理的业务深度

原系统的库存管理是简单的"一个药品对应一个库存数"，这在答辩时容易被抓住短板。我建议你加一个批次管理字段，让库存追踪到批号，这在真实药房是有业务含义的——同一种药不同批次，效期不同，售价相同但进价可能不同。

CREATE TABLE drug_batch ( id INT PRIMARY KEY AUTO_INCREMENT, drug_id INT NOT NULL, batch_no VARCHAR(50) NOT NULL COMMENT '批次号', expire_date DATE NOT NULL COMMENT '效期', purchase_price DECIMAL(10,2) NOT NULL COMMENT '批次进价', quantity INT NOT NULL COMMENT '本批次剩余数量', FOREIGN KEY (drug_id) REFERENCES drug_info(id) );

逻辑说明：有了批次表，出库时可以按"先过期先出"（FEFO）的原则来选择扣减哪个批次的库存，这是药房管理系统的标准做法，也是答辩时很出彩的业务细节。加表之后，SaleServiceImpl的执行逻辑就变成：插入销售记录、按expire_date正序查出批次、扣减批次数量、同步扣减drug_info.stock。

6.2 用 SQL 验证库存一致性：让数据替你说话

演示时不要只靠点按钮，你可以准备一条 SQL 现场验证系统的数据一致性。这个动作很能体现工程素养：

SELECT d.id, d.drug_name, d.stock AS current_stock, (SELECT COALESCE(SUM(quantity), 0) FROM drug_inbound WHERE drug_id = d.id) - (SELECT COALESCE(SUM(quantity), 0) FROM sale_record WHERE drug_id = d.id) AS calc_stock FROM drug_info d HAVING current_stock != calc_stock;

说明：这条 SQL 把"系统库存"和"出入库流水算出来的库存"对账，如果你加了批次表，可以再把批次数量加进来：(SELECT COALESCE(SUM(quantity),0) FROM drug_batch WHERE drug_id = d.id) AS batch_stock。如果查询结果为空，说明数据一致；有记录则说明某个环节丢了事务，正好可以引出你做的@Transactional设计。

用 JMeter 对登录接口做一次简单的压测也可以作为加分项，50 个线程并发请求登录，观察响应时间和错误率，把截图放进论文的"系统性能测试"章节即可。

这套项目我从拿到到跑通，踩得最多的坑就是环境版本不匹配和路径问题——jar 包版本、上下文路径、字符集这三个点占了八成时间。从那以后我每次部署陌生的 SSM 项目，都强制先看一遍web.xml、jdbc.properties和pom.xml三个文件再动手，这个习惯帮我省了大量排错时间。希望这些拆解和避坑记录能让你少走这段弯路，顺利把项目跑起来、讲明白。

本文还有配套的精品资源，点击获取