简介：面向高校数据库课程设计的超市管理系统完整源码包，采用Java+MySQL+JDBC+JavaSwing技术栈，适合期末项目参考、二次开发或课程设计答辩演示，解决数据库编程与桌面界面结合的常见难题。代码基于JDK12与MySQL8.0环境，附带SQL建库脚本，引入FlatLaf及IntelliJ主题依赖对界面进行统一美化，实现接近系统原生观感，可直接运行或按需修改。资源共24个文件，以17个Java源文件为主体，辅以SQL脚本、Maven配置XML、依赖JAR包、gitignore及README说明，文件类型覆盖源代码、配置、数据库初始化脚本与说明文档，包体仅1.1MB，轻量便于下载部署。目前已有217人学习下载，适合数据库原理、Java GUI编程等课程的实战训练。从中可拿到完整的超市管理模块代码、建库脚本与界面美化配置，理解JDBC连接、Swing布局、事件处理及Maven管理项目的实际落地方式，是期末课程设计的高质量样例。
1. 期末数据库课程设计：基于Java+MySQL+JDBC+JavaSwing的超市管理系统到底能不能直接跑
期末数据库课程设计这个节点，找源码最怕的不是代码少，而是下载下来三天跑不起来。这份基于Java+MySQL+JDBC+JavaSwing的超市管理系统，是一份能直接导入IDE的Maven工程，自带sm.sql数据库脚本、FlatLaf界面美化依赖和完整源码，目标就是把"数据库课设"从选题变成能演示、能答辩的项目。它适合两类人：一是期末要交数据库课设、不想从零写界面的在校生；二是想快速看一遍JDBC+Swing连接MySQL完整写法的开发者。我的建议是把它当脚手架用，先跑通再改需求，比从零搭建省下两三天时间。编码是GBK，开发环境锁定JDK12+MySQL8.0，UI用UIManager引用系统当前风格，这几个信息先记住，后面每一章都跟它们有关。
2. 从ZIP到能跑的工程：目录拆解、sm.sql导入与GBK编码坑
2.1 目录拆解：pom.xml、lib、sql、src 四个部分各管什么
解压SuperMarketSystem-master-mvn.zip之后，你会看到一个标准的Maven工程目录。先用一条命令确认结构，心里有数再去动代码：
unzip SuperMarketSystem-master-mvn.zip -d SuperMarketSystem cd SuperMarketSystem/SuperMarketSystem-master-mvn tree -L 2 -dtree命令如果没装，Windows下可以用dir，或者直接在IDEA里打开目录看。重点是这几个东西：
sql/sm.sql：数据库脚本，整个课设的数据结构都在里面。pom.xml：Maven工程描述文件，依赖、插件、编码配置全看它。lib/flatlaf-3.1.1.jar和lib/flatlaf-intellij-themes-3.1.1.jar：Swing用的现代外观库，负责界面美化。mvn-settings.xml：Maven配置文件，一般放着镜像仓库地址，最常见的是阿里云公共仓库。src/main：Java源码，所有窗口、DAO、实体类都在里面。
这里有个判断要提前做：lib目录下只有FlatLaf的jar，没有mysql驱动jar，说明数据库驱动大概率是通过pom.xml从Maven仓库拉的。所以导入工程时不要跳过Maven解析，否则后面ClassNotFoundException一定找上你。
2.2 MySQL8.0 环境准备：sm.sql 导入与 JDBC 连接串对齐
开发环境是JDK12+MySQL8.0，Windows10上装MySQL8.0的图形化安装教程很多，核心就三步：下载安装包、选Developer Default、设root密码。装完先验证服务在跑：
mysqld --version net start MySQL80如果服务名不叫MySQL80，用services.msc看一眼实际服务名。接着导入sm.sql，打开命令行进到项目目录：
mysql -u root -p < sql/sm.sql也可以进MySQL控制台用source执行，效果一样：
source D:/SuperMarketSystem/sql/sm.sql;导入之后别急着写代码，先核对一下建库结果：
SHOW DATABASES; USE 数据库名; SHOW TABLES;脚本里一般会有CREATE DATABASE xxx; USE xxx;和一堆CREATE TABLE，库名以脚本实际为准。我一般会顺手看一遍表结构，确认商品表、订单表、用户表的主键和字段名，因为后面写JDBC代码时，SQL里的列名必须和这里一致。这一步做完，再去对照源码里的JDBC连接串，把jdbc:mysql://localhost:3306/xxx最后的库名改成你自己的。
2.3 编码是第一道坎：GBK 源码、UTF-8 控制台与连接串的字符集协商
这个项目源码是GBK编码，但很多人的IDEA默认是UTF-8，一打开源码就是满屏乱码。这不是项目坏了，是读取编码错了。IDEA右下角把文件编码切到GBK，或者弹窗提示时选择Reload in GBK。如果不管IDE直接命令行编译，Maven也得告诉它源码用什么编码：
mvn clean compile -Dfile.encoding=GBKMaven工程更稳妥的做法是在pom.xml里锁死编码，不然每次编译都靠命令行参数太容易忘：
<properties> <project.build.sourceEncoding>GBK</project.build.sourceEncoding> </properties>编码这里有个常见的理解误区：源码是GBK，不代表JDBC连接串也要写GBK。源码编码决定的是.class文件里的字符串怎么被解析，连接串里的characterEncoding决定的是Java和MySQL之间传输用的字符集。MySQL8.0的表一般建在utf8mb4下面，所以连接串里继续写characterEncoding=UTF-8反而更合适，两边各管各的。后面避坑章节还会细说乱码排查，这里先记住这个分层关系。
3. 把窗口弹出来：JDK12、FlatLaf 依赖与 Swing 主入口
3.1 为什么选 JDK12 + MySQL8.0：版本选型与常见备选
项目写的是JDK12+MySQL8.0，但这不是唯一解。JDK12不是长期支持版本，如果你本机装的是JDK8或JDK11，只要能过编译，跑起来差别不大。真正敏感的只有两点：pom.xml里如果配了maven.compiler.source/target且版本号太高，低版本JDK会直接编译失败；MySQL驱动版本和服务器版本最好别差太远，MySQL8.0配mysql-connector-j 8.x是最稳的。
MySQL8.0和之前版本最大的差别在驱动类名：8.0之后是com.mysql.cj.jdbc.Driver，老项目里写的com.mysql.jdbc.Driver在8.0驱动包下已经被移除了。这点课设答辩时经常被老师拿来问，答案就这一句话：MySQL8.0把驱动类迁移到了cj包下。
3.2 pom.xml 依赖：flatlaf 两个 jar 与 mysql-connector-j 的引入方式
项目自带lib目录，说明作者预留了手工引jar的路线。但既然有pom.xml，Maven路线会更省事，依赖坐标如下：
<dependency> <groupId>com.formdev</groupId> <artifactId>flatlaf</artifactId> <version>3.1.1</version> </dependency> <dependency> <groupId>com.formdev</groupId> <artifactId>flatlaf-intellij-themes</artifactId> <version>3.1.1</version> </dependency>两个坐标分别对应lib里的flatlaf-3.1.1.jar和flatlaf-intellij-themes-3.1.1.jar。前者提供基础外观，后者提供IntelliJ风格的暗色/亮色主题，比如Darcula、Material系列。数据库驱动按常见做法引入：
<dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-j</artifactId> <version>8.0.33</version> </dependency>引依赖时注意：如果Maven下载慢，用项目自带的mvn-settings.xml走镜像仓库，命令是mvn -s mvn-settings.xml clean compile。已经引了依赖但代码里报红，大概率是IDE没有reimport，IDEA里点一下Maven面板的刷新按钮就好。
3.3 main 入口与事件调度线程：窗口弹不出来的排查顺序
Swing程序的入口main方法，标准写法是把窗口创建丢给SwingUtilities.invokeLater。核心原因：Swing组件不是线程安全的，所有UI操作都要在事件调度线程（EDT）里执行。常见的错误是在main里直接new JFrame、再往里填数据，界面复杂后容易出现绘制异常。
public class Main { public static void main(String[] args) { try { UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName()); } catch (Exception e) { e.printStackTrace(); } SwingUtilities.invokeLater(() -> new MainFrame().setVisible(true)); } }这段代码里，setLookAndFeel要在创建任何窗口之前执行，invokeLater负责把窗口创建任务放进EDT。窗口弹不出来的排查顺序我一般是这样：先看控制台有没有异常堆栈，有就顺着堆栈找；没有异常但窗口不出现，检查main里是否在setVisible之前做了耗时的数据库连接，那种写法会阻塞EDT，让窗口停留在"加载中"。这个项目的入口类名以源码实际为准，一般是Main或者带XXXFrame的启动类，找不到就看pom.xml里配置的mainClass。
3.4 UIManager.setLookAndFeel：摘掉网上的两行美化代码到底在哪写
项目摘要里给的UI美化方案是在每个有组件的文件构造函数中加入同样的代码：
try { UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName()); } catch (Exception e) { // TODO: handle exception }这段代码的作用是让Swing窗口跟随操作系统当前的外观风格，Windows下就是Windows风格，macOS下就是mac风格。放在构造函数里的好处是：即使某个子窗体是独立弹出的，它也会先设置外观再初始化组件，不会出现一个程序里两种皮肤。代价是重复调用setLookAndFeel会多次触发全局UI更新，窗口多时可能有一瞬间的闪烁。我的习惯是main入口设置一次就够，等遇到具体子窗体不生效时，再在那个类里单独补一段。如果你想要FlatLaf主题而不是系统外观，可以改成：
// 亮色主题 com.formdev.flatlaf.FlatLightLaf.setup(); // 或 IntelliJ 暗色主题 UIManager.setLookAndFeel(new com.formdev.flatlaf.intellijthemes.materialthemeuilite.FlatMaterialDarkerIJTheme());两种方式选一种即可，不要混着写，后设置的会覆盖前面的。答辩问起来就解释一句：FlatLaf是Swing的第三方外观库，靠UIManager注册，注册时机必须在组件创建之前。
4. JDBC 访问层实战：PreparedStatement、CRUD 与事务边界
4.1 DriverManager 还是连接池：先想清楚这个量级需要什么
JDBC连接MySQL，老生常谈的过程是四步：加载驱动、建立连接、执行SQL、关闭资源。这个项目是课程设计量级，单机演示、几十条数据、同时在线不超过几个人，用DriverManager完全够。连接池（HikariCP、DBCP）的价值在于复用连接、减少握手开销，但引入连接池意味着多学一套配置，答辩时还会被追问原理，没必要在这个阶段给自己加戏。
数据库连接的工具类我一般会封装成DBUtil，集中管理URL、账号、密码，避免每个DAO里都写一遍连接串：
public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/sm" + "?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8"; private static final String USER = "root"; private static final String PASSWORD = "123456"; public static Connection getConnection() throws SQLException { try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { throw new SQLException("MySQL驱动类找不到，请检查依赖", e); } return DriverManager.getConnection(URL, USER, PASSWORD); } }URL里三个参数各有用处：useSSL=false关掉SSL握手，减少报警告；serverTimezone=Asia/Shanghai告诉驱动服务器时区，不加的话MySQL8.0大概率报错；characterEncoding=UTF-8保证Java和MySQL之间中文传输不乱码。USER和PASSWORD换成你本机的账号密码。
4.2 商品表增删改查：数据库增删改查在 JDBC 里的完整写法
课程设计的核心逃不开数据库增删改查四个操作。以商品表为例，最常见的业务是模糊查询商品列表，SQL里用到LIKE和ORDER BY，这正好对应MySQL排序和条件检索两个基本功：
public List<Product> search(String keyword) { String sql = "SELECT id, name, price, stock FROM product WHERE name LIKE ? ORDER BY id"; List<Product> list = new ArrayList<>(); try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, "%" + keyword + "%"); try (ResultSet rs = ps.executeQuery()) { while (rs.next()) { Product p = new Product(); p.setId(rs.getInt("id")); p.setName(rs.getString("name")); p.setPrice(rs.getBigDecimal("price")); p.setStock(rs.getInt("stock")); list.add(p); } } } catch (SQLException e) { e.printStackTrace(); } return list; }这段代码把JDBC的标准动作走了一遍：prepareStatement预编译SQL、setString绑定参数、executeQuery查结果集、ResultSet逐行取值转成实体对象。ORDER BY id是对结果排序，商品列表一般按id或价格排序展示，你可以在ORDER BY后面换成price字段。try-with-resources保证三个资源全部自动关闭，这是Java7以后的标准写法，也最能体现编码习惯。
新增操作走的是executeUpdate，返回受影响行数，大于0说明成功：
public int insert(Product p) { String sql = "INSERT INTO product(name, price, stock) VALUES (?, ?, ?)"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, p.getName()); ps.setBigDecimal(2, p.getPrice()); ps.setInt(3, p.getStock()); return ps.executeUpdate(); } catch (SQLException e) { e.printStackTrace(); return 0; } }很多课程设计的功能清单就是这么一项项堆出来的：商品模块、供应商模块、订单模块，每个模块都是一套类似的DAO，区别只在SQL语句和实体字段。把商品表这一套吃透，其他表照猫画虎就行。
4.3 PreparedStatement 参数绑定：SQL 注入原理与 LIKE 排序查询
为什么非要用PreparedStatement？对比一下最原始的拼接写法和参数绑定写法：
// 错误示范：直接把用户输入拼进SQL String sql = "SELECT * FROM product WHERE name = '" + input + "'"; Statement st = conn.createStatement(); st.execute(sql); // 正确写法：? 占位 + setString 绑定 String sql = "SELECT * FROM product WHERE name = ?"; PreparedStatement ps = conn.prepareStatement(sql); ps.setString(1, input);拼接写法的问题在于：如果input是' OR '1'='1，拼出来的SQL变成WHERE name = '' OR '1'='1'，恒成立，等于把整张表查出来了；更狠的还能用--注释掉后面的条件，直接执行恶意改写。PreparedStatement的setString会把单引号转义，让这一段永远只是字符串字面量。这就是SQL注入的基本攻防，答辩被问到"为什么用PreparedStatement"，回答预处理防注入就够了。
另一个实用场景是批量插入，比如订单明细一次插入几十条，逐条executeUpdate会发起多次网络往返，批量则一次提交：
conn.setAutoCommit(false); try (PreparedStatement ps = conn.prepareStatement( "INSERT INTO order_detail(order_id, product_id, qty) VALUES (?,?,?)")) { for (OrderDetail d : details) { ps.setInt(1, orderId); ps.setInt(2, d.getProductId()); ps.setInt(3, d.getQty()); ps.addBatch(); } ps.executeBatch(); conn.commit(); } catch (SQLException e) { conn.rollback(); }addBatch把多条SQL攒在内存里，executeBatch一次性发送给MySQL执行。这里已经摸到了事务的边，下一节展开说。
4.4 结账事务：为什么扣库存和订单明细必须一起提交
数据库课程设计里最能体现"数据库事务处理"的业务点是结账：先扣商品库存，再写订单明细。如果两步分开执行，扣完库存后写明细时程序报错，库存已经少了，账就平不上。mysql事务处理和面试常考的一致性问题，在这个场景里天然成立。手动事务的标准骨架：
public void checkout(int orderId, List<CartItem> items) { Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); for (CartItem item : items) { // 扣库存，带库存充足条件，影响行数为0说明库存不够 try (PreparedStatement ps = conn.prepareStatement( "UPDATE product SET stock = stock - ? WHERE id = ? AND stock >= ?")) { ps.setInt(1, item.getQty()); ps.setInt(2, item.getProductId()); ps.setInt(3, item.getQty()); if (ps.executeUpdate() == 0) { throw new SQLException("库存不足: " + item.getProductId()); } } // 写订单明细 try (PreparedStatement ps = conn.prepareStatement( "INSERT INTO order_detail(order_id, product_id, qty) VALUES (?,?,?)")) { ps.setInt(1, orderId); ps.setInt(2, item.getProductId()); ps.setInt(3, item.getQty()); ps.executeUpdate(); } } conn.commit(); } catch (SQLException e) { if (conn != null) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } } throw new RuntimeException("结账失败: " + e.getMessage(), e); } finally { if (conn != null) { try { conn.setAutoCommit(true); conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }几个关键点：setAutoCommit(false)关闭自动提交之后，后面的UPDATE和INSERT都不会真正落库，直到显式commit；任何一步抛异常，rollback把这一批操作全部撤销；finally里恢复自动提交并关闭连接。扣库存的SQL里加了AND stock >= ?，用影响行数判断库存是否充足，这是单条UPDATE原子性的一个小技巧。答辩时这个类值得重点讲，比堆一百行界面代码更能拿分。
5. 翻车避坑实录：五个常见问题与修复命令
5.1 驱动加载失败：从 com.mysql.jdbc.Driver 到 cj 的改名
现象：程序一运行就抛ClassNotFoundException: com.mysql.jdbc.Driver，控制台堆栈指到Class.forName那一行。
原因：MySQL8.0的驱动包把类名从com.mysql.jdbc.Driver改成了com.mysql.cj.jdbc.Driver，旧类名在新版驱动里被移除。或者pom.xml里压根没引入mysql-connector-j依赖。
解决：先把依赖加进去，再改类名。验证依赖是否生效用Maven命令：
mvn dependency:tree | grep mysql输出了mysql-connector-j说明依赖解析成功，否则检查pom里是否写错artifactId或版本。代码里统一改成：
Class.forName("com.mysql.cj.jdbc.Driver");JDBC4之后其实可以省略Class.forName，驱动会通过SPI机制自动注册，但课程设计里写上这行没坏处，答老师问题还能多答一句。
5.2 中文乱码：GBK 源码与 UTF-8 控制台的三处对齐
现象：标题栏、按钮文字、查询出来的商品名全是问号或乱码符号。
原因：这个项目是GBK编码，你的IDEA和Maven编译时按UTF-8解读，中文字符串在编译阶段就解析错了，属于最恶劣的一种乱码。还有一种情况是源码没问题，但JDBC连接串没设置字符集，导致数据库里的中文从MySQL传到Java再显示到界面上时错位。
解决：按顺序排查三处。第一处IDEA的File Encodings，把Project Encoding、Properties Files都改成GBK，或者右下角快捷切换；第二处pom.xml加编译编码：
<properties> <project.build.sourceEncoding>GBK</project.build.sourceEncoding> </properties>第三处是连接串，保持characterEncoding=UTF-8即可，前提是MySQL表结构建在utf8mb4下。这层关系在2.3节说过：源码编码管编译，连接串字符集管传输，两件事别混在一起。如果直接用cmd运行，还要保证控制台代码页是936或65001，否则System.out打印中文到cmd照样乱。
5.3 FlatLaf 皮肤不生效：setLookAndFeel 的顺序问题
现象：写了UIManager.setLookAndFeel，窗口还是Swing默认的Metal灰皮肤，或者只有主窗体变了，弹窗还是老样子。
原因：setLookAndFeel调用太晚，窗口或者组件已经在它之前创建了。Swing的外观是全局状态，但组件创建时会读取一次当前外观并锁定，之后改也来不及。以及摘要给的catch块里只有注释没有处理，异常被吞掉，你根本不知道哪里失败。
解决：把setLookAndFeel移到main方法最前面，确保它是程序第一条UI相关代码。catch块里至少加上e.printStackTrace()，有没有生效一眼就知道。个别弹窗没生效时，在那个窗体的构造函数里再补一次调用，这是项目摘要里推荐的方式，适合组件分散的项目：
public LoginFrame() { try { UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName()); } catch (Exception e) { e.printStackTrace(); } initComponents(); }想用FlatLaf暗色主题就把UIManager那句换成UIManager.getSystemLookAndFeelClassName对应的主题类，在第3.4节已经给过代码。
5.4 SSL 警告和时区错误：连接串两个参数一次解决
现象：连接数据库时控制台刷出一长串SSL握手警告，或者直接报The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized。
原因：MySQL8.0服务端默认开启SSL，驱动连接时尝试协商加密连接，本地开发环境根本不需要；服务器时区未设定时，驱动不知道用哪个时区解析时间字段。
解决：连接串上加两个参数：
jdbc:mysql://localhost:3306/sm?useSSL=false&serverTimezone=Asia/Shanghai加上之后警告消失，时间字段也不会差8小时。如果你本机还用老版本MySQL5.7，serverTimezone参数可加可不加，但useSSL同样建议false。这个参数组合在搜索引擎里常年排在"jdbc连接mysql"相关问题前面，属于必修常识。
5.5 连接泄漏导致卡死：try-with-resources 收尾习惯
现象：程序刚启动一切正常，操作十几分钟后越来越卡，后台MySQL日志报Too many connections，用客户端连上去看到一堆Sleep状态的连接。
原因：每次操作都new了Connection，但没在finally里close。Swing事件监听器里每点一次按钮就开一个连接，开多了不还，MySQL最大连接数默认151，很快被耗尽。
解决：把所有DAO里的连接代码改成try-with-resources形式，Java7之后的语法，资源在代码块结束时自动close：
try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql); ResultSet rs = ps.executeQuery()) { // 业务逻辑 } catch (SQLException e) { e.printStackTrace(); }注意ResultSet如果没用到的场景，可以不写进try里，但Connection和PreparedStatement必须有。这个习惯养成了，不仅课设不卡，以后工作写代码也不会被连接池耗尽这种低级问题拖住。顺带检查一下DBUtil里PASSWORD有没有写死成别人的密码，课设源码被转手很多次，默认密码大概率不是你的。
6. 运行验证与加分改造：答辩前我常做的四步检查
6.1 四步验证清单
拿到这份源码后，我建议不要直接改功能，先按下面四步做一遍冒烟验证，确认环境的每个环节都通了，再往项目里加需求。每步都对应一个常见翻车点，宁可现在慢十分钟，不要在答辩现场丢人。
| 步骤 | 操作 | 预期结果 |
|---|---|---|
| 1 | 重新导入sm.sql脚本 | SHOW TABLES能看到商品、订单等核心表 |
| 2 | 清空target后执行mvn clean compile | 编译通过，控制台无乱码无编码警告 |
| 3 | 启动程序，走一遍登录、查询商品、添加购物车、结账 | 界面正常刷新，数据库记录产生变化 |
| 4 | 关闭程序重新启动，再登录查数据 | 上次操作的数据还在，说明落库成功 |
前两步验证构建链路，第三步验证CRUD和事务，第四步验证数据持久化。哪一步卡住了，卡点大概率对应第5章的某条避坑记录，直接查那一节的解决方式。
6.2 加分改造：把结账逻辑收进事务方法
如果时间允许，推荐做一个小改造：把结账的SQL操作全部收进第4.4节的checkout方法，并且故意制造一次失败来验证回滚。比如在写订单明细时抛一个运行时异常，然后去数据库看库存有没有变化，库存不动说明回滚生效。这个实验在答辩现场演示非常加分，比口头说"我用了事务"有说服力得多：
// 测试回滚：在循环里临时加一行，模拟写明细失败 if (orderId == 999) { throw new SQLException("模拟订单写入失败"); }跑一次看到库存没扣，再取消这行重新跑，库存正常减少，事务就证明有效了。
以前带过的学生里，有人答辩当天提前两小时还在改数据库密码，到了现场MySQL服务没启动，窗口都弹不出来。从那以后我每次拿到课设项目都强制走一遍"导入脚本、编译、启动、重启再连"四步，确认没有隐藏依赖才敢上台演示——环境问题是最不值得丢分的环节，但它真的能让人丢完所有的分。这份超市管理系统本身不复杂，把编码、驱动、事务这三件事理顺，你就能把力气花在加功能上。希望帮到你。
本文还有配套的精品资源，点击获取
