Java Swing二手商品管理系统实战：从JDBC到数据库设计全解析

1. 项目概述与选题价值

我是从大四做课设时开始接触 Swing 的，当时班里三十多个人，至少二十个选了“图书管理系统”或者“学生信息管理系统”，剩下的几个就是选了二手商品交易这种偏电商方向的主题。说实话，等到真正动手把“基于 Swing 的二手商品管理系统”从零到一完整落地之后，我才意识到这个选题比想象中要有意思得多——它几乎把 Java 基础语法、面向对象设计、集合框架、JDBC 数据库编程、事件监听机制、界面布局这些大学前两年学的东西全部串了一遍，而且业务上又是典型的 C 端应用场景，比单纯的学生管理要丰富不少。

很多人会问我，都什么年代了还用 Swing 做桌面应用？MVC 都过时了，现在不都是 Spring Boot 搭后端，Vue 写前端，再包一层 Electron 套壳吗？话虽然没错，但你要分清楚场景。如果是商业项目、工业级产品，我肯定不建议你碰 Swing；但如果是课程设计、毕业设计、或者想用最短的学习成本把 Java 核心知识串成一条完整的逻辑链，Swing 确实是一个非常合适的载体。首先，Swing 是 JDK 自带的东西，不需要额外安装任何依赖，写起来就能跑，环境配置成本几乎为零；其次，Swing 的事件驱动模型和观察者模式高度相关，理解清楚了对后续学 Android 或者 JavaFX 都有帮助；最后，桌面程序这种形态，天然比纯控制台程序更接近真实软件，用来练手“用户交互 + 数据持久化 + 业务逻辑”这套组合拳，再合适不过。

具体到“二手商品管理系统”这个题目，它的核心价值在于需求真实。二手交易在国内已经是个很大的市场，你买我卖、商品发布、下架、下单、库存变化、订单状态流转，这些业务逻辑和现在各类 C2C 电商平台是同构的。用 Swing 把它桌面化，本质上就是把真实业务做一次降维还原。整个系统的设计过程里，你得考虑用户怎么登录、商品怎么分类展示、买家怎么搜索筛选、卖家怎么管理自己发布的商品、订单状态怎么流转——这些思考不会因为技术栈老而失去意义，反而因为技术栈简单，把复杂度集中到了“如何设计出合理的业务流程”上。

这篇博文就基于我实际写过的一个完整项目来拆解。我会把项目的整体架构、功能模块的划分、数据库表的设计思路、核心功能的代码实现，以及开发过程中踩过的坑都写出来，给正在做课设、毕设，或者想系统练一遍 Java GUI 桌面应用开发的朋友一个可以直接参考的路线图。如果你是零基础，看这篇文章能帮你站在全局视角理解一个桌面项目到底是怎么搭起来的；如果你已经有基础，可以直接跳到第三章去看核心功能的实现细节和第四章的坑点总结。

2. 技术选型与整体架构

2.1 为什么用 Swing 而不是 JavaFX 或 Web 方案

在开始写代码之前，得先解决一个根本问题：技术上到底选哪条路。这个决定影响着整个项目的复杂度和开发周期。

第一，为什么不用 JavaFX？JavaFX 本身是个更好的桌面 UI 框架，支持 FXML 和 CSS 样式，界面能做到比 Swing 漂亮很多。但是问题也很明显，从 JDK 11 开始 JavaFX 已经从 JDK 中拆出来变成独立模块了，你得额外引依赖、配模块，对不少学校机房或者低版本 JDK 环境来说反而成了负担。Swing 虽然是老技术，但它跟随 JDK 一起发行，双击就能跑，这对课程设计和毕业设计场景是非常现实的考量。

第二，为什么不做成 Web 项目？Web 方案当然更贴近现代开发，但它的学习曲线更陡。你得同时搞定前端（HTML/CSS/JavaScript/Vue）和后端（Servlet/Spring Boot），还有跨域、会话管理、HTTP 协议这些附加知识。对于训练“Java 语言本身 + 面向对象思想 + 数据库操作能力”这些核心目标来说，Web 会把注意力分散掉。Swing 的优势是所见即所得，你写一个按钮，运行起来就是一个按钮，学习反馈链路极短，这对于巩固 Java 基础非常有帮助。

