Java+Swing+MySQL教务管理系统课设源码：数据库、界面与JDBC实操解析

简介：这份Java+Swing+MySQL实现的学校教务管理系统源码，面向Java初学者与需要完成期末大作业、课程设计的高校学生，涵盖学生信息管理、课程安排、成绩录入等典型教务功能，项目难度适中，本地编译可运行，评审分达98分。压缩包共39个文件，其中25个Java源码文件承担核心业务逻辑，辅以SQL数据库脚本、Maven配置XML、界面预览PNG及项目说明MD，整包仅240KB，结构一目了然，适合快速导入IDE学习或二次开发。目前已有220人学习浏览，可作为Swing窗体编程、MySQL数据交互及分层项目结构的综合参考。附带清晰的目录划分与数据库初始化脚本，能帮助使用者省去环境配置与建表时间，专注理解教务管理业务流程，顺利支撑课程设计与答辩展示。

1. 教务管理系统课设源码：一份能跑通、能演示、能答辩的 Java+Swing+MySQL 项目

期末大作业最怕的不是功能少，是代码写完了运行不起来。这份 Java + Swing + MySQL 实现的教务管理系统课设源码，我拿到手的第一反应是先跑一遍验证可不可用——它能直接编译运行，不是停留在 PPT 上的半成品。十个课设组里有八个卡在同一个环节：数据库连不上、驱动加载失败、Swing 窗口白屏，最后只能对着报错信息干瞪眼。这套源码走 Maven 标准结构，pom.xml、src/main、target/classes 都是现成的，educational_admin.sql 把建库建表和初始数据都写好了，评审分 98 分，难度适中。适合正在赶期末大作业的在校生、想照着一份完整课设案例复现的初学者，也适合想看看 Swing 界面和 JDBC 分层怎么组织的老手。下文按数据库、界面、数据链路、踩坑、验收的顺序拆。

2. 先拆数据库脚本 educational_admin.sql：表结构、初始数据与建库参数

拿到这套源码，我建议第一个打开的不是 Java 文件，而是 educational_admin.sql。教务管理系统的所有功能都围绕数据库转，界面只是壳，表结构才是灵魂。这个脚本把建库、建表、插入初始数据放在同一个文件里，MySQL 客户端执行一遍就能把整个系统的数据底座搭好。下面从建库参数开始，把脚本里最值得抄的设计讲清楚。

2.1 存储引擎与字符集：为什么选 InnoDB 和 utf8mb4

教务管理系统里有学生、课程、成绩三块核心数据，成绩表要关联学生表和课程表，选课和退课都会改成绩记录。这种场景需要事务和外键，InnoDB 是 MySQL 默认引擎，支持外键约束和行级锁，数据一致性比 MyISAM 可靠很多。脚本里的建表语句一般长这样：

