Java Swing员工信息管理系统开发：从JDBC到GUI全流程解析

简介：基于Java Swing开发的员工信息管理系统源码包，面向Java初学者与桌面应用开发爱好者，解决员工数据录入、维护与可视化管理的完整落地问题。压缩包共74个文件，包含51个class编译文件、10个java源码、SQL数据库脚本、MySQL驱动jar包以及界面背景图等素材，大小1.17MB，结构清晰便于直接导入IDE运行学习。已有135人浏览学习。资源集成了MySQL数据库设计与JDBC连接，覆盖DAO数据访问、Service业务逻辑、Controller控制与Swing视图展示等分层实现；同时提供使用说明txt、项目配置文件与登录背景素材，帮助理解从数据库初始化到GUI界面调试运行的完整流程。适合希望通过完整项目掌握Java Swing组件运用、事件监听与数据库交互实操的开发者。

1. 基于Java swing带GUI界面的员工信息管理系统：这套源码到底在解决什么问题

“基于Java swing带GUI界面的员工信息管理系统（源码+数据库）.zip”这类压缩包，你在网上搜Java基础、数据库增删改查、GUI开发时经常能碰到。它解决的是一个很具体的问题：在没有Web容器、不引入前后端框架的前提下，用Java自带的Swing组件做一个能点击、能输入、能看结果的桌面客户端，再通过JDBC把员工档案的增删改查落到MySQL数据库里。很多刚学完Java基础的开发者把它当成第一份能完整跑通的项目，用来理解事件监听、SQL语句和代码分层；也有课程设计直接拿它改改界面就提交。

打开源码包后你会发现，核心其实只有三个部分：登录窗口、主界面表格、以及一组围绕Employee表的DAO方法。真正不容易跑通的反而不是代码逻辑，而是环境匹配和数据库连接参数。接下来我要按自己的落地顺序，把从设计到打包的每一步摊开讲。

2. 系统拆解与技术选型：为什么Swing仍是桌面管理端的务实选择

2.1 功能边界：一个最小可用的员工管理系统该覆盖哪些操作

拿到这种项目，“最小可用”不是指代码少，而是业务流程要闭环。我一般会先检查有没有下面这套操作：管理员凭账号密码登录；登录后看到按部门排列的员工列表；列表支持新增、修改、按姓名或工号模糊查询；员工离职或开除时能禁用或删除记录。只要这五件事能在界面里点出来，系统就能交给别人用。

很多所谓“员工信息管理系统”还会附加考勤、工资计算、权限分级，但对一个带GUI界面的Swing项目来说，加功能不等于加价值。Swing的表格、对话框、事件模型很适合做轻量CRUD，一旦引入复杂报表就要自己画JFreeChart或者额外嵌报表组件，维护成本立刻升高。我的选型原则是：让数据库增删改查稳定跑通，其余功能只做预留字段，比如在员工表里留一个status状态位，而不是一开始就做离职管理模块。

2.2 技术栈取舍：Swing + JDBC + MySQL的常见组合

这个组合之所以泛滥，是因为它贴合教材和课程设计思路。Swing是AWT的继承者，JDK自带，不需要下载控件库；JDBC是Java访问数据库的标准接口，天然适合配套讲解；MySQL则覆盖面广，Windows和Linux上都有图形化客户端。三者加在一起，不用Tomcat，不用Maven，甚至不用IDE也能编译运行。

对比JavaFX，Swing的优势不是技术先进，而是资料足够多。你在网上搜“java swing 员工管理”，能找到几十套源码结构；搜JavaFX对应项目，要么版本不一致要么需要额外配置。对这篇博客面对的读者来说，能先跑通、能看懂、能改代码，比用“更现代”的框架更重要。

从开发效率看，Swing的布局是手写，确实比拖拽控件慢，但好处是每一行代码都是可控的。下面是我常用的分层思路：

这种分层对任何Swing项目都适用。很多上传的源码把SQL直接写在ActionListener里，短期能跑，但换库或改表结构时就是灾难。我把DAO单独拆出来，就是为了让界面代码不被SQL占满。

2.3 源码包里的包结构怎么摆，才能不迷路

当你解压一个命名为“员工信息管理系统.zip”的源码包，第一件事不是找Main方法，而是看包名是否清晰。一个合格的包结构应该是：