第三，从实际完成度角度讲，Swing 项目要做出一个“麻雀虽小五脏俱全”的系统，工作量是可控的。我见过很多同学做 Web 项目，光环境配置就折腾两周，最后数据库连不上、前端样式调不对、前后端交互出 Bug，系统核心功能反而没做完整。Swing 没有这些花哨的问题，你可以把精力全部集中在业务逻辑上。

2.2 技术栈与开发环境选型

我的建议方案是：JDK 8 + Swing + MySQL 8.0 + JDBC。这套组合有以下几个考虑：

• JDK 8 是目前大多数教材和课程使用的版本，语法层面已经支持 Lambda 表达式，而且 Swing 的稳定性在 JDK 8 上经过多年验证，网上遇到问题时查资料也方便。
• 数据库用 MySQL 8.0，它是目前市面上培训机构、学校机房最常见的版本之一。MySQL 的 SQL 语法比较标准，和你将来学习 MyBatis、Spring Data JPA 时用的数据库是同一个，知识有延续性。如果你的环境装不了 MySQL，也可以用 SQLite 替代——它不需要安装服务，只需要一个 jar 包和一个数据库文件。但 SQLite 在并发处理和复杂查询上和 MySQL 有差距，而且面试/答辩时用 MySQL 显得更正规。
• JDBC 直接写原生 SQL，不引入任何 ORM 框架。课设阶段不推荐上 MyBatis 或 Hibernate，原因是当你的核心目标是搞懂 Java 本身时，过早引入框架会带来“黑盒感”，出了问题你不知道底层到底发生了什么。

数据库连接我这里给两个方案：

1. 使用 DriverManager.getConnection 直接连接，适合代码量小的项目，简单直接。
2. 使用数据库连接池（如 HikariCP、Druid），适合数据访问量大的项目。虽然课设项目一般到不了需要连接池的并发量，但用了连接池更容易体现你的系统思维，答辩时是一个加分项。连接池的本质就类似银行柜台，没有连接池时每次存取款都要新建柜台（建立连接），用完就拆掉；有了连接池就相当于常驻几个柜台排队做事，效率自然更高。

整体架构上，我做的是轻量级分层：视图层（View）负责界面展示和事件监听，业务逻辑层（Service）负责处理业务规则，数据访问层（DAO）负责和数据库打交道。这套分层模型在 Java Web 里也存在，只不过 Swing 里呈现得更直白。认真按分层去写代码，复查和修改时可以少掉很多头发。

2.3 项目目录结构与代码组织

这是我在实际项目中用过的包结构，你可以直接照搬：

code复制com.secondhand
├── Main.java                  // 启动类，负责设置 LaF 和拉起登录窗口
├── view                     // 界面层：LoginFrame、RegisterFrame、MainFrame 等
├── service                  // 业务逻辑层：UserService、ProductService、OrderService
├── dao                      // 数据访问层：UserDao、ProductDao、OrderDao
├── model                    // 实体类：User、Product、Order、CartItem
├── util                     // 工具类：DBUtil（获取数据库连接）、ImageUtil 等
└── listener                 // 自定义事件监听器（如果需要）

分层的实际感受是：当我发现查询商品列表时数据不对，我只需要去 ProductDao 里检查 SQL；当我发现下单时库存没扣减，我只去 OrderService 里检查事务逻辑；当我发现按钮点了没反应，我直接去对应 View 里看监听器有没有注册。如果全部代码糊在一个类里，错误定位会非常痛苦。

3. 数据库设计与核心功能模块拆解

一个系统的“底子”好不好，数据库设计占了很大比重。二手商品管理系统的实体并不复杂，但表与表之间的关系如果理不清，后面写业务代码都是空中楼阁。我在这里直接把完整的建表方案展示出来，然后逐个模块说明业务逻辑。

3.1 数据库表结构设计

用户表 t_user

密码加密这个点必须要强调。很多课设项目直接存明文密码，答辩时老师随便看一眼数据库就能挑出毛病。我建议用 JDK 自带的 MessageDigest 对密码做 SHA-256 哈希，再加上一个随机盐值。这样即使数据库泄露了，密码也不会直接暴露。

