基于MySQL+Java的仓库管理系统：JDBC连接、事务与避坑指南

简介：这是一个基于MySQL与Java技术栈开发的仓库管理系统完整项目，面向计算机、数学、电子信息等专业的课程设计、期末大作业与毕业设计场景，适合已掌握Java基础、希望实战数据库增删改查与桌面端界面开发的读者。项目包含全部源码、数据库脚本及运行所依赖的库，整体下载后可按说明部署运行，也可作为二次开发起点。资源共26个文件，压缩包大小960KB，主要文件类型有Java源码、FXML界面文件、XML配置、SQL脚本、JAR依赖库和项目配置文件等，覆盖建库建表、业务逻辑、界面交互与工程配置的完整链路，目录结构清晰，便于按模块拆解。目前已有342人浏览学习。借助这套仓库管理系统，读者能快速理解仓库出入库、库存管理等业务的数据组织方式，掌握Java+FXML构建管理系统的典型流程与调试方法，同时可基于自带SQL脚本自行扩展功能，是课程实战和毕设阶段值得参考的完整资料。

1. 这套 MySQL+Java 仓库管理系统源码，能直接跑但别急着跑

答辩前三天拿到这套压缩包，解压后先导入 SQL，页面还没开，控制台先红了一屏——这是我第一次拆仓库管理系统课设源码的真实经历。基于MySQL+Java的仓库管理系统项目源码，压缩包内是完整的 IDEA 工程和一份独立的Warehouse management.sql，代码量不大，却把 JDBC 连接、增删改查、出入库流水这几条主线都覆盖了，属于典型的课程设计案例源码。它适合三类人：正在做 Java 课程设计还没凑齐功能的人，想把数据库设计讲清楚的人，以及单纯想拿一套能跑的 Java 课设复盘实现逻辑的新手。先说结论：这套东西能导入能运行，但库表关系和事务边界的处理才值得细看，建议动手前把整篇笔记过一遍。

2. 项目结构与数据模型：先搞懂文件布局和五张核心表

2.1 工程目录：IDEA 项目 + libs 依赖，没有 Maven 也能编译

解压之后的第一印象是“朴素”。顶层没有pom.xml，也没有 Gradle 配置，最显眼的是src、libs、Warehouse management.sql和.idea。这种结构在课设里非常常见，说明作者当时用的是 IntelliJ IDEA，并且把依赖 jar 放在了libs目录下手动管理。drug.iml这个文件暴露了一点背景：这个工程大概率是从某个医药仓储场景改过来的，但核心的表结构和代码逻辑已经通用化，做普通仓库管理系统课设完全够用。

路径	作用	使用建议
src	Java 源码，按包组织	重点看 dao、model、ui 三块
libs	外部依赖 jar，包括 MySQL 驱动	用 IDEA 打开后需手动挂到 Module
Warehouse management.sql	建库、建表、初始数据	导入时注意字符集和库名
.idea/drug.iml	IDEA 工程配置	保留即可，版本换了自己的也能用

依赖直放在libs而不是走 Maven，对一个课程设计来说不是坏事。答辩现场通常不能保证网络畅通，点开 IDEA 的项目结构，把libs里的驱动和控件库作为依赖加进 Module 就能编译，这避免了 Maven 远程拉包失败的尴尬。做法上我一般会先确认libs下是否有mysql-connector-java的 jar，没有的话去本机 Maven 仓库或离线目录里拿一个 5.1.49 或 8.0 系列的驱动补进去，版本不对后面连接串也会出问题。

2.2 核心表设计：库存、货品、流水各司其职

仓库管理系统最怕的就是一张大表从头写到尾。拆这份 SQL 脚本，会发现表是按业务拆开的。一套合格的仓库课设至少应该包含这几类表：用户表、货品表、库存表、流水表和仓库表。以库存表为例，核心字段一般设计成下面这个样子：