src/ ├── com/company/ems/ │ ├── view/ LoginFrame.java, MainFrame.java, EmployeeDialog.java │ ├── dao/ EmployeeDao.java, UserDao.java │ ├── model/ Employee.java, User.java, Dept.java │ └── util/ DbUtil.java

如果解压后所有.java文件堆在一个目录，也没有util包，说明原作者没做分层。这种代码不是不能学，而是你接手后要花时间整理。我通常的改法是先写一个DbUtil类，统一管理连接参数，然后逐层拆出DAO，这样后面每加一个查询都不动界面代码。

这也是判断这份源码值不值得花时间的关键点：代码是否拆包、是否使用PreparedStatement、是否处理了连接关闭。如果连这几点都没有，那它只是“能跑”的demo，不是可维护的“系统”。

3. 数据库设计与初始化：先让数据表立住，界面才不会乱

3.1 员工表与部门表：字段类型、主键、外键怎么定

数据库设计是整个系统的地基。如果在一张员工表里直接写“部门名称”字符串，每次查询看起来省事，但一旦部门改名，要UPDATE所有员工记录。所以正规做法是拆成员工表和部门表，员工表只存部门的数字ID，界面展示时再通过JOIN查出名称。

下面是这套系统常见的初始SQL脚本，我加上了字段注释：

CREATE DATABASE IF NOT EXISTS employee_db DEFAULT CHARACTER SET utf8mb4; USE employee_db; CREATE TABLE departments ( dept_id INT PRIMARY KEY AUTO_INCREMENT COMMENT '部门ID', dept_name VARCHAR(50) NOT NULL UNIQUE COMMENT '部门名称' ); CREATE TABLE employees ( emp_id INT PRIMARY KEY AUTO_INCREMENT COMMENT '员工ID', emp_no VARCHAR(20) NOT NULL UNIQUE COMMENT '员工工号', name VARCHAR(50) NOT NULL COMMENT '员工姓名', gender CHAR(2) DEFAULT '男' COMMENT '性别', dept_id INT COMMENT '所属部门ID', phone VARCHAR(20) COMMENT '联系电话', hire_date DATE COMMENT '入职日期', salary DECIMAL(10,2) DEFAULT 0 COMMENT '薪水', status TINYINT DEFAULT 1 COMMENT '状态 1在职 0离职', CONSTRAINT fk_emp_dept FOREIGN KEY (dept_id) REFERENCES departments(dept_id) );

为什么工资用DECIMAL(10,2)而不是FLOAT？因为浮点数在MySQL里会有精度误差，比如0.1加0.2可能等于0.30000000000000004。员工工资是给财务看的，必须保证两位小数精确。入职日期用DATE而不是VARCHAR，是防止有人存成“2020-1-1”或“2020年1月1日”，统一格式后也能直接用日期函数筛选。

工号emp_no加UNIQUE约束很有必要。很多项目用自增主键emp_id作为员工唯一标识，但对外展示时自增ID会让用户猜到员工数量，所以单独留一个可读的工号字段。

3.2 连接数据库：JDBC驱动、URL参数与连接工具类

数据库表建好之后，下一步是让Java代码连上去。传统的做法是先Class.forName加载驱动，MySQL 8.0以上的驱动类名是com.mysql.cj.jdbc.Driver，老版本是com.mysql.jdbc.Driver，两者混用会导致报警告甚至连不上。

我一般会单独写一个DbUtil类，把所有连接参数集中起来：

package com.company.ems.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DbUtil { private static final String URL = "jdbc:mysql://localhost:3306/employee_db" + "?useSSL=false" + "&serverTimezone=Asia/Shanghai" + "&characterEncoding=utf8"; 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); } }

这段代码里有三个关键参数。useSSL=false是因为本地开发不需要加密，设置了反而要求双方证书匹配。serverTimezone=Asia/Shanghai必须指定，否则MySQL 8.0默认时区是UTC，查出的日期会比北京时间早8小时。characterEncoding=utf8配合数据库的utf8mb4，是解决中文乱码的第一道防线。

注意，数据库密码写在代码里只适合本机演示。如果是团队协作，应该把这个配置放到properties文件里，再用类加载方式读取，避免每次换环境都改源码。