商品表 t_product

注意 status 这个字段。很多第一次做这个项目的人会直接把商品设计成“存在即展示”，但实际上一个商品在它的生命周期里会有三种状态：在售、下架、已售出。如果不设计状态字段，当买家下单完成后，商品会同时出现在多个买家的界面上，就会闹出超卖的笑话。

订单表 t_order

收藏表 t_favorite

实际开发时还能加一个 t_category 表来做商品分类的动态管理，但我个人认为课设级别用固定枚举值（写死在代码里）就够了，没必要了一张表。加表虽然数据更规范，但代码里要多好几层关联查询，复杂度有点得不偿失。

3.2 用户模块：注册、登录与安全存储

用户模块是一个系统的“入口”，几乎所有的业务操作都要求用户先登录。Swing 里实现登录界面很简单，两个 JTextField 加两个 JPasswordField 加一个按钮就行。但有几个细节值得注意：

第一，登录验证不能放在界面里。有些同学图省事，在 LoginFrame 里直接写 jdbc:mysql://... 连数据库查密码，界面层和数据访问层全混在一起。正经做法是：LoginFrame 拿到用户名和密码后，把参数传给 UserService.login(username, password)，由 Service 调用 UserDao 查询数据库，返回一个 User 对象；登录成功则跳转主界面，登录失败则在界面上弹出错误提示。

第二，登录状态要保留到全局。我建议写一个简单的 SessionUtil，用一个静态变量保存当前登录用户的信息，类似 Web 项目中的 Session 概念。这样商品发布模块才能知道“当前登录的是谁”，商品列表才能根据登录者身份展示“我的发布”还是“全部商品”。

第三，注册时的密码重复校验和用户名查重一定要做。很多人把这些校验放在数据库中靠主键或唯一索引去挡，结果报错信息是一串看不懂的 SQL 异常。更友好的方式是：在用户点击“注册”按钮时，先调 UserDao.findByUsername(username) 判断用户名是否已被占用，提前给出友好提示，再执行插入操作。

3.3 商品模块：发布、浏览与上下架

商品模块是整个系统的内容核心。我按照用户的使用路径把它拆成四个子功能：

商品发布。表单包括标题、描述、分类（下拉框）、成色、价格、原价、图片路径。图片一般有两种做法：一是用户手动输入图片文件路径，二是在界面上加一个“选择图片”按钮，通过 JFileChooser 选择图片文件后复制到项目指定目录，再把相对路径存到数据库。第二种明显更友好，我强烈推荐。注意，价格输入框要校验用户输入的是否为合法数字、是否大于 0，不然 JTable 里显示价格时会直接报错。

商品列表展示。Swing 里展示列表数据最常见的组件是 JTable，配合 DefaultTableModel 使用。商品列表的刷新要遵循“查库 → 转成二维数组 → 刷新表格模型”的流程。有一点要注意：商品图片在 JTable 的单元格中一般显示为缩略图路径文字或者一个小的 ImageIcon，如果你想显示缩略图，需要自定义 TableCellRenderer，这是 Swing 中比较容易卡住新手的点。我的建议是：课设阶段在表格里先显示“查看图片”按钮，点击后弹出一个新的 JDialog 展示大图，省去自定义渲染器的复杂性。

商品搜索与筛选。搜索功能一般根据商品标题做模糊查询，SQL 里使用 LIKE '%关键字%'。同时可以做一个分类下拉框，配合搜索关键字组合查询。从用户体验角度讲，搜索框应该支持回车键触发搜索，这就需要给输入框注册键盘事件，KeyListener 或者 ActionListener 都可以。

商品下架与管理。这个功能在“我的发布”界面里实现。卖家可以看到自己发布的所有商品及其状态，选择“下架”后该商品不再出现在公共商品列表中；选择“重新上架”则恢复在售状态。核心逻辑就是更新 t_product.status 字段。

3.4 订单模块：从下单到订单状态流转

订单模块是整个系统业务逻辑最复杂的部分，也是最体现设计功力的地方。

买家在商品详情页点击“立即购买”后，系统需要做四件事：

