简介面向Java初学者的Swing成绩管理系统源码项目完整覆盖学生信息维护、成绩录入查询、统计分析、数据持久化、权限控制与事件处理等桌面应用常见场景可帮助学习者理解Java GUI程序从界面搭建、业务逻辑编写到数据库连接的完整过程。压缩包共54个文件主体为5个Java源文件与29个class字节码另包含MySQL 8.0.16驱动JAR、工程配置文件及说明文档整体大小仅2.12MB结构紧凑便于按需查看源码和直接运行。当前已有79人学习浏览。代码按角色设计了选择入口、学生端与教师端界面通过JTable展示数据、按钮触发操作并配合异常处理和输入校验保证程序稳定从各界面类与模型类的协作中可以学到Swing常见布局、事件监听器用法以及基于JDBC的数据增删改查思路。项目还体现了用户角色区分与数据保存策略对于完成课程设计、毕业设计或入门Java桌面开发都有直接参考价值尤其适合需要实现可视化成绩管理原型并理解前后端交互流程的学习者。 如果你的课程设计任务清单里躺着“Java swing成绩管理系统”这一项别急着叹气。这个题目看起来普通但每年都有大量学生在这上面翻车环境变量没配好、JDBC驱动加载失败、JTable数据不刷新、MySQL编码乱码、答辩时被问到底层原理直接卡壳。我见过太多人不是因为不会写代码挂掉而是因为项目看着“太像抄的”而答不上来。这篇文章不会只给你一份能跑的代码而是把你从选题、建库、写界面到排错、答辩、扩展的完整链路梳理清楚让你做出来的东西既能用、又能讲、还扛得住追问。先说清楚这篇博文能解决什么问题我会带你拆解一个基于Java Swing MySQL JDBC的典型成绩管理系统覆盖核心模块设计、关键代码实现、高频运行报错的排查思路以及如何从“能跑”升级到“拿得出手”。适合正在做课程设计、毕业设计或者想用Swing快速练手Java的同学参考。1. 从选题到选型为什么Swing依然是课程设计的首选很多人看到Swing的第一反应是“老古董”。确实JavaFX、Web前端、Spring Boot满天飞的今天Swing看起来毫无现代感。但你要明白一个事实课程设计的评分标准从来不是“用了最新的技术”而是“你能不能说清楚系统是如何工作的”。Swing最大的优势在于三点。第一它是JDK自带的GUI工具包不需要额外配置复杂的前端构建链装好JDK打开IDE就能写。第二它的MVC思想非常直白JTable对应视图TableModel对应数据模型控制器就是你的ActionListener这种结构拿来解释“分层设计”刚刚好。第三它的控件体系足够完整表格、树、选项卡、对话框全都有做一个管理类系统绰绰有余。如果你的核心诉求是“快速做出一个功能完整、能演示、能答辩的管理系统”Swing的性价比远高于你去现学Vue和Spring Boot。而且Swing项目跑起来轻快不像Spring Boot启动就要占几百MB内存在机房老机器上也能流畅演示。选型层面我建议技术栈固定为Swing负责界面JDBC负责数据库访问MySQL负责存储再叠加一个分层结构——视图层View、业务层Service、数据访问层DAO。不要图省事把SQL直接全写在按钮监听器里等你答辩被问到“怎么改造成三层架构”时代码横向一比就露馅了。2. 数据库先行三张业务表加一张用户表的建模思路写Swing和写网页不一样你没法像前端那样先搭个页面再用接口连数据。更顺的路线是先把数据库建好再把界面字段与表字段一一对应最后才写监听逻辑。数据库是成绩管理系统的骨架骨架歪了后面所有代码都在打补丁。常见的成绩管理系统最少需要四张表用户表user、学生表student、课程表course、成绩表score。下面是我认为最合理的字段设计直接照着建就行-- 用户表 CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) UNIQUE NOT NULL, password VARCHAR(64) NOT NULL, role VARCHAR(20) DEFAULT student ); -- 学生表 CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, stu_no VARCHAR(20) UNIQUE NOT NULL, name VARCHAR(50) NOT NULL, gender VARCHAR(10), class_name VARCHAR(50), phone VARCHAR(20) ); -- 课程表 CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_no VARCHAR(20) UNIQUE NOT NULL, course_name VARCHAR(50) NOT NULL, credit DOUBLE ); -- 成绩表 CREATE TABLE score ( id INT PRIMARY KEY AUTO_INCREMENT, stu_id INT NOT NULL, course_id INT NOT NULL, score DOUBLE, FOREIGN KEY (stu_id) REFERENCES student(id), FOREIGN KEY (course_id) REFERENCES course(id) );这里有几个建模时容易忽略的点逐个说。第一为了保障数据一致性成绩不单独存学号和课程名而是存外键stu_id和course_id查询时再关联学生表和课程表。这不是为了炫技而是防止你删掉一个学生后成绩表里留着一堆幽灵数据。第二密码字段长度我特意设置成64位因为要用MD5加密存储。直接存明文是课程设计里最严重的扣分点答辩时老师看到密码表里是一串md5值首先能感受到你具备安全常识。第三student和course的编号字段都加了UNIQUE约束避免重复录入。成绩表里最好再加一个联合唯一索引UNIQUE(stu_id, course_id)防止同一个学生同一门课录入两次成绩。这个小细节也很加分因为说明你考虑过重复数据问题。建完表之后打开你的数据库图形化工具Navicat、DataGrip、MySQL Workbench都行生成一份ER关系图并截图保存。后面无论是写课程设计文档还是答辩做PPT这张图都是核心素材。3. 功能模块落地登录、CRUD与模糊查询的实现顺序3.1 登录模块考虑角色判断和密码加密页面设计上不要一上来就搞花哨的动画Swing做动画既费劲又不讨好。你可以用JFrame作为主窗口内部嵌套JPanel用GridBagLayout把用户名、密码、登录按钮居中排列。登录按钮的事件处理逻辑按下面这个思路来写LoginService.login(username, password);Service层内部做的事情主要包括以下几步。第一步传入用户名和密码密码用MessageDigest做MD5加密注意加盐md5(password username)这样即使两张表拿到相同密码明文字段也不会一样。第二步执行SQL查询用PreparedStatement而不是Statement减少拼接SQL带来的注入问题SELECT * FROM user WHERE username ? AND password ?第三步拿到查询结果后根据role字段的值决定跳转到哪个主界面。比如admin进入管理员界面student进入学生查询界面。这比做一个按钮管全部要专业得多。实际写代码时新手的常见错误是点击登录按钮后没有做空值校验用户名或密码为空时SQL还能继续跑然后报一堆看不懂的异常。所以在调用登录逻辑前先判断输入框内容是否为空为空就弹JOptionPane提示信息并直接return。3.2 学生管理与课程管理标准CRUD的样板代码学生管理和课程管理的界面结构可以完全一致左右分栏布局左边是以JTable为核心的表格展示区右边是表单输入区学号、姓名、性别、班级、电话等。按钮设计为四个新增、修改、删除、清空。按钮的事件处理要遵循同样的套路新增从输入框取数据校验非空调用DAO层的addStudent(Student s)执行成功后在表格模型中插入一条新行并清空输入框。修改先获取表格当前选中行的ID然后判断ID是否为-1为-1则提示先选择一行否则更新数据库后刷新表格。删除执行前二次确认点击“是”才真正调用删除语句这是一个很有必要的防误删设计。清空把输入框全部置为空字符串但不要触碰表格数据。写DAO层时注意打开连接用try-with-resources让Connection、PreparedStatement、ResultSet自动关闭try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { // 设置参数并执行 }如果你还在手动写Connection c null然后最后在finally里一个个close这部分代码冗余又容易出错。换成try-with-resources后不但代码干净还能在答辩时显得更熟悉Java 7以上的语法特性。3.3 成绩管理组合查询带来的SQL分页难度成绩模块是系统的核心也是课程设计的重点加分项。界面布局建议用JTabbedPane分成两个选项卡一个叫“成绩录入”一个叫“成绩查询”。成绩录入界面的核心控件是JComboBox——课程下拉框里装课程名学生信息下来框里装学生姓名选好后填分数点击“保存”。这里存在一个隐藏坑JComboBox里显示的是文字但你存到成绩表里需要的是对应的ID。所以常规做法是自定义一个Item对象重写toString方法返回名字同时保存id引用选中后通过getSelectedItem拿到整个对象再取id。成绩查询模块才是真正拉开档次的地方。不要做成简单全表查询而是做组合查询条件包括学生姓名模糊、课程名称精确、分数区间min到max。界面上放三个输入条件框和一个查询按钮SQL动态拼接。这种按需查出的结果比一次性全查出来再在内存里过滤要更有说服力。写动态SQL时要小心SQL注入可以用下面的模板StringBuilder sql new StringBuilder( SELECT s.stu_no, s.name AS student_name, c.course_name, sc.score FROM score sc JOIN student s ON sc.stu_id s.id JOIN course c ON sc.course_id c.id WHERE 11); if (!name.isEmpty()) { sql.append( AND s.name LIKE ?); params.add(% name %); } if (!courseName.isEmpty()) { sql.append( AND c.course_name ?); params.add(courseName); }这里的WHERE 11只是一个占位技巧是为了后面拼接AND条件的方便不是SQL语法错误。在答辩时如果被追问你可以如实说这是为了让动态条件拼接更简洁。4. JTable动态刷新与窗口跳转最容易卡住的三个细节4.1 数据刷新不是重新设置TableModel而是通知模型刷新很多人在修改或删除数据后为了让界面上显示最新结果会执行类似于table.setModel(buildTableModel(newResultSet))这样的代码。这样做在功能上是没错的但它会丢失列的宽度设置、选中状态和表头渲染样式。正确的思路是保留TableModel对象通过更新其中的数据集合然后调用fireTableDataChanged()方法通知表格重绘DefaultTableModel model new DefaultTableModel(data, columnNames); table.setModel(model); // 数据变更后 model.setRowCount(0); // 清空旧数据 for (Object[] row : newDataList) { model.addRow(row); } model.fireTableDataChanged();上面的写法是对的。因为DefaultTableModel基于Vector存储行数据只要你在调用了setRowCount(0)和addRow后界面自然会被刷新。真正的问题在于如果你新增数据后只更新数据库而忘了更新TableModel就必须刷新整个表格。比较实用的模式是把加载表格数据的方法抽成refreshTable()每次增删改成功后在回调里调用一次从而保证数据库和界面的一致性。4.2 子窗口修改数据后主窗口怎么同步更新成绩管理系统里你很可能会有“在子窗口中编辑成绩点确定后回到主窗口需要刷新数据”的需求。实现方式很简单子窗口提供一个私有的boolean变量isUpdated点击“确定”按钮时把它设为true。主窗口需要把子窗口设为模态对话框例如setModal(true)然后再执行setVisible(true)后面的逻辑此时可以判断isUpdated的值为true就刷新主窗口表格。这样做的原理是JDialog模态框在关闭时会阻塞主窗口的代码流所以setVisible(true)后面的代码会在对话框关闭后继续执行。普通课程设计很多人遇到这个问题会通过反复重新打开主界面来缓解效果很糟。如果能在答辩前把这个细节改了演示体验会好很多。4.3 表格列宽设计直接决定演示体验JTable默认列宽分配往往是平均的但成绩管理界面里“学号”和“学生姓名”显然不需要等宽。推荐在封装表格时手动指定列宽度和拖拽行为TableColumnModel colModel table.getColumnModel(); colModel.getColumn(0).setPreferredWidth(100); // 学号 colModel.getColumn(1).setPreferredWidth(120); // 姓名 colModel.getColumn(2).setPreferredWidth(150); // 课程名 colModel.getColumn(3).setPreferredWidth(80); // 分数 table.setAutoResizeMode(JTable.AUTO_RESIZE_OFF);同时设置表格可选行单选将selectionMode设为ListSelectionModel.SINGLE_SELECTION避免用户多选后点击删除导致逻辑混乱。单元格不可编辑重写isCellEditable返回false否则用户双击表格单元格程序会尝试直接编辑底层数据。5. 高频运行报错排查从环境变量到ClassNotFound的完整链路Swing项目可以说是“写起来容易跑起来报错一堆”。下面这几个报错出现的频率极高我把完整的排查思路写出来。5.1 java.lang.NoClassDefFoundError你搜热词的时候会看到一条uncaught exception java.lang.noclassdeffounderror: java/applet/applet in thread。这类错误发生的原因很一致你编译用的JDK版本比运行时环境高或者是用了太高版本的JDK启动一个需要applet API的旧项目。Java 11已经移除了java.applet.Applet类所以如果项目里存在旧依赖引用就会在运行时报NoClassDefFoundError。排查思路分三步。第一步打开终端输入java -version和javac -version确认两次输出的版本是否一致。第二步检查IDEA的项目结构里Project SDK和项目语言级别Project Structure是否匹配不匹配就统一改成一致版本第三步如果你用的是Maven或Gradle项目检查pom.xml或build.gradle里依赖的编译级别例如maven.compiler.source和target是否与JDK匹配。项目中不要直接用Applet类它是Java早期的浏览器嵌入方案跟桌面程序没有任何关系。5.2 Lombok报错You arent using a compiler supported by Lombok热词里有一条很典型的Lombok错误。Lombok在较新版本的JDK上尤其是非官方版本或早期预览版上会报“you arent using a compiler supported by lombok”。虽然成绩管理系统里完全可以不用Lombok但如果你从GitHub上拉来的参考代码里用了Data、Getter等注解而你的IDE没有安装Lombok插件或者JDK版本过新就会触发这个报错。最简单的解决办法不使用Lombok把实体类的getter/setter手写出来也就几十行代码但排除了一个最大的环境隐患。如果你坚持用Lombok先装插件再把依赖版本升到最新同时把JDK降到Lombok官方支持的版本范围比如JDK 8或JDK 11。5.3 mysql驱动加载不到Class.forName抛ClassNotFoundException凡是Swing连MySQL的项目新手最常见的问题就是明明在项目里引入了mysql-connector-java.jar运行时却仍然报ClassNotFoundException: com.mysql.cj.jdbc.Driver。原因通常是三种。第一jar包没有真正进入运行时的classpath在IDEA里需要右键jar包选择Add as Library第二驱动类名写错5.x版本用com.mysql.jdbc.Driver8.x版本用com.mysql.cj.jdbc.Driver第三你用命令行运行程序但jar包没放在classpath指定的目录下。建议统一使用8.x版本驱动和对应的Driver类连接URL再加两个参数jdbc:mysql://localhost:3306/score_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8不指定serverTimezone会报时区错误不指定characterEncodingutf8则插入中文会变成问号。这两个参数可以说是Swing连接MySQL必踩的坑。环境变量配置的热词常年搜索量很高稍有基础的人都从JDK和PATH配起但真正让项目跑不起来的问题往往出在这里的classpath和驱动版本上。5.4 Redis的increment()报错如果你在课程设计中主动引入了Redis做缓存这属于加分项。但注意Redis存储的value必须是字符串或整数类型使用increment()时报“not integer or out of range”通常因为执行increment之前这个key对应的value是字符串“abc”或一个超大的数值。产生原因业务代码里先使用set方法写入字符串再对它调用increment操作。解决办法是严格规划key的类型所有做计数的key从初始化就用incr操作创建不要在计数逻辑里混用set存普通字符串。Redis在单纯成绩管理系统中不是必需品如果你用Redis建议用StringRedisTemplate来处理计数相关的数据。6. 扩展与答辩从照样跑通到真正拿得出手成绩管理系统这类题目老师看过的版本比大多数学生写过的代码都多。想拿高分功夫要下在功能和讲解之外的几个地方。6.1 三个有区分度的扩展点最建议做的是这三个扩展导入导出Excel、可视化统计报表、管理员审核学生信息。Excel导入导出用Apache POI核心代码不外乎创建工作簿、创建行、创建单元格但能实现真正可用的批量添加学生功能统计报表不追求高深用JFreeChart做一个班级各科平均分的柱状图就能让界面档次提升不少审核机制的意思是学生账号注册后是待审核状态管理员审批后才能登录这体现的是状态流转的设计思路。三个扩展选一个做就好不要贪多。课程设计评审看的是完整度一个模块做到闭环并说得清胜过三个半成品堆在一起。6.2 答辩现场怎么讲项目答辩不夸张地说会讲三分功。介绍项目的黄金结构是“信息系统三句话”第一句系统面向什么角色解决了什么问题第二句系统的核心业务流程是什么从登录到录成绩到查成绩第三句自己最熟悉的一个技术难点。如果你的项目里加入了动态SQL组合查询就主动讲怎么拼接参数、怎么防止注入、为什么用PreparedStatement而不是Statement。如果你的项目实现了MD5加密存储密码就讲为什么要加密加密流程如何为什么还要加盐。老师通常会沿着你抛出来的点去追问所以不要主动提自己都没搞懂的部分。6.3 课程设计说明书写法参考如果你在写课程设计说明书文档结构建议按这个顺序组织封面学校模板摘要概括系统功能、技术栈、核心难点300字左右即可目录第一章 需求分析明确角色管理员、教师、学生、功能列表、用例描述第二章 总体设计架构分层图、功能模块图、数据库ER图第三章 详细设计逐个模块说明界面设计和关键代码第四章 系统测试设计几个测试用例含正常数据和异常数据表格形式展示第五章 总结写收获与不足文档中放界面的截图很重要放代码不要整段贴只贴关键方法不要贴得贵在精代码截全图反而显得没有整理。最后再分享一个经验项目做完之后不要急着交先在命令行里用一个全新的工作目录跑一遍整个流程模拟老师的检查环境。如果在你自己的电脑上能正常运行到老师那里换了一台机器却报错进不去前面所有努力都白费了。把JDK、MySQL版本号记好写进README能省去现场一半的麻烦。本文还有配套的精品资源点击获取