3.3 初始化脚本：手动执行还是写进程序

获取到的源码包如果带了.sql文件，MySQL命令行里执行这条命令就能建库：

mysql -u root -p < employee_db.sql

但很多初学者不喜欢命令行，更习惯用Navicat或DataGrip的“运行SQL文件”功能。这两种方式结果一样，都能把建表和初始数据导进去。我建议你在执行完脚本后，随手跑一句SELECT * FROM employees;，如果返回空表说明建表成功，如果报“No database selected”说明没有USE employee_db。

有的源码把建表语句写在一个InitDatabase.java类里，程序启动时自动执行。这种方式对用户友好，但存在一个隐患：SQL脚本一旦出错，调试时很难定位是代码问题还是脚本问题。我更倾向把建库、建表、插入测试数据这三件事拆成独立.sql脚本，IDE里直接执行，跑通之后再决定要不要保留自动初始化。

4. 核心功能实现：从登录验证到员工增删改查全链路

4.1 登录窗口：JFrame布局、ActionListener与密码匹配

Swing的登录窗口是新手接触的第一个完整交互场景。界面无非是一个背景面板、两个文本框、一个登录按钮，真正重要的是事件方法里的逻辑顺序。下面是登录窗口的核心代码：

public class LoginFrame extends JFrame { private JTextField usernameField; private JPasswordField passwordField; public LoginFrame() { setTitle("员工信息管理系统登录"); setSize(320, 200); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLayout(new GridLayout(3, 2, 5, 10)); add(new JLabel("用户名:")); usernameField = new JTextField(); add(usernameField); add(new JLabel("密码:")); passwordField = new JPasswordField(); add(passwordField); JButton loginButton = new JButton("登录"); add(loginButton); loginButton.addActionListener(e -> doLogin()); } private void doLogin() { String username = usernameField.getText().trim(); String password = new String(passwordField.getPassword()); if (UserDao.checkLogin(username, password)) { new MainFrame().setVisible(true); dispose(); } else { JOptionPane.showMessageDialog(this, "用户名或密码错误"); } } }

这里有个常见的翻车点：用getText()取密码文本框内容。JPasswordField设计出来就是为了避免密码以String形式停留，所以它的getPassword()返回char数组，再用new String包装。每次密码校验后，这个String仍然在内存里，严格的做法是使用完就置空，但课程设计很少会追究到这个深度。

UserDao.checkLogin内部一般是用PreparedStatement查用户表，用户名和密码同时匹配才返回true。千万不要在SQL里直接拼字符串“SELECT * FROM user WHERE name='” + username + “'”，这个习惯留在学生作业会挨骂，留在企业项目就是SQL注入漏洞。

4.2 主界面：JTable + JScrollPane展示员工列表

主界面是整个系统里最有价值的部分。它的核心是JTable，但JTable本身不直接存数据，而是通过TableModel来管理行和列。我给每个功能都做DAO返回List ，界面只负责把List转换成表格模型。这样数据库查询逻辑和界面展示逻辑分离，后面换成其他框架也能复用。

加载员工列表的典型写法：

public void loadEmployeeTable() { String[] columns = {"ID", "工号", "姓名", "性别", "部门", "电话", "入职日期", "工资"}; DefaultTableModel model = new DefaultTableModel(columns, 0); List<Employee> list = EmployeeDao.findAll(); for (Employee e : list) { model.addRow(new Object[]{ e.getEmpId(), e.getEmpNo(), e.getName(), e.getGender(), e.getDeptName(), e.getPhone(), e.getHireDate(), e.getSalary() }); } table.setModel(model); }

细节在于构建Object数组时顺序必须和columns一致，否则会出现列名和值错位。JTable的默认单元格编辑是双击即可修改，但这里我只让model填充数据，没有用反射或监听器去同步单元格修改。如果你打算让用户直接在表格里改，需要重写JTable的isCellEditable并监听TableModelEvent，否则改动只停留在界面上，数据库没有变化。

这张表还需要放在JScrollPane里，否则列标题不会显示。如果你只new JTable(model)然后直接add到Frame，会得到一个没有表头的“白板”，这也是Swing初学者最常看到的结果。