CREATE TABLE `student` ( `id` INT NOT NULL AUTO_INCREMENT COMMENT '主键', `student_no` VARCHAR(20) NOT NULL COMMENT '学号', `name` VARCHAR(50) NOT NULL COMMENT '姓名', `gender` VARCHAR(4) DEFAULT '男' COMMENT '性别', `class_name` VARCHAR(50) DEFAULT NULL COMMENT '班级', `phone` VARCHAR(20) DEFAULT NULL COMMENT '联系电话', PRIMARY KEY (`id`), UNIQUE KEY `uk_student_no` (`student_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生表';

注意几个参数：AUTO_INCREMENT 自增主键，适合系统内部标识，不管学号怎么变，主键不会冲突；UNIQUE KEY 保证学号不重复，这是教务系统里最容易出脏数据的地方，一个学号绑定两条学生记录，后面查成绩、导出名单全乱；CHARSET=utf8mb4 支持中文和特殊字符，比 utf8 更稳。如果脚本里建的是 utf8，建议改成 utf8mb4，否则遇到生僻字姓名或特殊符号会报错或者显示乱码。

2.2 五张核心表：学生、教师、课程、成绩、管理员的关联关系

教务管理系统的表设计一般围绕“人、课、成绩”三个维度展开，这套资源里最常见的拆法是五张表：管理员表、学生表、教师表、课程表、成绩表。下面是一个典型的结构清单：

成绩表是整张数据模型的核心关联点：一条成绩记录必须同时指到一名学生和一门课，这样才能在 Swing 界面里查出“某个学生的所有成绩”或者“某门课的所有选课人”。常见做法是用两个外键关联：

CREATE TABLE `score` ( `id` INT NOT NULL AUTO_INCREMENT, `student_id` INT NOT NULL COMMENT '关联学生表', `course_id` INT NOT NULL COMMENT '关联课程表', `score` DECIMAL(5,2) DEFAULT NULL COMMENT '成绩，保留两位小数', PRIMARY KEY (`id`), KEY `idx_student_id` (`student_id`), KEY `idx_course_id` (`course_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成绩表';

DECIMAL(5,2) 存成绩比 FLOAT 合适，最多存 999.99，不会出现浮点误差。KEY 后面的索引是给联表查询用的，没有这个索引，数据量一上来 JOIN 会明显变慢。联表查询是教务系统里最频繁的操作，查成绩单的 SQL 一般是这个套路：

SELECT s.name, c.course_name, sc.score FROM score sc JOIN student s ON sc.student_id = s.id JOIN course c ON sc.course_id = c.id WHERE s.id = 1;

这段 SQL 把 score 表当作中间桥梁，JOIN student 拿姓名，JOIN course 拿课程名，这种三段式联查在 Java 代码里用 PreparedStatement 拼好，执行结果塞进 JTable 就能展示，是后面所有列表页面的数据基础。

2.3 初始数据与外键约束：演示的“后悔药”和删除的“绊脚石”

很多同学导入脚本后只建了表结构，运行系统发现登录页面进不去，最后检查发现 admin 表是空的。这套资源的 educational_admin.sql 里预置了管理员账号和若干学生、课程、成绩样例数据，这个设计非常聪明：一方面评审老师打开系统就能登录、能演示；另一方面你自己测试功能时不用手动一条条 INSERT。初始数据里最核心的是管理员账号，一般放在脚本最前面：

INSERT INTO `admin` (`username`, `password`) VALUES ('admin', '123456');

登录之前，先在 MySQL 里查一下这条记录在不在，能少走很多弯路。我一般会顺手把密码改成自己在答辩时好输入的短密码，演示现场手抖输错密码很尴尬。

同时，外键约束是双刃剑：它保证数据一致性，也让删除操作变得麻烦。比如删除一个已经被成绩表引用的学生，InnoDB 外键会直接拒绝删除并报外键约束失败。这在业务上是正确的保护，但答辩时如果老师要求演示“删除学生”功能，你得提前想好处理方式：要么在业务代码里先删除该学生的成绩记录再删除学生；要么在建表时把外键声明为 ON DELETE CASCADE，让数据库自动清理关联记录。常见做法是前者，因为删除成绩应该是业务显式操作，悄无声息的级联删除容易让评审老师质疑你对数据安全的意识。

3. Swing 界面搭建：登录窗口、主窗体与表格刷新的落地写法

数据库准备好了，接下来是 Java 源码的重头戏——Swing 界面。Swing 是老牌 GUI 框架，组件丰富但代码冗长，一个登录窗口就要几十行。这套资源的价值在于它把界面代码按“登录 → 主菜单 → 表格管理”切成三个层次，照着这个结构写，不会烂尾，答辩时讲分层也更顺。

3.1 登录窗口：JFrame + 事件监听，校验逻辑别往按钮里堆

登录窗口是所有教务系统演示的第一步。评审老师的习惯是：打开程序，先看到登录窗口，输入账号密码，点登录，进主界面。如果这一步就卡住，后面全白搭。登录窗口的核心结构是这样：

public class LoginFrame extends JFrame { private JTextField usernameField; private JPasswordField passwordField; public LoginFrame() { setTitle("教务管理系统登录"); setSize(400, 300); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLocationRelativeTo(null); // 组件布局省略，按钮挂监听 JButton loginBtn = new JButton("登录"); loginBtn.addActionListener(e -> doLogin()); } private void doLogin() { String username = usernameField.getText().trim(); String password = new String(passwordField.getPassword()); // 调用 DBHelper 验证账号密码 if (DBHelper.checkLogin(username, password)) { new MainFrame().setVisible(true); dispose(); } else { JOptionPane.showMessageDialog(this, "账号或密码错误"); } } }

这段代码里有两个细节值得注意：用户名用 getText().trim() 去空格，防止用户无意打了空格导致登录失败；密码用 getPassword() 而不是 getText()，JPasswordField 设计上就不建议直接拿 String，这是 Swing 的规范问题，答辩时老师可能会追问。登录成功后的处理是 new MainFrame() 然后 dispose() 关掉登录窗口，而不是 setVisible(false)——这样不会留一个隐形的登录窗口在后台占资源。

3.2 主窗体与菜单栏：JMenuBar 做功能分区，内容区用 JPanel 切换

登录之后的主窗体，常见设计是顶部放一个 JMenuBar 菜单栏，中间放一个 JPanel 作为内容区。菜单的作用是把学生管理、课程管理、成绩管理三块功能并列，逻辑清晰，答辩时也好讲。菜单栏的构建代码一般长这样：

JMenuBar menuBar = new JMenuBar(); JMenu studentMenu = new JMenu("学生管理"); JMenuItem addStudent = new JMenuItem("添加学生"); JMenuItem listStudent = new JMenuItem("学生列表"); studentMenu.add(addStudent); studentMenu.add(listStudent); JMenu scoreMenu = new JMenu("成绩管理"); JMenuItem inputScore = new JMenuItem("录入成绩"); scoreMenu.add(inputScore); menuBar.add(studentMenu); menuBar.add(scoreMenu); setJMenuBar(menuBar);

每个 JMenuItem 都要挂 ActionListener，点击后切换内容面板。这里的“切换”本质是移除当前 JPanel 再添加新 JPanel，然后调用 revalidate() 和 repaint()。很多同学只调 repaint() 发现界面没反应，因为 Swing 的布局管理器需要 revalidate() 重新计算布局，repaint() 只负责重绘，两者缺一不可。

3.3 表格数据展示：JTable + DefaultTableModel 的刷新机制

学生列表、成绩列表这些页面，统一用 JTable 展示。JTable 本身只负责显示，数据存在 TableModel 里。如果直接 new JTable(data, columnNames) 这种构造方式，刷新数据时会很痛苦，因为模型和数据绑死了，列宽、排序状态每次都要重建。常见做法是先建一个 DefaultTableModel，再把 JTable 和它绑起来：

String[] columns = {"学号", "姓名", "班级", "成绩"}; DefaultTableModel model = new DefaultTableModel(columns, 0); JTable table = new JTable(model); JScrollPane scrollPane = new JScrollPane(table); // 把 scrollPane 加到内容面板 // 查询后刷新 model.setRowCount(0); // 清空旧数据 for (Student s : studentList) { model.addRow(new Object[]{s.getStudentNo(), s.getName(), s.getClassName(), s.getScore()}); }

DefaultTableModel 的好处是支持 setRowCount(0) 清空和 addRow 追加，刷新就是清空重填。代码里把查询结果一条条 addRow 进去，表格自动重绘。不要在每次刷新时 new 一个新的 DefaultTableModel 再 setModel()，那样会把列宽设置、排序状态全部重置，演示时表格忽宽忽窄，观感很差。

另外，如果查询是在子线程里做的，更新表格必须回到事件调度线程，否则界面会出现抖动或者不刷新。标准写法是用 SwingUtilities.invokeLater 把填充数据的操作包起来，这也是一个可以在答辩时主动提到的点。

4. JDBC 连接 MySQL：驱动版本、连接参数与 DBHelper 封装

界面写好了，数据怎么从 MySQL 流到 JTable，靠的是 JDBC。这一步是最容易翻车的：pom.xml 依赖版本不对、连接串参数缺一个、驱动类名写错，都会在运行时才报错，属于典型的“编译通过但跑不起来”的黑匣子。

4.1 pom.xml 依赖配置：mysql-connector-java 的版本选择

这个项目是 Maven 结构，依赖在 pom.xml 里统一管理。教务系统最核心的依赖是 MySQL 驱动，常见写法是这样：

<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.30</version> </dependency>

版本号按你本机 MySQL 情况选。如果你本机装的是 MySQL 5.7，用 8.0.30 的驱动也能连，驱动向后兼容。反过来，如果驱动是 5.1.x 而数据库是 MySQL 8.0，启动时大概率报 SSL 连接错误或者 Unable to load authentication plugin 'caching_sha2_password'。MySQL 8 的用户认证插件改成了 caching_sha2_password，旧驱动根本不认识，这是新老版本混用最常见的坑。

4.2 连接 URL 参数：serverTimezone、characterEncoding、useSSL

驱动版本对了，连接串还有三个参数容易被忽略。很多人只写 jdbc:mysql://localhost:3306/educational_admin 就完事，结果数据一多就开始出现各种玄学问题。标准写法是：

private static final String URL = "jdbc:mysql://localhost:3306/educational_admin" + "?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8"; private static final String USER = "root"; private static final String PASSWORD = "root";

useSSL=false 是关闭 SSL 校验，本地开发和课设演示环境不需要加密连接，开着反而会报警告；serverTimezone=Asia/Shanghai 是 MySQL 8.x 的硬性要求，不写会报 CST 时区错误；characterEncoding=utf8 保证中文字符正常读写。这三个参数在中文教材里经常被省略，但缺了哪一个都会因为环境不同而随机翻车。

提示：连接 URL 参数之间用 & 分隔，第一个参数前用 ?。顺序不影响结果，但别手滑把 & 写成中文全角符号，这类问题报错信息很隐晦，排查起来极其浪费感情。

4.3 DBHelper 封装：PreparedStatement 防注入与资源释放

项目里一般会有一个 DBHelper 类，把所有 JDBC 样板代码封装起来，业务层只关心 SQL 和参数。核心方法长这样：

public class DBHelper { public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } public static ResultSet query(String sql, Object... params) { Connection conn = null; PreparedStatement ps = null; ResultSet rs = null; try { conn = getConnection(); ps = conn.prepareStatement(sql); for (int i = 0; i < params.length; i++) { ps.setObject(i + 1, params[i]); } return ps.executeQuery(); } catch (SQLException e) { e.printStackTrace(); return null; } } }

PreparedStatement 代替 Statement 是最基本的防 SQL 注入手段，参数用问号占位符，通过 setObject 按索引赋值。这个方法接收可变参数 Object... params，查询学生时传学号、姓名等条件值即可。返回 ResultSet 由调用方手动关闭，这种写法在课设场景够用，生产环境会用连接池，但作为教学案例结构上是合格的。

这套代码里每次 getConnection() 都会新建物理连接，课设演示没问题，但如果老师让“点击查询”连续操作几十次，频繁建连会有延迟。可以接受，不用过度设计，真到这一步，老师看的是你的业务逻辑，不是连接池。

4.4 成绩录入的事务处理：防止半截数据入库

成绩录入是教务系统里唯一涉及“写操作一致性”的功能。录入一条成绩，可能同时要检查学生是否存在、检查是否重复录入、更新成绩表。这些操作如果分步执行，中途任何一步报错，数据库就剩半截状态，比如成绩表里多了一条没有对应学生的孤儿记录。常见做法是把查重和插入包进一个事务：

public boolean addScore(int studentId, int courseId, double score) { String checkSql = "SELECT COUNT(*) FROM score WHERE student_id = ? AND course_id = ?"; String insertSql = "INSERT INTO score (student_id, course_id, score) VALUES (?, ?, ?)"; try (Connection conn = DBHelper.getConnection()) { conn.setAutoCommit(false); // 开启事务 try { // 先查重，再插入 conn.commit(); return true; } catch (SQLException e) { conn.rollback(); return false; } } catch (SQLException e) { e.printStackTrace(); return false; } }

注意 setAutoCommit(false) 开启事务，commit 成功后再提交，异常时 rollback 回滚。try-with-resources 写法让 Connection 自动关闭，避免资源泄漏。这是很多 Swing 课设代码不会教你的点，但答辩时老师如果问“成绩录入怎么保证不半途出错”，这一手能明显拉印象分。

5. 常见问题与避坑：五个高频运行时故障的现象、原因与处理

编译通过不代表能跑，能跑不代表能演示。这一章把 Swing + MySQL 课设里最高频的五个故障按“现象 → 原因 → 解决”写清楚，都是我见过的真实翻车现场。调试时建议按顺序先排查数据库，再排查代码，大多数时候能少折腾一两个小时。

5.1 现象：ClassNotFoundException: com.mysql.jdbc.Driver

报错信息是 java.lang.ClassNotFoundException: com.mysql.jdbc.Driver，抛错的位置在 Class.forName("com.mysql.jdbc.Driver") 这一行。这个错误常见于两种场景：一是项目里根本没有 mysql 驱动 jar 包；二是驱动包版本是 8.x，但代码里还写着 5.x 时代的旧类名。

原因：MySQL 8.x 的驱动类改名为 com.mysql.cj.jdbc.Driver，旧类名不再保留；如果是纯手工管理 jar 的项目，lib 目录下没放 mysql-connector-java 的 jar 包，编译能过但运行必挂。

解决：先在 IDE 里检查 External Libraries 或者 lib 目录下有没有 mysql-connector-java 的 jar 包；再对着 pom.xml 确认依赖引入了；最后看 Class.forName 里的类名。Maven 项目常见做法是把驱动类名统一改成 com.mysql.cj.jdbc.Driver，这样 MySQL 8.x 和 5.x 都能匹配上。

5.2 现象：中文字段显示成问号

登录进去之后，学生姓名、班级全是问号，或者写入数据库后查出来是乱码。这个问题的表现很多变，有可能是界面显示乱码，也有可能是数据库里存进去的就是乱码，两种情况要分开看。

原因：连接 URL 里没有 characterEncoding=utf8，驱动用服务器默认字符集通信；或者建表时用的不是 utf8 / utf8mb4，导致存储层不支持中文。

解决：连接串加上 characterEncoding=utf8；建表语句统一用 CHARSET=utf8mb4；已经建好的表可以用一句 SQL 转换：

ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4;

改完重启程序重新查询，问号会消失。注意不是只改界面代码就能解决的，数据库存储层、连接层、展示层三层字符集要一致。

5.3 现象：Unknown database 'educational_admin'

运行程序后报 java.sql.SQLException: Unknown database 'educational_admin'，说明 MySQL 里根本没有这个库，或者库名不一致。

原因：只执行了建表语句，没有执行建库语句；或者 DBHelper 的 URL 里写的库名和实际库名不一致，Linux 下 MySQL 库名区分大小写，Educational_admin 和 educational_admin 是两个库。

解决：在 MySQL 里先执行建库语句，再执行建表脚本：

CREATE DATABASE educational_admin DEFAULT CHARACTER SET utf8mb4; USE educational_admin;

然后检查 DBHelper 里 URL 的库名和实际库名是否完全一致，大小写、下划线都要对齐。这套资源里脚本名和库名是配套的，直接用脚本里的建库语句最省事。

5.4 现象：MySQL 8 连不上，报 Public Key Retrieval is not allowed

数据库是 MySQL 8.x，连接报 java.sql.SQLException: Public Key Retrieval is not allowed，这是 8.x 特有的报错，5.7 里基本见不到。

原因：MySQL 8 默认使用 caching_sha2_password 认证，第一次连接时需要通过 RSA 公钥交换密码，驱动默认不允许从服务器检索公钥，于是连接被拦下来。

解决：连接 URL 加 allowPublicKeyRetrieval=true。注意这个参数在 MySQL 5.x 下不识别，但 5.x 也不报这个错，保持 8.x 环境加这个参数即可。如果还报 SSL 错误，把 useSSL=false 一起加上，本地演示环境不需要加密链路。

5.5 现象：JTable 刷新后界面还是旧数据

点“刷新”按钮后，表格里还是旧数据，或者新数据追加在旧数据后面，越点越长。

原因：TableModel 没有清空，往同一个模型里 addRow 是追加不是覆盖；或者改了 JPanel 的内容后只调了 repaint()，没有调 revalidate()。

解决：刷新前先 model.setRowCount(0) 清空所有行，再重新填充查询结果。如果替换了内容面板，add 新组件后同时调用 revalidate() 和 repaint() 两个方法，只调 repaint() 不会触发重新布局。

这五条覆盖了环境、连接、界面三个层面，课设调试遇到报错先对着这五条过一遍，比漫无目的搜报错消息快得多。最重要的是：改完一个参数后，必须重启 Java 程序再测，数据库连接参数只在启动时加载一次，热改参数不重启是无效的。

6. 验收前的自测路径：按评审视角把程序调到“能演示”的状态

程序能编译、能登录，离“能答辩”还有一截。我见过太多组在演示现场翻车——登录进去了，点“查询成绩”按钮没反应，老师等着看界面，学生在台上手忙脚乱地切窗口。从那以后，我每次拿到课设代码都强制自己走一遍完整的验收路径，四个步骤缺一不可。

第一步，在干净环境里重建数据库：删掉旧库，重新执行 educational_admin.sql，确认脚本执行零报错。这一步能验证 sql 脚本的完整性和依赖顺序，也能顺带确认 DBHelper 里的库名、账号密码和实际环境一致，多数的“程序起不来”都是栽在这一步。

第二步，用管理员账号登录，逐个点一遍菜单：学生管理增删改查、课程管理、成绩录入与查询，每个功能至少操作一次。重点是成绩录入，因为它涉及事务和两张表的关联，最容易暴露问题。操作时看着控制台，有 SQL 异常直接记下来，别跳过。

第三步，故意做错误操作：输错密码、空值保存、删除一个已被成绩引用的学生。观察程序有没有弹窗提示、会不会直接抛异常退出。这个环节最能体现程序的健壮性，也是答辩加分项，很多课设代码根本扛不住这一步，一删就崩，老师印象分直接掉一半。

第四步，录一段三分钟的演示脚本，按“登录 → 查看学生 → 录入成绩 → 查询成绩单”的顺序排练两遍。演示脚本里把每个按钮的位置固定下来，鼠标不要乱晃，推演一下老师可能打断提问的节点，比如问“这个查询用的什么 SQL”“成绩表怎么关联的”，提前想好介绍词。

这四步走完再提交，基本不会在台上翻大车。希望帮到你。

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