1. 校验商品是否存在且在售状态；
2. 创建一个订单记录，状态为“待付款”；
3. 更新商品状态为“已售出”；
4. 同时考虑到现实中可能还有“取消订单”的情况，所以订单状态要有回退机制。

这里有个重要的业务原则：操作数据库的多个步骤必须在一个事务里完成。如果只创建了订单，却没有把商品状态改成“已售出”，那么其他用户仍然可以看到该商品并购买，就会产生一物多卖的严重问题。JDBC 里的事务写法很多人会忽略，核心代码是：

java复制Connection conn = null;
try {
    conn = DBUtil.getConnection();
    conn.setAutoCommit(false);  // 关闭自动提交，开启事务

    // 1. 检查商品状态
    // 2. 插入订单记录
    // 3. 更新商品状态
    
    conn.commit();  // 全部成功才提交
} catch (SQLException e) {
    conn.rollback();  // 任何一步失败，回滚到初始状态
    throw new RuntimeException("下单失败，请稍后重试", e);
} finally {
    DBUtil.close(conn);
}

如果你在这个环节用数据库连接池，还能额外体现一个细节：同一个连接提交事务时要保证 getConnection 拿到的是同一个对象。自己操作时注意不要把 DriverManager.getConnection 写在 DAO 里，因为每个 DAO 都是独立拿连接，事务就失效了。我当初就踩过这个坑，下完单结果商品状态没变，查了好半天才明白是多个连接导致事务根本没生效。

订单状态的展示我建议用 JTabbedPane 做一个多标签页界面：全部订单、待付款、已付款、已完成。点击不同标签时按订单状态过滤展示，这样界面结构清晰，代码也不算复杂。

3.5 辅助功能：收藏与个人中心

收藏功能本质上是对“用户-商品”多对多关系的处理。用户在商品详情页点击“收藏”按钮，系统先检查 t_favorite 表里有没有记录，没有则新增；再点击则取消收藏。个人中心可以看到收藏列表，点击列表项可跳转到商品详情。

关于收藏这个功能，很多课设项目做成了“只增不减”，这个很不好。二手商品交易场景里，用户收藏后可能会找到更好的商品，会想移除收藏，如果做不到位，体验上就差了一大截。

个人中心只需要展示当前用户的基本信息，同时提供“修改个人信息”“修改密码”“我的发布”“我的订单”等入口。修改密码时要校验旧密码是否正确、新密码是否两次输入一致，这些都属于看起来简单但很容易遗漏的逻辑。

4. 核心代码实现与界面开发实操

4.1 数据库连接工具类的编写

数据库连接是所有模块的基础。我会在 util 包里建一个 DBUtil 类，用静态代码块加载驱动，提供获取连接和关闭连接的方法：

java复制package com.secondhand.util;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

public class DBUtil {
    private static final String URL = "jdbc:mysql://localhost:3306/secondhand_db?useSSL=false&serverTimezone=Asia/Shanghai";
    private static final String USER = "root";
    private static final String PASSWORD = "123456";

    static {
        try {
            Class.forName("com.mysql.cj.jdbc.Driver");
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
            throw new ExceptionInInitializerError("MySQL驱动加载失败，请检查是否已导入驱动包");
        }
    }

    public static Connection getConnection() throws SQLException {
        return DriverManager.getConnection(URL, USER, PASSWORD);
    }

    public static void close(ResultSet rs, PreparedStatement ps, Connection conn) {
        if (rs != null) {
            try { rs.close(); } catch (SQLException ignored) {}
        }
        if (ps != null) {
            try { ps.close(); } catch (SQLException ignored) {}
        }
        if (conn != null) {
            try { conn.close(); } catch (SQLException ignored) {}
        }
    }
}

注意 serverTimezone=Asia/Shanghai 这个参数，MySQL 8.0 如果缺了会报时区错误，刚上手的人很容易卡在这一步。另外如果 Class.forName("com.mysql.jdbc.Driver") 报类找不到，说明用的是 MySQL 8 以上的驱动包，要改成 com.mysql.cj.jdbc.Driver。

4.2 登录模块的完整实现逻辑

