简介基于Java Swing与MySQL数据库通过JDBC完成数据交互的人事管理系统面向数据库课程设计场景适合需要完成课设或学习桌面应用数据操作的读者提供带图形界面的可运行示例。压缩包共24个文件包含12张PNG运行界面截图、11个Java源码文件和1个SQL数据库脚本整体大小仅143KB结构紧凑PNG截图用于直观查看界面效果Java文件展示分层代码逻辑SQL脚本用于快速建表与初始化数据。目前已有3878人学习或下载常被用作课程设计参考项目。源码覆盖JDBC连接、员工信息增删改查等功能SQL脚本可独立运行因不同数据库版本可能引发基础报错这恰可帮助读者掌握环境配置与常见异常排查思路适合作为入门级课设方案或练手素材。1. 人事管理系统课设为什么绕不开 Java Swing 这一套数据库课程设计最卡人的地方往往不是 SQL 写不出来而是「怎么把增删改查变成一个能双击运行、能点按钮、能被老师一眼看懂的桌面程序」。Java Swing MySQL JDBC 这条链路恰好把缺口补上了Swing 负责窗口和表单JDBC 负责和 MySQL 对话中间不需要引入 Spring、MyBatis 这类框架课程设计的验收场景下反而更稳。这篇文章我就按自己做过的方案从建表、连库、写界面到排错把一套完整的人事管理系统拆开讲适合正在做课设的学生也适合想把 JDBC 基础链路重新捋一遍的从业者。2. 数据库设计先行员工/部门两张表和 JDBC 连接的取舍做任何管理系统最忌讳一上来就写界面。Swing 界面改起来成本高数据库表一旦定型后面所有功能都得围着它转。人事管理系统的核心就两类数据员工和部门。先把这两张表设计清楚后面的增删改查才有着落。2.1 人事管理系统最少需要几张表一个能正常演示的人事管理系统最少两张表部门表和员工表。员工表通过外键关联部门表这样一个员工必然归属一个部门查询时用 JOIN 就能把部门名称带出来。CREATE DATABASE hrms DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE TABLE department ( dept_id INT PRIMARY KEY AUTO_INCREMENT, dept_name VARCHAR(50) NOT NULL UNIQUE ); CREATE TABLE employee ( emp_id INT PRIMARY KEY AUTO_INCREMENT, emp_name VARCHAR(30) NOT NULL, gender CHAR(2), dept_id INT, position VARCHAR(50), salary DECIMAL(10,2), hire_date DATE, FOREIGN KEY (dept_id) REFERENCES department(dept_id) );数据库字符集这里我给的是utf8mb4不是utf8。MySQL 的utf8实际是 utf8mb3存 emoji 或者个别生僻字会直接报错或者变问号课设答辩现场出这种问题非常尴尬直接用 utf8mb4 从源头规避。DECIMAL(10,2)存工资别用 FLOAT 或 DOUBLE浮点数的精度误差在金额上会积累出不该有的小数位。部门表加一条初始数据不然员工表的外键没有可选范围INSERT INTO department (dept_name) VALUES (技术部), (人事部), (财务部);2.2 JDBC 连接参数时区、SSL、驱动版本怎么配JDBC 连接 MySQL 的代码量不大但参数配错会浪费大量时间。Maven 里加依赖或者在项目 lib 目录下放 mysql-connector-java 的 jar 包。这里以 MySQL 8.x 配 mysql-connector-java 8.0.x 为例dependency groupIdcom.mysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency连接 URL 是我调试过很多次之后固定的写法String url jdbc:mysql://localhost:3306/hrms ?useSSLfalse serverTimezoneAsia/Shanghai characterEncodingutf8 allowPublicKeyRetrievaltrue;三个参数的作用要清楚useSSLfalse关闭 SSL 握手本机调试不需要加密通道能省掉一堆证书告警serverTimezoneAsia/Shanghai告诉驱动用东八区解析时间不然 MySQL 8 会报The server time zone value CST的错allowPublicKeyRetrievaltrue是为了应对 MySQL 8 的caching_sha2_password认证插件首次连接需要从服务器取公钥不设这个参数在某些环境会直接Public Key Retrieval is not allowed。2.3 连接要不要用池课程设计场景的答案常见做法是不用连接池写一个 DBUtil 工具类每次操作拿一个 Connection用完关掉。课程设计的数据量撑不起连接池的必要性引入 C3P0 或 HikariCP 反而增加答辩时「你为什么用这个」的追问成本。我一般这样写public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/hrms ?useSSLfalseserverTimezoneAsia/Shanghai characterEncodingutf8allowPublicKeyRetrievaltrue; 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(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } public static void close(AutoCloseable... resources) { for (AutoCloseable r : resources) { if (r ! null) { try { r.close(); } catch (Exception ignored) { } } } } }Class.forName(com.mysql.cj.jdbc.Driver)在 JDBC 4.0 之后可以省略但保留它有两个好处一是让答辩老师一眼看出驱动加载的入口二是某些 IDE 或打包环境确实需要显式加载。注意 8.x 的驱动类名是com.mysql.cj.jdbc.Driver不是老版本的com.mysql.jdbc.Driver写错就是ClassNotFoundException。close(AutoCloseable...)是可变参数写法Connection、Statement、ResultSet 都实现了 AutoCloseable调用时按顺序往里传就好。3. 登录与主界面用 Swing 搭出可演示的 GUI 框架数据库设计好了接下来面对的是一道选择题先做登录还是先做员工管理我的经验是先做登录。登录界面能验证 JDBC 链路是否通也能把主界面的框架先立起来后面往里面填功能就顺了。3.1 登录窗体从文本框到密码校验的完整流程登录窗体的布局不复杂两个 JLabel、两个 JTextField、一个 JButton密码框用 JPasswordField。核心逻辑在按钮的 ActionListener 里先用输入的账号密码去 user 表查记录查到了才打开主界面。public class LoginFrame extends JFrame { private JTextField usernameField; private JPasswordField passwordField; public LoginFrame() { setTitle(人事管理系统登录); setSize(360, 220); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); JPanel panel new JPanel(new GridLayout(3, 2, 10, 10)); usernameField new JTextField(); passwordField new JPasswordField(); JButton loginBtn new JButton(登录); panel.add(new JLabel(用户名)); panel.add(usernameField); panel.add(new JLabel(密码)); panel.add(passwordField); panel.add(new JLabel()); panel.add(loginBtn); loginBtn.addActionListener(e - doLogin()); setContentPane(panel); } private void doLogin() { String username usernameField.getText().trim(); String password new String(passwordField.getPassword()); String sql SELECT * FROM user WHERE username ? AND password ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { new MainFrame().setVisible(true); dispose(); } else { JOptionPane.showMessageDialog(this, 用户名或密码错误); } } } catch (SQLException ex) { ex.printStackTrace(); JOptionPane.showMessageDialog(this, 数据库连接失败: ex.getMessage()); } } }new String(passwordField.getPassword())是为了把 char 数组转成 StringJPasswordField 的getText()已经被标记为过时不建议用。SQL 语句里用?占位符配合PreparedStatement这是课设里必须养成的习惯直接字符串拼接账号密码等于把 SQL 注入的漏洞写进作业里答辩老师一眼就能看出来。登录成功后dispose()关掉登录窗口避免多个窗口重叠。3.2 主窗体的内部窗口布局主界面我推荐JDesktopPane JInternalFrame组合。这样做的好处是员工管理、部门管理可以各自开一个内部窗口关闭其中一个不影响主程序比较接近真实桌面应用的体验。菜单栏用 JMenuBar点击菜单项弹出对应的 JInternalFrame。public class MainFrame extends JFrame { private JDesktopPane desktop; public MainFrame() { setTitle(人事管理系统); setSize(900, 600); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); desktop new JDesktopPane(); setContentPane(desktop); JMenuBar menuBar new JMenuBar(); JMenu systemMenu new JMenu(系统管理); JMenuItem empItem new JMenuItem(员工信息管理); JMenuItem deptItem new JMenuItem(部门信息管理); JMenuItem logoutItem new JMenuItem(退出登录); empItem.addActionListener(e - openInternalFrame(EmployeePanel.class)); deptItem.addActionListener(e - openInternalFrame(DeptPanel.class)); logoutItem.addActionListener(e - { dispose(); new LoginFrame().setVisible(true); }); systemMenu.add(empItem); systemMenu.add(deptItem); systemMenu.addSeparator(); systemMenu.add(logoutItem); menuBar.add(systemMenu); setJMenuBar(menuBar); } private void openInternalFrame(Class? extends JInternalFrame clazz) { for (JInternalFrame f : desktop.getAllFrames()) { if (f.getClass() clazz) { f.toFront(); return; } } // 通过反射创建对应的内部窗口 } }openInternalFrame的防重复逻辑算是主讲人常提的小技巧desktop.getAllFrames()遍历已有窗口同类型窗口已经打开就把它调到前面不重复创建。反射部分建议直接new EmployeePanel()和new DeptPanel()分开写课设场景下代码直白比什么都重要。JDesktopPane 的层级在内部窗口setVisible(true)后会自动处理不需要额外调用moveToFront。3.3 登录表与用户表的设计边界登录账号不应该塞进 employee 表。员工表和 user 表是两个语义员工是业务数据账号是系统权限数据。如果觉得建两张表麻烦有些人会把账号密码直接写在 employee 表里加两个字段这会导致删除员工时账号也没了或者重置密码时误改员工信息。我的建议是单独建一张user表字段就三个id、username、password预置一个管理员账号CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(30) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL ); INSERT INTO user (username, password) VALUES (admin, 123456);正式项目里密码要加盐哈希课程设计如果不想引入额外复杂度至少做到不在代码里硬编码账号。把初始化数据放进 SQL 脚本里答辩时打开数据库能看到账号从哪来比在代码里写if (admin.equals(username))要体面得多。4. 员工信息 CRUDPreparedStatement 与 JTable 刷新联动人事管理系统的核心功能就是员工信息的增删改查。这部分做好了整个课设的骨架就立住了。难点不是写 SQL而是把数据库的数据实时刷新到 JTable 上以及处理编辑后保存的联动问题。4.1 查询ResultSet 填充 JTable 的两种选择JTable 本身不带数据它依赖 TableModel。课程设计里最常碰到的直接做法是拿DefaultTableModel一行行addRow代码短但每次刷新都要重新构造模型。更省事的方案是写一个通用的转换方法把 ResultSet 直接变成二维数组和列名数组public static Object[][] rsToArray(ResultSet rs) throws SQLException { ResultSetMetaData meta rs.getMetaData(); int colCount meta.getColumnCount(); ListObject[] rows new ArrayList(); while (rs.next()) { Object[] row new Object[colCount]; for (int i 0; i colCount; i) { row[i] rs.getObject(i 1); } rows.add(row); } return rows.toArray(new Object[0][]); }列名用ResultSetMetaData动态获取这样写的好处是换表的时候连方法都不用改只换 SQL。rs.getObject(i 1)拿到的是 JDBC 映射后的 Java 对象DECIMAL会变成BigDecimalDATE会变成java.sql.Date直接塞进 JTable 都能正常显示。代价是显示效果没有手工定制列名那么精细所以实际项目中常常两种方式混合通用方法负责快速出数据手工方法负责美化显示。4.2 新增和修改先拼 SQL 还是先做校验表单里放姓名、性别、部门、岗位、工资、入职日期几个输入框点保存按钮的时候我一般先做一轮「有没有空值、日期格式对不对」的校验再执行 SQL。注意性别用 JComboBox部门也用 JComboBox这样能挡住一大部分脏数据。保存方法里增和改可以合并逻辑用一个标志位区分private void saveEmployee(boolean isUpdate) { String empName nameField.getText().trim(); String gender genderBox.getSelectedItem().toString(); String position positionField.getText().trim(); String salary salaryField.getText().trim(); String hireDate dateField.getText().trim(); if (empName.isEmpty() || position.isEmpty()) { JOptionPane.showMessageDialog(this, 姓名和岗位不能为空); return; } String sql; if (isUpdate) { sql UPDATE employee SET emp_name?, gender?, dept_id?, position?, salary?, hire_date? WHERE emp_id?; } else { sql INSERT INTO employee(emp_name, gender, dept_id, position, salary, hire_date) VALUES(?,?,?,?,?,?); } try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, empName); ps.setString(2, gender); ps.setInt(3, deptId); ps.setString(4, position); ps.setBigDecimal(5, new BigDecimal(salary)); ps.setDate(6, Date.valueOf(hireDate)); if (isUpdate) { ps.setInt(7, currentEmpId); } int rows ps.executeUpdate(); if (rows 0) { JOptionPane.showMessageDialog(this, 保存成功); refreshTable(); } } catch (SQLException | NumberFormatException ex) { JOptionPane.showMessageDialog(this, 保存失败: ex.getMessage()); } }Date.valueOf(hireDate)要求传入yyyy-MM-dd格式的字符串所以输入框要加输入提示。setBigDecimal对应数据库的DECIMAL字段如果前端拿到的是字符串记得new BigDecimal(salary)转换转换失败会抛NumberFormatException上面的 catch 里一并处理了。保存按钮实际上是对同一套代码的两个入口新增时isUpdatefalse修改时先选中行、回填表单、再isUpdatetrue。4.3 删除与刷新JTable 卡顿和行不同步的坑删除逻辑很简单但刷新逻辑有个很多新手会踩的坑删除完直接重新查一次数据却发现 JTable 还显示旧数据。原因通常是 U 盘里拷代码时把refreshTable()的调用位置写错了或者在setModel之后又操作了旧的DefaultTableModel引用。写法上注意刷新方法要重新执行查询并替换整个模型而不是model.removeRow手动删private void refreshTable() { String sql SELECT e.emp_id, e.emp_name, e.gender, d.dept_name, e.position, e.salary, e.hire_date FROM employee e LEFT JOIN department d ON e.dept_id d.dept_id; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { Object[][] data rsToArray(rs); String[] columns {工号, 姓名, 性别, 部门, 岗位, 工资, 入职日期}; DefaultTableModel model new DefaultTableModel(data, columns); table.setModel(model); } catch (SQLException ex) { JOptionPane.showMessageDialog(this, 查询失败: ex.getMessage()); } }这里的LEFT JOIN是有意为之如果某个员工的外键部门被删了内连接会直接把这条员工数据过滤掉表面上表格「少了一行」实际是数据丢了。外连接至少保证员工记录还在只是部门显示为空。字段列名的映射顺序要和 SQL 查询列一致rsToArray取的是位置索引不是列名列的顺序错了整行数据就错位了。JTable 刷新后如果有行选中状态需要重新table.updateUI()强制重绘否则会出现「数据已经变了但画面没动」的假象这属于 Swing 的已知怪毛病。4.4 用事务包住批量操作为什么重要人事管理系统最常见的批量操作是「开除几个员工」或者「批量调岗」。一条条执行 SQL 的效果是中途一条失败前面的已经改了库数据就处于半新半旧状态。数据库操作里的事务处理是必须掌握的概念课程设计里至少要演示一次try (Connection conn DBUtil.getConnection()) { conn.setAutoCommit(false); try (PreparedStatement ps conn.prepareStatement(DELETE FROM employee WHERE emp_id ?)) { for (Integer id : selectedIds) { ps.setInt(1, id); ps.addBatch(); } ps.executeBatch(); } conn.commit(); } catch (SQLException e) { // 需要在这里 rollback但连接已经关掉了 e.printStackTrace(); }注意上面这段代码有个故意留的问题try-with-resources在异常时已经关闭了连接catch里再调conn.rollback()会直接报连接已关闭。正确写法是把conn定义在 try 外面catch 里的 rollback 才有效。这也是课设答辩时老师最喜欢问的一个点答上来说明你确实理解事务边界。人事管理系统一般用不到太复杂的事务但批量删除员工时事务能保证要么全删、要么一个不动。5. 常见问题排查驱动、时区、中文乱码与连接泄漏写 JDBC 程序一半时间在写业务一半时间在和各种底层报错搏斗。从 MySQL 安装配置到驱动加载、字符集链条上每个环节都能出问题。下面这几条是我每次帮人调试课设时几乎必现的坑记录成现象、原因、解决三段式遇上了能少走两小时弯路。5.1 mysql 安装教程之后驱动加载失败ClassNotFoundException 的三种来源现象程序一启动就黑屏报ClassNotFoundException: com.mysql.cj.jdbc.Driver。原因有三个按发生频率排第一mysql-connector-java 的 jar 包没有放进项目的 lib 目录或者加了 Maven 依赖但没点刷新第二驱动类名写成了老版本的com.mysql.jdbc.Driver5.x 的类名配 8.x 驱动必炸第三按某个 mysql 安装教程装完 MySQL 8 之后用的还是旧版连接驱动导致驱动类不存在或签名不匹配。解决确认 lib 目录下 jar 包存在IDE 里右键Add as Library确认驱动类名与 jar 版本对应8.x 用com.mysql.cj.jdbc.Driver。还有一个检查技巧打开 jar 包看META-INF/services/java.sql.Driver文件内容里面写的就是这个 jar 真正注册的驱动类名。5.2 连接报错SSL、时区、认证插件三个连招现象DriverManager.getConnection抛SQLNonTransientConnectionException前面提示Server time zone value CST或Public Key Retrieval is not allowed。原因MySQL 8 默认时区行为变了驱动不知道服务器在哪个时区就无法做时间转换MySQL 8 默认认证插件是caching_sha2_password需要公钥交换过程本地连接默认不开放。这些跟代码业务逻辑没关系纯粹是环境配置问题。解决URL 后面补上serverTimezoneAsia/Shanghai和allowPublicKeyRetrievaltrueuseSSLfalse。这就回到第 2 章那套固定参数把这三件套写死能挡掉 90% 的本地连接报错。另外如果 MySQL 8 连接 MySQL 5.7 的库驱动版本和服务器版本跨度太大也可能触发协议不匹配优先让连接驱动版本跟着服务器走。5.3 中文乱码三个环节一处不一致就全是问号现象从数据库查出来的中文显示成??或者插入的中文在 MySQL 客户端里看是乱码。原因三个环节的字符集不一致——数据库表的字符集、JDBC URL 里的characterEncoding、Swing 表单本身的编码。课堂上常用的 MySQL 5.7 默认字符集可能不是 utf8mb4而 JDBC URL 没写编码时驱动用系统默认字符集Windows 中文环境是 GBK去和服务器通信两边互换编码中文必然乱。解决数据库建库时明确指定 utf8mb4JDBC URL 固定加characterEncodingutf8Swing 窗体里的中文字符串源文件用 IDE 统一改成 UTF-8 保存。我的习惯是在 DBUtil 中把characterEncodingutf8写成连接参数的一部分这样即使换机器部署只要驱动能跑起来字符集多半不会出问题。字符串别在代码里反复getBytes()手转越转越乱。5.4 连接泄漏程序死等和 数据库连接池 上限报警现象程序运行几分钟后按钮点了没反应MySQL 里SHOW PROCESSLIST能看到大量Sleep连接最后控制台报Too many connections。原因Connection 没关。最常见的位置在登录校验、员工保存、表格刷新这几个高频操作。用 try-with-resources 能自动关闭但只在资源声明在 try 括号里时才生效如果连接是方法外传入的方法内部只管用不管关就是你漏了。解决所有获取连接的地方要么用 try-with-resources要么在 finally 里按rs - stmt - conn的顺序关闭。我习惯把三个关闭动作统一交给 DBUtil 的close(AutoCloseable...)方法调用时DBUtil.close(rs, ps, conn)一行搞定不会因为某个分支提前 return 而漏关。另外设置连接超时也能兜底MySQL 的wait_timeout默认 8 小时课设答辩现场跑几分钟就抛「连接数太多」多半是之前连接没关而不是配置问题。5.5 日期组件与 JDBC Date 类型互转一个 String 引发的血案现象员工入职日期保存成功但回显在表单里格式变成了2025-06-01 00:00:00或者Date.valueOf抛IllegalArgumentException。原因Swing 没有开箱即用的日期选择控件很多人用 JTextField 手输日期用户输入格式不统一而 JDBC 的setDate只接受java.sql.Date字符串一旦不是yyyy-MM-dd严格格式就转换失败。查出来的时候getObject(hire_date)返回 Timestamp转成字符串带着时间部分。解决日期输入框加一个输入格式提示比如setToolTipText(格式2025-06-01)保存前用Pattern.matches(\\d{4}-\\d{2}-\\d{2}, ...)正则拦一道非法输入回显时统一new SimpleDateFormat(yyyy-MM-dd).format(rs.getDate(hire_date))。如果想省事直接用 JCalendar 这类第三方日期选择器但课程设计一般不建议引入额外 jar 包正则校验加格式提示已经够用。6. 把部门统计报表做成图表与 Excel 导出一个低成本的加分项员工管理做完课程设计基本合格。想在这个基础上拿个更好的分数最划算的加法是一个统计报表模块用一条聚合 SQL 按部门统计人数和平均工资结果用柱状图或者导出成 Excel。难点不在 SQL而在导出格式——JTable 显示和文件落盘的编码如果不处理导出文件用 Excel 打开会乱码一片。先写统计 SQL这条语句要练熟因为把GROUP BY和AVG用到实际场景里比在实验报告上抄例子有说服力得多SELECT d.dept_name, COUNT(e.emp_id) AS headcount, AVG(e.salary) AS avg_salary FROM department d LEFT JOIN employee e ON d.dept_id e.dept_id GROUP BY d.dept_id, d.dept_name;Java 侧把结果遍历出来填充到一个弹窗表格里同时提供一个「导出 CSV」按钮。CSV 用逗号分隔Excel 直接能打开不需要 POI 依赖。注意 CSV 文件写入时要带上 UTF-8 BOM\uFEFF否则 Windows 下的 Excel 会按本地编码去读中文照样显示成乱码private void exportToCsv(String filePath) { try (BufferedWriter writer new BufferedWriter( new OutputStreamWriter(new FileOutputStream(filePath), UTF-8))) { writer.write(\uFEFF); writer.write(部门,人数,平均工资\n); for (int i 0; i statTable.getRowCount(); i) { writer.write(statTable.getValueAt(i, 0) , statTable.getValueAt(i, 1) , statTable.getValueAt(i, 2) \n); } JOptionPane.showMessageDialog(this, 已导出到: filePath); } catch (IOException ex) { JOptionPane.showMessageDialog(this, 导出失败: ex.getMessage()); } }\uFEFF这个细节我吃过亏说明文件字符集有三个层面的东西内容编码、BOM 标记、打开方默认编码。Excel 识别 UTF-8 文件靠的是 BOM没有它内容编码再正确也白搭。导出路径用JFileChooser让用户自己选我在项目里是固定输出到项目根目录下的report文件夹省事且答辩演示时不怕找不到文件。最后一件值得做的事把 Swing 界面里所有写死的列表数据性别、部门选项、岗位名都改成从数据库读。部门下拉框启动时从 department 表加载新增部门后刷新下拉框。这个改动很小但能让整个程序显得「活」——数据不再是一堆硬编码字符串而是真正和数据库同步的。我当年课设答辩被追问最多的地方不是代码逻辑而是「为什么新增的部门不在下拉框里」从那以后我把所有这种假装动态的写法都改成了真动态。希望这个习惯也能帮到你多花十分钟少被追问一个尴尬问题。本文还有配套的精品资源点击获取