4.3 新增和修改：弹出Dialog收集数据，再调用DAO

新增员工和修改员工可以共用一个EmployeeDialog类，区别只是打开时是否传入已有Employee对象。输入容器用JOptionPane或自定义JDialog都行，关键在DAO层的SQL写法。

新增员工的DAO方法：

public int addEmployee(Employee e) throws SQLException { String sql = "INSERT INTO employees " + "(emp_no, name, gender, dept_id, phone, hire_date, salary, status) " + "VALUES (?, ?, ?, ?, ?, ?, ?, 1)"; try (Connection conn = DbUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, e.getEmpNo()); ps.setString(2, e.getName()); ps.setString(3, e.getGender()); ps.setInt(4, e.getDeptId()); ps.setString(5, e.getPhone()); ps.setDate(6, new java.sql.Date(e.getHireDate().getTime())); ps.setBigDecimal(7, e.getSalary()); return ps.executeUpdate(); } }

这里每行setXXX的顺序和SQL里的问号顺序一一对应，顺序写错是最难排查的。我习惯把SQL字符串放在最前面，然后数着问号写参数，写完再回头对照实体类的字段。hire_date我用了java.sql.Date包装，因为java.util.Date不能直接作为日期参数传入。

修改员工时SQL基本一样，只是多了WHERE emp_id=?。你在源码里可能看到用executeStatement拼SQL，我强烈不建议。PreparedStatement除了防注入，还能预编译，批量操作时性能更好，绝不是多此一举。

4.4 删除与模糊查询：让系统真正可用

删除员工在物理删除和逻辑删除之间，我建议先用逻辑删除。所谓逻辑删除，就是把status从1改成0，查询时默认过滤status=1。这样误删了还能恢复。

如果坚持物理删除，DELETE FROM employees WHERE emp_id=?必须放在事务里执行。Swing的DAO每次executeUpdate后，MySQL默认autocommit=true，所以单条DELETE没问题；但一旦删除员工后还要删除该员工关联的考勤记录，就必须用事务。

模糊查询也是经典需求。正确写法是：