登录窗口的构建没有太多花活，核心就在“点击登录”按钮时的事件处理。我直接给出关键代码：

java复制// 登录按钮的 ActionListener
loginButton.addActionListener(e -> {
    String username = usernameField.getText().trim();
    String password = new String(passwordField.getPassword());
    
    // 前端基础校验，避免空参数直接打到数据库
    if (username.isEmpty() || password.isEmpty()) {
        JOptionPane.showMessageDialog(LoginFrame.this, "用户名和密码不能为空！");
        return;
    }
    
    UserService userService = new UserService();
    User user = userService.login(username, password);
    if (user != null) {
        // 保存全局登录状态
        SessionUtil.setCurrentUser(user);
        JOptionPane.showMessageDialog(LoginFrame.this, "登录成功，欢迎 " + user.getNickname() + "！");
        // 进入主界面
        new MainFrame().setVisible(true);
        // 关闭当前窗口
        dispose();
    } else {
        JOptionPane.showMessageDialog(LoginFrame.this, "用户名或密码错误！");
    }
});

4.3 商品列表与图片展示的实现细节

商品列表是用户打开系统后最先看到的界面，我使用 JTable 来展示数据库中的商品数据。核心逻辑是将 List<Product> 转换成表格二维数组，再交给 DefaultTableModel：

java复制// 查询在售商品列表
List<Product> productList = productService.getOnSellProducts();
String[] columns = {"商品ID", "标题", "分类", "价格", "发布者", "上架时间"};
Object[][] data = new Object[productList.size()][columns.length];
for (int i = 0; i < productList.size(); i++) {
    Product p = productList.get(i);
    data[i][0] = p.getId();
    data[i][1] = p.getTitle();
    data[i][2] = p.getCategory();
    data[i][3] = p.getPrice();
    data[i][4] = p.getSellerName();  // 注意这里需要连表查出用户名
    data[i][5] = p.getCreatedAt();
}
DefaultTableModel model = new DefaultTableModel(data, columns);
productTable.setModel(model);

这里有个很多人踩的坑：JTable 修改了模型之后，界面不会自动刷新，需要手动调用 model.fireTableDataChanged() 或者重新 setModel。如果你在商品发布后回到列表页发现数据没变，大概率就是忘了刷新表格模型。

展示商品图片我用的是“单元格内嵌缩略图 + 点击查看大图”的方案。具体实现如下：

java复制// 为表格添加鼠标监听，检测双击事件
productTable.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        if (e.getClickCount() == 2) {  // 双击
            int row = productTable.getSelectedRow();
            if (row != -1) {
                int productId = (int) productTable.getValueAt(row, 0);
                Product product = productService.getProductById(productId);
                showProductDetail(product);  // 弹出详情/购买窗口
            }
        }
    }
});

4.4 商品发布界面与图片选择

发布商品界面中，分类用 JComboBox，价格用 JTextField，图片路径用 JTextField + JButton 组合。点击按钮时弹出文件选择器：

java复制chooseImageButton.addActionListener(e -> {
    JFileChooser chooser = new JFileChooser();
    chooser.setFileFilter(new FileNameExtensionFilter("图片文件(*.jpg, *.png)", "jpg", "png", "jpeg", "gif"));
    int result = chooser.showOpenDialog(PublishFrame.this);
    if (result == JFileChooser.APPROVE_OPTION) {
        File selectedFile = chooser.getSelectedFile();
        // 将图片复制到项目的 /images 目录
        String targetPath = "images/" + System.currentTimeMillis() + "_" + selectedFile.getName();
        try {
            Files.copy(selectedFile.toPath(), Paths.get(targetPath));
            imagePathField.setText(targetPath);
        } catch (IOException ex) {
            JOptionPane.showMessageDialog(PublishFrame.this, "图片复制失败: " + ex.getMessage());
        }
    }
});

发布时的价格校验也要单独写：

java复制try {
    double price = Double.parseDouble(priceField.getText().trim());
    if (price <= 0) {
        JOptionPane.showMessageDialog(PublishFrame.this, "价格必须大于0！");
        return;
    }
} catch (NumberFormatException ex) {
    JOptionPane.showMessageDialog(PublishFrame.this, "价格格式不正确，请输入数字！");
    return;
}