CREATE TABLE `t_stock` ( `id` INT AUTO_INCREMENT PRIMARY KEY, `goods_id` INT NOT NULL COMMENT '货品ID', `warehouse_id` INT NOT NULL COMMENT '仓库ID', `batch_no` VARCHAR(50) DEFAULT '' COMMENT '批次号', `expire_date` DATE DEFAULT NULL COMMENT '有效期', `quantity` DECIMAL(10,2) NOT NULL DEFAULT 0.00 COMMENT '当前数量', UNIQUE KEY `uk_goods_warehouse_batch` (`goods_id`, `warehouse_id`, `batch_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='库存表';

这里把quantity定义成DECIMAL(10,2)而不是FLOAT或DOUBLE，原因很直接：浮点数在累计加减时会产生精度误差，做仓库盘点时 0.1 斤的差异都可能解释不清。UNIQUE联合索引解决的是同一个货品在同一仓库同一批次重复插入的问题，配合INSERT ... ON DUPLICATE KEY UPDATE写入库逻辑会省很多事。字符集用utf8mb4，比utf8多覆盖了 emoji 和特殊字符，导入导出时也更不容易翻车。

2.3 SQL 脚本里的两个约定：单库单文件，数据全在 DML 里

打开的Warehouse management.sql会发现它把建库、建表、初始数据全放在了一个文件里。这种做法和线上项目的惯例不同，但对一个课设是合理的：答辩时只需导入一次，就能把整个库结构跑起来。脚本里一般会先CREATE DATABASE IF NOT EXISTS，然后USE，再创建表，最后用多条INSERT写入初始管理员账号和几个示例货品。这意味着你不需要手动建库，直接在 Navicat 或命令行里source整个文件即可。

注意点在于 DEFAULT 值。有些字段允许 NULL，有些则设置成空字符串或 0。比如quantity的默认值是0.00，而不是NULL。这个细节在判断“库存为空”时区别很大：用NULL判断要写IS NULL，用0判断直接= 0，代码写起来顺手很多。顺带一提，MySQL 里设置默认值为 0 是最常见的做法，但要注意DECIMAL类型的默认值必须和字段精度匹配，写成0还是0.00取决于定义，否则某些版本会直接报语法错误。

3. JDBC 连接与增删改查：从工具类到表格数据源

3.1 连接工具类：驱动加载、URL 参数与连接池的取舍

跑通项目的突破口一定是 JDBC 连接。课设阶段不建议追求连接池，DriverManager.getConnection()足够直接，也方便口头讲原理。一个标准的工具类会把驱动加载放在静态代码块里，保证类首次加载时驱动只注册一次：

public class DbUtil { private static final String DRIVER = "com.mysql.cj.jdbc.Driver"; private static final String URL = "jdbc:mysql://localhost:3306/warehouse_db" + "?useUnicode=true&characterEncoding=utf8" + "&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASSWORD = "123456"; static { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }

注意驱动类名有两个版本。MySQL 5.x 用com.mysql.jdbc.Driver，MySQL 8.x 用com.mysql.cj.jdbc.Driver。如果libs里放的是 8.0 系列的 jar，写老驱动名会直接报ClassNotFoundException。URL 里的useSSL=false是解决 SSL 连接告警或握手报错的常用手段；serverTimezone=Asia/Shanghai解决的是 MySQL 8 当时区为空时抛异常的问题。这两串参数看起来是玄学，实则是课设跑通前最容易卡人的地方。

连接池在这个项目里属于“可讲但不必做”。如果答辩被问到了，可以回答：DriverManager每次创建新连接，成本高；生产环境会使用连接池，但这里为了展示 JDBC 原生流程，故意没引入额外依赖。这样答反而比硬吹 HikariCP 更稳。

3.2 列表查询：ResultSet 到表格模型的数据管道

仓库管理系统的核心界面是表格。无论是货品列表还是库存明细，Java Swing 的JTable配合DefaultTableModel是课设源码里最常见的做法。查询逻辑一般长这样：

public List<Goods> listGoods(String keyword) { List<Goods> list = new ArrayList<>(); String sql = "SELECT id, goods_name, spec, unit, price FROM t_goods " + "WHERE goods_name LIKE ?"; try (Connection conn = DbUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, "%" + keyword + "%"); try (ResultSet rs = ps.executeQuery()) { while (rs.next()) { Goods g = new Goods(); g.setId(rs.getInt("id")); g.setGoodsName(rs.getString("goods_name")); g.setSpec(rs.getString("spec")); g.setUnit(rs.getString("unit")); g.setPrice(rs.getBigDecimal("price")); list.add(g); } } } catch (SQLException e) { e.printStackTrace(); } return list; }

逻辑上要注意三件事：第一，用PreparedStatement而不是Statement，既避免拼接 SQL 时的注入风险，也方便传参；第二，LIKE查询时通配符要放在参数里，写在 SQL 字符串外更清晰；第三，把查询到的数据转成实体Goods，避免在 UI 层直接操作ResultSet，否则连接一关数据就没了。setBigDecimal对应数据库里的DECIMAL，不会丢精度。

填充JTable时，惯用写法是遍历集合并把每行转成Object[]塞进DefaultTableModel。源码里大概率能在ui包下找到类似initTable()的方法。这里有一个看不见但实际存在的陷阱：SELECT *会把所有字段都查出来，连id也显示在界面上。处理方式是查完数据后手动构造String[] columns，表头和数据一一对应，不去动数据库表的列顺序。

3.3 写操作：入库单与库存数量的事务边界

课设里容易被忽视的往往是事务。单纯执行一条INSERT没问题，可仓库入库本质上牵涉两张表：往入库单里插记录，同时更新库存数量。两个操作中间任何一步失败，都会留下“单据有记录但库存没变”的脏数据。正确的写法是把两个操作放进同一个事务：

Connection conn = null; try { conn = DbUtil.getConnection(); conn.setAutoCommit(false); // 1. 写入库单 String insertSql = "INSERT INTO t_store_record (type, goods_id, quantity, create_time, operator) " + "VALUES (1, ?, ?, NOW(), ?)"; PreparedStatement ps1 = conn.prepareStatement(insertSql); ps1.setInt(1, goodsId); ps1.setBigDecimal(2, quantity); ps1.setString(3, operator); ps1.executeUpdate(); // 2. 库存表数量增加 String updateSql = "UPDATE t_stock SET quantity = quantity + ? " + "WHERE goods_id = ? AND warehouse_id = ?"; PreparedStatement ps2 = conn.prepareStatement(updateSql); ps2.setBigDecimal(1, quantity); ps2.setInt(2, goodsId); ps2.setInt(3, warehouseId); ps2.executeUpdate(); conn.commit(); } catch (SQLException e) { if (conn != null) { conn.rollback(); } e.printStackTrace(); }

这里的手法是先关掉自动提交，然后在同一个连接里连续执行两条写 SQL，最终统一commit。任何一条抛异常，rollback()会把已执行的落库操作全部撤回，保证数据库状态回到动作之前。注意：事务边界不是“方法里出现多个 SQL 就算事务”，而是所有 SQL 必须共享同一个Connection。很多人上课没留意这点，自己在两个工具方法里各自拿连接，写了两条 SQL 照样出现数据不一致，根因就在这里。

4. 入库、出库与库存流水：把业务流程做成闭环

4.1 入库流程：批次、有效期、价格三个字段怎么配合

仓库系统的入库不能只理解为“库存数量加一”。实际场景里，一批货进来会带有批次号、有效期、进价这些属性。批次号是唯一的，同一种货不同批次进价可能不同；有效期直接影响先进先出的出库策略。所以入库动作在代码层面要考虑五件事：货品是否存在、仓库是否允许收该货品、批次是否重复、有效期格式是否正确、本次数量是否为正数。

写代码时可以用先查后插的方式：先按goods_id和warehouse_id查库存表，如果批次相同就执行的数量累加，如果批次不同则新插一行。这里用INSERT ... ON DUPLICATE KEY UPDATE quantity = quantity + VALUES(quantity)可以把两步合成一句，但这个语法不少课设源码里根本没用过。给答辩准备的解释是：靠唯一索引去重，避免先查再插的间隙窗。如果面试官追问底层，就答ON DUPLICATE KEY UPDATE在Innodb下对同一条记录会先执行索引查找，判重是原子的。

4.2 出库策略：批次优先级与扣减顺序

出库最容易做错的点是凭空扣一个总数。实际上库存表按batch_no拆了行，出库时必须确定先扣哪一批。行业内普遍遵循“先进先出”即批次到期日越早越先出，有些系统也支持按剩余保质期短、先出。在 Java 代码里通常是查库存表，按expire_date ASC排序，然后逐行扣减，直到满足出库数量为止。

建议给这份课设补一个出库算法，普通写法是从数据库查出该商品的所有库存批次列表，按到期日排序，再用循环依次扣减。实现时要注意循环判断库存是否充足：剩余需求量remain初始等于出库数量，每一批的扣减量是min(stock.quantity, remain)，扣完remain减去实际扣减量，当remain小于等于零时跳出。这个算法不难，但是写到纸上能加分不少，因为它把“库存充足但批次不够扣”这种边界也覆盖了。

4.3 盘点与报表：为什么流水表不能删

流水表是这份课设里最容易被当成“多余”的表。从 UI 上看它不过是一份带类型的进出记录，可它承担了两个重量级职责：一是审计，能追溯每一笔单据是谁在什么时间操作的；二是财务对账基础，月度盘点时库存账面数与流水累加数互相验证。因此我在看这类课设时，第一条检查就是入库和出库是否都往t_store_record写记录。如果只改了库存数量、没写流水，直接判不合格。

流水表设计上通常会带type字段，1 是入库，2 是出库，3 是盘盈盘亏调整。盘盈亏在课设里是亮点功能，用独立的调整类型区分手工改动，而不直接覆盖库存数。这个设计思想本质是“任何对库存的变更都必须有据可查”。把这些话说给答辩老师听，比单纯演示“我点了按钮数据变了”要扎实得多。面向对象编程里常说单一职责，落实到表设计就是数据类型靠主表，过程记录靠流水表，各回各家。

5. 避坑指南：导入数据库到跑通界面的五个高频翻车点

5.1 控制台报ClassNotFoundException: com.mysql.jdbc.Driver

现象：运行主类，IDEA 控制台直接抛出java.lang.ClassNotFoundException，指向驱动类。

原因：libs目录下的驱动 jar 没有正确添加到项目的 Module 依赖中，或者 jar 包本身是 MySQL 8 的驱动，但代码里写的是老驱动名com.mysql.jdbc.Driver。

解决：先点菜单 File → Project Structure → Libraries，把libs目录作为依赖导入。再把代码里的驱动类名改成和 jar 版本一致的名称。MySQL 8 对应com.mysql.cj.jdbc.Driver，MySQL 5 对应com.mysql.jdbc.Driver。如果实在不确定 jar 版本，解压 jar 看META-INF/services/java.sql.Driver文件里的类名最准。

5.2 本地 MySQL 装好了却连不上：Communications link failure

现象：JDBC 报Communications link failure，但 MySQL 服务在系统里已经启动。

原因：MySQL 默认端口 3306 被占用，或者服务实际没有启动；也可能是远程连接权限只开了localhost，而你用了127.0.0.1。

解决：先在命令行执行mysql -u root -p，能连说明服务正常。再检查 IDE 里DbUtil的 URL 的端口是否和本地 MySQL 一致。查端口用netstat -ano | findstr 3306（Windows）或lsof -i:3306（macOS）。如果本机装了多个 MySQL 实例，SQLyog 或 Navicat 里能连，不代表 Java 连的就是同一个。

5.3 中文数据全是问号：连接串少了一个参数

现象：页面加载后中文列全部显示为???，英文和数字正常。

原因：数据库字符集是utf8mb4，但连接串没带characterEncoding，JDBC 用了默认字符集去读，导致中文字节解析失败。

解决：在 URL 里加characterEncoding=utf8，这个是驱动层的编码声名，顺序别放在最后面，最稳妥的写法是把它放在数据库名后面紧跟?。另外，导入 SQL 文件时，命令行工具要用source方式导入，确保脚本本身的编码格式是 UTF-8，用记事本另存时不要选 ANSI。

5.4 MySQL 8 的密码插件：Public Key Retrieval is not allowed

现象：连接 MySQL 8 时抛Public Key Retrieval is not allowed，有的环境还会伴随caching_sha2_password cannot be loaded。

原因：MySQL 8 默认认证插件是caching_sha2_password，较旧的驱动版本不支持这个插件，或者 JDBC 连接时没有允许客户端获取服务端公钥。

解决：连接串里加allowPublicKeyRetrieval=true，并且把useSSL=false一起带上。也可以在 MySQL 里把该用户的认证方式改回mysql_native_password：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码';然后刷新权限。两种方式按项目环境取舍，如果只是本机课设，改驱动参数最省事。

5.5 库存出现负数：查出来是 0，提交后却是 -60

现象：库存剩余 40，出库 50 也能成功，库存表变成 -10 甚至更多，没有任何提示。

原因：查询库存后在 Java 代码里做减法，然后 UPDATE 回数据库。两个用户同时操作或代码逻辑没有先校验库存充足，就会出现负数。更隐蔽的是UPDATE t_stock SET quantity = quantity - ?执行后没有检查受影响行数，即使影响行数为 0 也照常提交单据。

解决：在 UPDATE 语句里加库存要求，UPDATE t_stock SET quantity = quantity - ? WHERE goods_id = ? AND warehouse_id = ? AND quantity >= ?。当实际库存不足时，受影响行数为 0，代码据此抛库存不足异常，有机结合地拦截负数。我给这类仓库课设补漏时，第一反应就是把所有库存扣减 SQL 都加上这个quantity >= ?条件，比任何前端弹窗都可靠。

6. 用最小闭环验证项目：从登录到入库再出库的一套自检流程

项目跑通后，我建议你先别急着改功能，照着下面这条链路完整走一遍。不走完，你可能永远不知道这个 base 项目的真实性边界。

第一步，导入数据库。打开 Navicat 或 MySQL Workbench，新建查询，执行source D:/path/Warehouse management.sql。确认库里出现表结构和初始数据。检查t_user里是否有管理员账号，通常初始密码是admin或123456，源码里可能写死，去dao包翻。

第二步，IDEA 启动主类。如果主类不好找，在src里搜索带main方法的类，这类项目一般叫MainFrame或LoginFrame。先跑起来再说，报错按上一章的方法排。

第三步，用管理员账号登录。登录成功后有主界面，菜单一般包含基础数据、入库管理、出库管理、库存查询、流水查询。有缺口的模块先记下来，这些缺口往往是答辩时老师最喜欢问“如果让你扩展，你会加什么”的落点。

第四步，新增一个货品，手动输入编码、名称、规格、单位、参考价。再对这个货品做一次入库操作，填仓库、批次、数量。入库后立刻查库存和流水，数量要等于入库量，流水应有一条入库记录。

第五步，做一次出库。出库量设为当前库存的一半，出库后库存表数量减半，流水多一条出库记录。如果库存不足，确认系统是否弹提示、是否阻止提交。

第六步，验证盘点。如果项目有盘点功能，做一次盘点，调整某个货品的库存到真实盘数，核对流水里是否产生了调整记录。没有盘点功能也没关系，这条链路已经覆盖了主要数据流。

走完这套流程，你的状态就从“拿别人代码试试”变成了“亲手验证过的使用者”。给这套课设做扩展时，再有底气去改 SQL 和业务方法。前几年我拿到一份连接串写错时区的项目，当时没做验证就改着玩，最后把库存表翻得对不上账，只能重新导入 SQL。从那以后，我每次动手改代码前都强制走一遍上面的最小闭环验证，把数据库备份和清数据放在第一位，数据库比代码更怕乱搞。希望你第一次跑这个仓库管理系统时，别赶在答辩前夜，留一天给自己踩坑、填坑，后面就顺了，希望帮到你。

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