public List<Employee> findByName(String keyword) throws SQLException { String sql = "SELECT e.*, d.dept_name FROM employees e " + "LEFT JOIN departments d ON e.dept_id = d.dept_id " + "WHERE e.name LIKE ? AND e.status = 1"; try (Connection conn = DbUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setString(1, "%" + keyword + "%"); // 执行查询并封装成 List<Employee> } }

注意LIKE通配符是加在参数值上的，而不是加在SQL模板里。很多人写“LIKE ‘%?%’”，JDBC会把问号当普通字符处理，导致查询不到数据。这里我用了LEFT JOIN而不是INNER JOIN，是怕某员工被分配到一个已删除的部门，LEFT JOIN能保证员工记录不丢。

5. 避坑指南：Swing + MySQL项目里最常见的5个翻车现场与排查方法

5.1 界面中文乱码，数据库中文也乱码

现象：登录窗口的按钮显示“????”或“鐧诲叆”，新增员工后数据库里是乱码。只要界面上有中文的地方都会变乱码。

原因分两层。第一层是JVM读取.java文件时用了默认编码，Windows下默认GBK，代码里写了GBK的注释但文件实际是UTF-8保存；第二层是连接数据库的URL没加characterEncoding=utf8，或数据库表是latin1字符集。

解决：在IDE里把项目编码统一设为UTF-8，数据库建表用utf8mb4，URL追加characterEncoding=utf8。这三个地方少一个，中文就可能在哪里断掉。我每次写SQL脚本时都会在开头声明DEFAULT CHARACTER SET utf8mb4，这是来自翻车后的血泪经验。

5.2 点击“查询”按钮，界面卡死好几秒

现象：点击按钮后整个窗口无法拖动，鼠标变成转圈状态，几秒后恢复。这是因为查询太慢，还是程序死循环？

原因：不是查询慢，而是你把数据库查询直接写在了ActionListener里。Swing的事件处理是在“事件分发线程EDT”上执行的，这个线程既要处理界面重绘，也要响应鼠标键盘。一旦你在它上面执行JDBC查询，查询期间所有界面事件都被阻塞。

解决：耗时操作交给SwingWorker。把查询逻辑放到doInBackground()，查询结果在done()里更新UI。这样用户看到的始终是流畅的界面，底层查询完成后再通知表格刷新。虽然数据量小时差别不明显，但对一个带GUI的系统来说，这是躲不开的优化点。

5.3 明明数据库能连，程序却报Connection refused

现象：Navicat能正常连接MySQL，但Java程序启动后报“Cannot connect to MySQL server on localhost:3306”或“Access denied for user”。

原因：大概率是JDBC URL里写了localhost，但MySQL的端口不是3306，或者用户名密码和数据库不匹配。还有一个隐蔽原因，MySQL 8.x默认允许的认证插件是caching_sha2_password，老版JDBC驱动不认识这个插件。

解决：先用客户端工具确认端口，再在URL里写成jdbc:mysql://127.0.0.1:3306/employee_db。如果驱动太老，升级mysql-connector-java到8.0以上；不想升级，可以在MySQL执行ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';。

5.4 修改了员工后，表格刷新不显示新数据

现象：调用loadEmployeeTable()后，表格仍然是旧数据，但要重启程序才正常。

原因：JTable一旦设定了TableModel，第一次之后如果只是调用table.repaint()，它不会重新去从查询结果获取数据。repaint只负责重绘当前模型里的内容，不改变模型的行数据。

解决：刷新时必须重新创建DefaultTableModel，再调用table.setModel(model)。setModel会触发JTable重新布局并重绘，这比repaint彻底得多。如果你在窗口打开期间多次刷新，还要注意不要让旧table引用残留，否则可能同时显示两个表格内容。

5.5 打包成jar后双击运行，报ClassNotFoundException

现象：直接在IDE里运行正常，但用“jar”命令或IDE导出可执行jar后，双击运行提示找不到某个类，或提示找不到主类。

原因：这种项目依赖了JDBC驱动，但导出jar时默认只打包了你自己写的类，没有把mysql-connector-java驱动打进去。IDE运行和双击运行对Classpath的处理完全不一样——IDE会自动把依赖库加进去，双击jar只认jar包内部的META-INF/MANIFEST.MF。

解决：用Maven打包时配置maven-assembly-plugin，把依赖合并输出为一个胖jar；不用Maven的话，在IDE导出时选择“Extract required libraries into generated JAR”。如果你拿到的是源代码而不是打包好的jar，建议检查项目里是否有pom.xml或lib目录，前者说明这是一个Maven项目，后者说明驱动需要手动放进运行路径。

6. 进阶：把系统从“能跑”变成“能交付”的打包与验证技巧

6.1 用Maven打一个可直接分发的jar

如果你的源码里没有Maven配置，我建议你不用急着改成Maven工程，先人工把依赖搞定。但如果你打算长期维护效率产品，Maven会帮你管理驱动版本和打包规则。在pom.xml里加一行依赖mysql-connector-java，再引入maven-shade-plugin或maven-assembly-plugin，执行：

mvn clean package

会在target目录生成一个带依赖的jar，这个jar直接复制到任何装了JRE的机器上，就能通过java -jar运行。

打包时唯一需要留意的是MANIFEST.MF里的Main-Class指向哪个类。如果指向LoginFrame，程序启动就会打开登录窗口；指向MainFrame则会跳过登录校验。

6.2 准备一份可复现的部署清单

我之前因为图省事，只给了同事一个jar包，结果对方一直报数据库连接失败。后来我养成了每次都附一份README的习惯，把必需的环境用表格列清楚：

这份清单已经帮我和同事省了无数次来回沟通。给别人用系统时，不要默认对方懂JDBC，你要告诉他“先建库、再跑脚本、再改配置、最后启动”这个顺序。

结尾想提醒一句：Swing项目最大的好处是逻辑直接、代码可读，最大的坑则是过于依赖本机数据库环境。我自己最深刻的一次教训，是以为数据库密码写在代码里没问题，结果上线后被别人扒到连接串，直接改了库里的数据。所以只要这个系统要交给别人用，务必把密码挪到外部配置文件，并限制MySQL账号权限。

这就是我能想到的，关于基于Java swing员工信息管理系统从源码到落地全链路最常见的路。希望这些经验能帮你省下一点调试时间，哪怕只避开一个坑也值得。

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