4.5 主界面的菜单栏设计

主界面我用的是一个 JFrame + 菜单栏 + 多个内部面板切换的布局。菜单栏设计如下：

• 首页：展示在售商品列表（JTable + 搜索框）
• 发布商品：打开发布窗口
• 我的发布：当前用户发布的所有商品，可下架/上架/编辑
• 我的订单：包含我买到的和卖出的订单
• 我的收藏：展示收藏列表
• 个人中心：修改个人信息、修改密码、退出登录

切换页面我推荐使用 CardLayout（卡片布局）。这块布局管理器是一个容器中放多张“卡片”，每次只显示其中一张，非常适合做多页面的单窗口应用。

5. 开发过程复盘与重要经验

5.1 正确的时间分配和开发顺序

我做这个项目时总耗时大概三周，前面浪费了不少时间在纠结“要不要用框架”上。回头复盘，如果重新做一遍，我会把节奏调整成这样：

第一周做完需求分析和数据库设计。不要急着写代码，先用纸把实体关系图画清楚，把所有界面原型画出来。可能你会觉得这样很慢，但实际写代码时会发现，因为界面想清楚了，几乎不会出现“写到一半不知道接下来功能怎么接”的情况。

第二周集中写完用户模块和商品模块。用户注册登录是基础，商品发布和列表展示是核心，把这两个模块做到可以流畅运行，系统就完成了 60%。

第三周完成订单模块、收藏模块、个人中心，再花一天整体测试联调，修 Bug。

很大一部分人做课设喜欢从第一个界面写到底，写到哪算哪，结果代码写到后面逻辑全乱了。有结构有节奏地推进，体验完全不一样。

5.2 界面卡顿问题的定位与优化

界面卡顿几乎是 Swing 项目绕不开的问题。我在做商品列表刷新时也遇到过：点击查询按钮后，整个窗口会“假死”一两秒。刚开始以为是数据量大，后来排查才发现原因没那么简单——我在事件分发线程（EDT）中直接执行了数据库查询操作。

Swing 是单线程模型，所有界面刷新和事件处理都在 EDT 上运行。如果在这个线程里执行耗时的数据库查询或文件 IO，界面就会被阻塞。解决方案是使用 SwingWorker 做后台任务：

java复制SwingWorker<List<Product>, Void> worker = new SwingWorker<>() {
    @Override
    protected List<Product> doInBackground() throws Exception {
        // 在后台线程中执行数据库查询
        return productService.getOnSellProducts();
    }

    @Override
    protected void done() {
        try {
            List<Product> products = get();
            // 拿到结果后再回到 EDT 刷新表格
            updateTable(products);
        } catch (Exception ex) {
            JOptionPane.showMessageDialog(MainFrame.this, "查询失败: " + ex.getMessage());
        }
    }
};
worker.execute();

5.3 删除还是逻辑删除

开发后台管理功能时，很多人习惯用 DELETE FROM 直接把记录删除。但在二手商品系统里，订单和商品记录千万不能物理删除。商品虽然下架了，但已经发生的交易记录仍然需要保留，不然卖家对账、买家查看历史订单都会出问题。所以我在设计时用了一个统一的逻辑删除方案：凡是标注了“删除”的地方，本质上都是更新状态字段（status 或 is_deleted），而不是真的从数据库里抹掉记录。

举个例子：卖家删除自己某件“已售出”的商品，逻辑上只是把 status = 1（已下架），而不是把 t_product 里的记录删掉。这样订单表里关联的商品信息还能查到。按这个思路做，就算之后你把这个系统迁移到 Web 端，或者接入了 MyBatis Plus，逻辑也是通的，因为批量逻辑删除本身就是企业级项目的标准做法。

5.4 不存在“值不值得”的纠结

最后想说一句：不要因为 Swing 老就觉得做了没价值。技术是有生命周期的，但思维没有。你在设计状态流转、设计事务、设计分层的时候训练出来的工程思维，换任何语言、任何框架都是能带走的。

6. 常见问题与排查技巧

我把实际开发中高频出现的问题和排查思路整理成一份速查表，看到什么现象、可能是什么原因、按什么思路排查，一目了然。

6.1 中文乱码的真凶与预防

中文乱码是 Swing 项目最高频的问题之一。主要出在三个环节：

• 数据库层面：建库时没指定 utf8mb4，导致汉字写入后变成问号。
• Java 文件编码层面：IDE 默认编码不是 UTF-8。如果你用 Eclipse，记得在 Window → Preferences → General → Workspace 里把编码改成 UTF-8；用 IDEA 的话，在 Settings → Editor → File Encodings 里设置。
• 连接 URL 层面：JDBC URL 中要加 characterEncoding=utf8 参数。

我建议在最开始建库时就固定好编码，代码如下：

sql复制CREATE DATABASE secondhand_db 
DEFAULT CHARACTER SET utf8mb4 
COLLATE utf8mb4_unicode_ci;

6.2 JTable 双击行取数据的坑

JTable 点击行的事件处理非常容易出错。如果你直接监听表格的 MouseListener，要注意 表头点击也会触发事件 的问题。表头的行号是 -1，如果不做判断直接取数据，会报 ArrayIndexOutOfBoundsException：

java复制productTable.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        int row = productTable.getSelectedRow();
        int col = productTable.getSelectedColumn();
        if (row == -1 || col == -1) {
            return;  // 用户点击的是空白区域或表头
        }
        // 正常处理...
    }
});

6.3 后端字段脱节引发的页面报错

数据库字段改了，但代码里的实体类没同步，这是开发中会反复出现的低级错误。比如数据库里把 description 字段改成 remark，但 Product.java 里还在用 getDescription()，运行时就报 SQLException: Unknown column 或者 NullPointerException。避免方法很笨但有效：每改一次数据库表结构，就在实体类里对着字段名逐一检查一遍。

7. 项目扩展方向

如果你的课设做完还想让项目“看起来更有分量”，可以在现在的基础上加几个扩展点，投入产出比很高：

1. 加入统计报表面板：用 JPanel 自绘饼图或柱状图，展示各分类商品数量占比。用 Graphics2D 画图不需要额外引库，也不难，但视觉效果很好，答辩时很容易给老师留下印象。
2. 增加商品留言/评价功能：额外建一张 t_comment 表，关联商品 ID 和用户 ID。这个功能可以在订单完成后进行，模拟真实电商的售后体验。
3. 支持多条件高级筛选：按价格区间、成色、发布时间组合查询。SQL 层面就是动态拼接 WHERE 条件，考验你对 PreparedStatement 的掌握程度。
4. 把界面风格换成 Nimbus 或自定义 LaF：Swing 自带的 Metal 风格比较老旧，设置一行代码就可以换成 Nimbus：

java复制try {
    UIManager.setLookAndFeel("javax.swing.plaf.nimbus.NimbusLookAndFeel");
} catch (Exception e) {
    e.printStackTrace();
}

仅这一行代码，整个界面的观感就会有质的提升。

8. 写在最后：按自己的节奏把项目做踏实

做这类桌面管理系统，真正难的不是某一个控件用法，也不是某一条 SQL 怎么写，而是把一个模糊的题目拆成清晰的需求、再把需求变成代码的整个过程。你在这个项目里会体会到什么是事务，什么是状态流转，什么是分层思想，什么是用户交互设计。这些知识放到任何现代技术栈里依然成立。

如果你正在做或者即将开始做 Swing 项目，我建议你按这个顺序去推进：数据库设计 → 工具类 → 实体类 → 用户模块 → 商品模块 → 订单模块 → 辅助模块 → 界面美化与测试。不要一上来就扑进代码里，先用一天时间把表结构和页面原型想明白，后面会顺畅很多。遇到 Bug 也不要慌，控制台会告诉你答案，打断点看变量值永远比干瞪眼要快。

最后再分享一个我做项目时的习惯：每天开始写代码之前，花十分钟看一眼昨天的代码，注释自己想不清楚的地方。这样做的好处是，你永远知道自己的系统处于什么状态，不会出现写到最后连自己都看不懂的情况。把这套习惯坚持下去，做出来的不只是这一个项目，更是未来做任何开发工作的底气。