Java课程设计：学生成绩查询系统（Swing+MySQL+JDBC）完整开发指南

做课程设计的时候十个题目里至少得有五六个是“XX管理系统”而学生成绩查询系统算是里面最经典、也最适合练手的一个。我自己当年就是拿这个题入门的Java从只会写Hello World到能独立跑通一个带数据库的完整项目收获非常大。这次把整个选题、设计、数据库建模、核心代码到踩坑排查的过程完整梳理出来希望能给正在做这个题目的同学或者想通过一个项目把Java基础、JDBC、MySQL、Swing这些知识点串起来的朋友一些参考。先说清楚这个项目能做什么它本质上是把原来靠Excel和口头传达的成绩管理搬到桌面上实现学生信息维护、课程管理、成绩录入、多条件查询、统计排名这些功能。教师端负责录入和审核成绩学生端负责查询自己的成绩和排名。整个系统遵循典型的三层结构——界面层、业务层、数据访问层代码写得规范一点后面往Spring Boot或者Web方向迁移时重构成本会低很多。1. 项目需求分析与整体设计思路1.1 需求拆解三类使用者的核心诉求做任何系统之前先把“谁在用什么场景下用”弄清楚。学生成绩查询系统的使用者大概分三种角色系统管理员、教师、学生。各方的痛点完全不一样。管理员的痛点是信息维护太分散。新生入学要批量建档每学期课程变化要维护课程表考试成绩要归档留痕这些工作如果纯靠手工记录后续想统计某届学生的平均绩点会非常痛苦。所以系统至少要提供学生信息管理、课程信息管理、用户账号管理这三个模块。教师的痛点集中在成绩录入和核对上。带两三个班的话每次考完试要登记上百条成绩手写登记容易抄错Excel汇总又多一道表格合并的流程。教师最希望的是能按班级和课程快速进入录入页面能批量粘粘贴数据能直观看到及格率、平均分这些汇总指标快速地发现异常分数。学生的诉求最简单直接能不能别折腾登录进去就告诉我每门课考了多少分在班级里排多少名。最好还能按学期筛选看看自己这一学年的成绩趋势。这就是需求分析的起点。把它整理成一份功能清单公共功能登录、修改密码、退出系统管理员功能学生信息增删改查、教师账号管理、课程管理、系统重置教师功能学生信息查看、成绩录入与编辑、成绩导出、统计报表学生功能个人成绩查询、班级排名查询、学期成绩单提示第1步别急着写代码先把用例图画出来。用ProcessOn或者draw.io画一张用例图把角色、用例、关系梳理清楚后面写代码会顺很多。我自己就是先画图再建表思路比直接上手建工程清晰得多。1.2 技术选型盘点Java Swing MySQL 还是 Web方向技术选型往往是同学们最纠结的地方。标题写的是“基于Java”没有限定Web还是桌面端。我个人的建议是课程设计场景优先选Java Swing MySQL JDBC这套桌面站组合原因有四个。第一Swing是JDK自带的GUI框架不需要额外装Tomcat、不需要写前端HTML和CSS环境成本最低。只要装了JDK就能跑实验室的机器也不会出幺蛾子。第二JDBC是Java访问数据库的底层规范。把JDBC这一层吃透了哪怕以后用MyBatis、JPA这些框架你也能理解它们底层到底在替你做哪些事。学框架到处复制粘贴和真正懂底层的差距就在这些基础点上。第三桌面端程序的功能边界更清晰。不需要考虑浏览器兼容性、前端路由、跨域这些问题能把全部精力放在核心业务逻辑和数据库设计上。第四如果后面你想走Web方向这套桌面端的业务逻辑和DAO层代码可以平移到Spring Boot里Service层几乎不用改只需要把Swing界面替换成Controller Vue页面就行。我在第5部分会专门聊这个迁移思路。当然如果导师明确要求Web端那就用Spring Boot Vue MySQL这套方案架构上依然是“业务逻辑 数据访问 前端展示”的三层关系下面讲的数据库设计和DAO思路完全通用。1.3 项目包结构设计包结构是很多新手忽略的重点但它直接影响代码的可维护性。推荐用下面这套分包方案虽然看着多但每个类职责单一排查问题的时候能快速定位。com.student.system ├── MainApp.java // 程序入口 ├── entity/ // 实体类Student, Course, Score, User ├── dao/ // 数据访问层StudentDao, ScoreDao, UserDao ├── service/ // 业务层LoginService, ScoreService ├── ui/ // 界面层LoginFrame, MainFrame, ScoreManagePanel ├── util/ // 工具类DBUtil, ExcelUtil └── config/ // 配置文件db.properties分层的好处我用一句话总结界面层只负责和用户打交道业务层只负责逻辑判断数据层只负责SQL操作。谁也别跨界谁出了问题就找谁。2. 数据库设计与核心表结构2.1 数据库建模四张表搞定所有需求学生成绩查询系统的核心数据无非是人学生、教师、课程、分数。再加上登录认证需要的账号信息一共四张表就能覆盖全部需求。第一张表是用户表t_user保存登录账号、密码和角色。角色用role字段区分1表示管理员2表示教师3表示学生。这里要注意密码不能明文存储至少要加一层MD5加密虽然MD5本身并不是安全级别最高的方案但在课设场景里已经能说明你有这方面的意识。第二张表是学生表t_student保存学生的基本信息。学号student_no要加唯一约束这是学生在系统里的天然业务主键。班级字段class_name单独存字符串不单独建班级表这个细节我是刻意这么做的。原因是课设场景下班级数量少、字段属性简单建一张班级表反而增加联表查询的复杂度。当然如果你要做成班级维度的成绩汇总报表那还是单独建表更规范。第三张表是课程表t_course保存课程名称、学分和开课学期。这部分逻辑简单但是要考虑一个细节同一个课程可能在不同学期开课所以course_name semester要不要做联合唯一约束我的建议是加上否则成绩表里的课程记录会越积越乱。第四张表是成绩表t_score这是整个系统的核心表。每条记录描述“某个学生在某次考试的某门课程上拿了多少分”。除了学生和课程的外键之外还要记录考试类型exam_type比如期中、期末因为一门课一学期可能考多次。CREATE TABLE t_user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, role TINYINT NOT NULL DEFAULT 3, real_name VARCHAR(50), status TINYINT DEFAULT 1 ); CREATE TABLE t_student ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, gender CHAR(1), class_name VARCHAR(50), enroll_year VARCHAR(4) ); CREATE TABLE t_course ( id BIGINT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(50) NOT NULL, credits DECIMAL(3, 1), semester VARCHAR(20) ); CREATE TABLE t_score ( id BIGINT PRIMARY KEY AUTO_INCREMENT, student_id BIGINT NOT NULL, course_id BIGINT NOT NULL, exam_type VARCHAR(20) DEFAULT 期末, score_value DECIMAL(5, 2), exam_date DATE, FOREIGN KEY (student_id) REFERENCES t_student(id), FOREIGN KEY (course_id) REFERENCES t_course(id) );2.2 外键、索引与数据完整性成绩表里的student_id和course_id一定要加外键约束这一步很多同学图省事不加结果就是删了某个学生之后成绩表里还残留一堆孤儿数据统计的时候莫名其妙的数字出来排查得头大。外键真正的意义有两个一是数据库层面保证引用的完整性二是告诉后来看代码的人这两张表是有业务关联的。虽然很多生产级系统会从性能出发禁用外键但在课设这种量级的数据量下外键的约束能力远比那一点性能损耗重要。索引方面t_score表要针对查询场景建立联合索引。成绩查询最常见的条件组合是“按学生查所有成绩”和“按课程查所有学生”所以建议ALTER TABLE t_score ADD INDEX idx_student_score (student_id, course_id); ALTER TABLE t_score ADD INDEX idx_course_score (course_id);提示索引不是越多越好。每次写操作都要维护索引索引太多反而拖慢写入速度。核心经验是索引只加在 WHERE 和 JOIN 条件里高频使用的字段上。2.3 初始化数据与测试数据准备设计完表结构先别急着写业务代码马上把初始化数据灌进去。这步能帮你验证表设计是否合理比如字段长度够不够、类型对不对、有没有漏掉必填字段。初始化数据至少包含一个管理员账号、两三个教师账号、几个班的几十个学生、几门课程、几十条成绩记录。有了这些数据写界面的时候就能立刻看到JTable里的效果不用等业务代码全部写完再回头去造数据。我习惯把初始化SQL单独放在一个init_data.sql文件里每次重建数据库直接执行一遍方便又省事。3. 核心功能实现与代码解析3.1 数据库连接工具类JDBC 连接复用与参数配置数据库连接这块新手最容易踩的坑就是把连接代码散落在各个DAO里每个方法都写一遍DriverManager.getConnection。正确的做法是抽一个独立的工具类统一管理连接和资源释放。连接参数放到db.properties配置文件里不要硬编码在Java代码中。原因很简单数据库地址、账号、密码属于环境信息换一个环境就要改代码重新编译这非常不规范。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/student_score?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456public class DBUtil { private static String driver; private static String url; private static String user; private static String password; static { try (InputStream in DBUtil.class.getClassLoader().getResourceAsStream(db.properties)) { Properties props new Properties(); props.load(in); driver props.getProperty(jdbc.driver); url props.getProperty(jdbc.url); user props.getProperty(jdbc.username); password props.getProperty(jdbc.password); Class.forName(driver); } catch (Exception e) { throw new ExceptionInInitializerError(数据库配置加载失败); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, user, password); } public static void close(ResultSet rs, Statement stmt, Connection conn) { if (rs ! null) { try { rs.close(); } catch (SQLException e) { e.printStackTrace(); } } if (stmt ! null) { try { stmt.close(); } catch (SQLException e) { e.printStackTrace(); } } if (conn ! null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }JDBC URL里characterEncodingutf8这个参数是中文不乱码的关键少了它界面显示中文很可能是问号。另外MySQL 8.x 以上要用com.mysql.cj.jdbc.Driver老版本的com.mysql.jdbc.Driver会直接报驱动类找不到。3.2 登录功能与密码加密登录是所有系统绕不开的入口功能本身简单但代码质量能看出基本功。推荐的方式是防止SQL注入用PreparedStatement而不是字符串拼接。写SQL的时候直接拼username and password 这种代码我再强调一遍这是严重的安全隐患。如果用户在用户名框里输入 or 11拼出来的SQL就是恒真条件不需要密码也能登录成功。public User login(String username, String password, int role) { String sql SELECT * FROM t_user WHERE username ? AND password ? AND role ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, MD5Util.md5(password)); ps.setInt(3, role); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { User user new User(); user.setId(rs.getLong(id)); user.setUsername(rs.getString(username)); user.setRole(rs.getInt(role)); user.setRealName(rs.getString(real_name)); return user; } } } catch (SQLException e) { e.printStackTrace(); } return null; }登录成功后要把User对象暂存到一个全局Session类里界面根据role字段决定显示哪些菜单。这一步逻辑虽然简单但它是权限控制的雏形值得用心写。注意不要只在登录的时候判断一次角色后面所有功能入口都要做角色校验。有些同学写的系统登录页是管理员进去了然后切到某个子界面发现数据都暴露了这就是典型的权限校验不彻底。3.3 成绩查询的核心SQL多条件动态拼接与参数化成绩查询是整个系统的重头戏。常见的查询组合有按学号查、按姓名模糊查、按班级查、按课程查、按分数区间查。这五个条件自由组合对应的SQL就是动态拼接。但这里有一个坑动态拼接SQL很容易拼出语法错误或者引入注入风险。正确的做法是用一个ListObject收集参数先拼个基础SQL框架然后根据传入条件逐个追加AND子句。所有变量值一律用?占位符传入。public ListScoreVO queryScores(String studentNo, String studentName, String className, Long courseId, Double minScore, Double maxScore) { StringBuilder sql new StringBuilder(); sql.append(SELECT s.student_no, st.name, st.class_name, c.course_name, ); sql.append( sc.exam_type, sc.score_value, sc.exam_date ); sql.append(FROM t_score sc ); sql.append(JOIN t_student st ON sc.student_id st.id ); sql.append(JOIN t_course c ON sc.course_id c.id ); sql.append(WHERE 1 1 ); ListObject params new ArrayList(); if (studentNo ! null !studentNo.trim().isEmpty()) { sql.append(AND s.student_no LIKE ? ); params.add(% studentNo.trim() %); } if (studentName ! null !studentName.trim().isEmpty()) { sql.append(AND st.name LIKE ? ); params.add(% studentName.trim() %); } // 其他条件以此类推... try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql.toString())) { for (int i 0; i params.size(); i) { ps.setObject(i 1, params.get(i)); } try (ResultSet rs ps.executeQuery()) { ListScoreVO list new ArrayList(); while (rs.next()) { // 封装结果 } return list; } } catch (SQLException e) { e.printStackTrace(); return Collections.emptyList(); } }这里的几个SQL细节值得展开说。第一LIKE % ?这种写法占位符里只放具体值%放在拼SQL的地方。有的同学是把%传到参数里这样也能工作但可读性差很多。第二多表联查一定要给表起别名s、st、c、scSQL复杂起来别名能极大提升可读性。第三WHERE 1 1这个技巧在动态拼接时特别好用。有了它前面那个AND就不用判断是不是第一条条件。代价是SQL有点丑但换来的是拼接逻辑的简洁这笔交易很划算。第四成绩表里存的是student_id主键但界面上要展示的是student_no学号。这就是为什么要通过JOIN关联t_student表把学号和姓名带出来。有些同学犯懒直接在成绩表里冗余存一份学号表面看省了一次联表实际上破坏了数据的一致性。假如学生在基础信息维护时改了一次学号成绩表里的冗余字段没跟着变数据就对不上了。3.4 成绩统计与排名聚合查询和窗口函数除了查询成绩列表一个完整的学生成绩查询系统还应该包含统计功能。常用的统计指标有单科最高分、最低分、平均分、及格率以及每个学生在班级里的排名。单科统计用聚合函数即可String sql SELECT COUNT(*) AS stu_count, AVG(score_value) AS avg_score, MAX(score_value) AS max_score, MIN(score_value) AS min_score, SUM(CASE WHEN score_value 60 THEN 1 ELSE 0 END) / COUNT(*) * 100 AS pass_rate FROM t_score WHERE course_id ? AND exam_type ?;排名这里有个进阶技巧MySQL 8.0 支持窗口函数RANK()可以直接按分数从高到低生成排名。如果你的MySQL版本是5.x那就只能通过自关联查询去模拟排名稍微麻烦一些。String sql SELECT st.name, sc.score_value, RANK() OVER (PARTITION BY st.class_name ORDER BY sc.score_value DESC) AS class_rank FROM t_score sc JOIN t_student st ON sc.student_id st.id WHERE sc.course_id ?;PARTITION BY在这里的作用是按班级分区同一个班级里进行RANK排名跨班级互不影响。这和Excel里的隐藏行求名次是两码事数据库里一条SQL就搞定了。3.5 界面实现JTable的数据绑定与刷新Swing做界面核心控件就是JTableDefaultTableModel。很多新手在这里栽跟头直接用JTable的默认构造函数然后发现表格不会自动刷新数据。正确做法是定义一个DefaultTableModel设置好列名后用model.setRowCount(0)清空旧数据然后逐行添加新数据最后调用table.setModel(model)或者model.fireTableDataChanged()通知界面刷新。private void refreshTable(ListScoreVO list) { String[] columns {学号, 姓名, 班级, 课程, 考试类型, 分数, 考试日期}; DefaultTableModel model new DefaultTableModel(columns, 0); for (ScoreVO vo : list) { model.addRow(new Object[]{ vo.getStudentNo(), vo.getStudentName(), vo.getClassName(), vo.getCourseName(), vo.getExamType(), vo.getScoreValue(), vo.getExamDate() }); } scoreTable.setModel(model); }这里比较容易忽略的是JTable默认是不可编辑的但如果数据绑定的是默认的模型用户在界面上双击单元格会发现内容可以改。这其实是一个安全隐患一定要重写isCellEditable方法返回falsemodel new DefaultTableModel(columns, 0) { Override public boolean isCellEditable(int row, int column) { return false; } };4. 实操问题与排查技巧实录4.1 数据库连接失败的排查思路每次写完一段功能跑起来就报Communications link failure或者Access denied for user是课设阶段极其常见的事情。这两条报错的原因完全不一样排查方向也不同。Communications link failure一般是MySQL服务没启动或者URL里端口写错。检查顺序是先用命令行mysql -u root -p试能不能连上再检查服务有没有监听3306端口。如果是新装的MySQL 8.x连接URL必须带useSSLfalse否则会报SSL握手相关的警告甚至直接失败。Access denied for user是账号密码错误但更隐蔽的一种情况是root账号只允许 localhost 登录如果用JDBC连接时把主机写成了127.0.0.1或%会因为主机校验不一致被拒。解决方式是把db.properties里localhost和MySQL用户表里的Host字段对齐。4.2 中文乱码问题中文乱码在桌面端项目里非常常见。现象就是界面上显示“学号”变成“???”往数据库里写入中文后查出来是一堆问号。问题通常出在三个环节。第一个环节是JDBC连接URL缺了characterEncodingutf8这相当于告诉MySQL客户端用默认字符集去传输数据如果你的数据库建库不是UTF8必然乱。第二个环节是MySQL数据库本身字符集不是UTF8。建库的时候要用CREATE DATABASE student_score DEFAULT CHARACTER SET utf8mb4;。注意utf8mb4和utf8的区别utf8mb4 是 utf8 的超集能存储Emoji等4字节字符建议直接用 utf8mb4。第三个环节是Swing界面字体渲染问题。有些操作系统默认环境下Swing字体没指定中文字体时确实会出现方框。解决方式是在主界面设置统一字体Font font new Font(微软雅黑, Font.PLAIN, 14); UIManager.put(Label.font, font); UIManager.put(Button.font, font); UIManager.put(Table.font, font);提示排查乱码有个“三段法”技巧。先查数据库命令行SELECT出来乱不乱判断问题在存储层再在DAO层打印SQL和参数判断参数传递是否正常最后看界面显示判断是渲染问题还是数据问题。一层一层定位千万不要上来就乱改。4.3 连接泄漏问题课设项目里最大的性能问题通常来自连接未释放。很多同学写完一次SQL把Connection、Statement、ResultSet扔在那里不关程序跑着跑着就报Too many connections。JDBC的Connection资源是昂贵的底层是TCP连接每开一个都不便宜。长期不关就是连接泄漏数据库连接池很快被耗尽。现代Java工程推荐用try-with-resources语法来自动关闭资源。这个语法是 Java 7 引入的只要你使用的资源类实现了AutoCloseable接口Connection、Statement、ResultSet都实现了就不用手写finally块手动关闭。4.4 多条件查询的SQL拼接难题动态SQL拼接算是这个项目的技术难点很多人写出来的代码要么括号不匹配要么条件少一个空格。我推荐一种通用写法先把SQL拆成三段SELECT部分保持不动FROM和JOIN部分先拼好然后把查询条件集中放在WHERE 1 1后面每增加一个条件就是一行AND xxx ?。这样加条件只动一个地方不容易出错。另外如果你发现SQL里AND前面少了一个空格导致拼接后的SQL变成WHERE 11AND st.name LIKE ?这属于老生常谈的坑。所以拼接SQL时每个条件子句的头尾都留一个空格类似 AND st.name LIKE ? 这样无论怎么拼都不会粘连。问题现象可能原因解决方案运行报 ClassNotFoundExceptionJDBC驱动JAR没引入把 mysql-connector-java JAR 添加到项目依赖界面中文显示问号URL缺字符集参数加 useUnicodetruecharacterEncodingutf8登录成功的用户能改所有数据权限校验缺失所有写操作前用Session检查角色表格内容不能实时刷新没触发模型更新调用 fireTableDataChanged()统计数字不对成绩表有脏数据检查外键约束和录入逻辑5. 项目扩展与实操心得5.1 从桌面端迁移到 Web 端的思路如果你的课程设计要求更高一些或者导师要求必须做Web端这个项目的迁移路径其实很清晰。核心思路是保留entity和dao这套数据层代码用Web框架替换掉Swing界面层。在 Spring Boot 方案里原来的service层直接变成Service注解的业务类dao层可以用 MyBatis 注解或 XML 来重写SQLui层整体替换成RestController接口前端用 Vue Element Plus 重画一套页面。你会惊讶地发现因为之前分层设计做得好从Swing迁移到Web大部分业务逻辑代码是可以直接复用的。很多同学到了大四做毕设才意识到这一点那时候再重构成本就高了。5.2 功能增强Excel导出与密码找回如果基础功能做好了还有余力我推荐加两个实用功能。一个是成绩导出Excel。Java桌面端做Excel导出最方便的是用Apache POI库。核心代码就几行创建一个XSSFWorkbook创建Sheet和Row把成绩数据循环写入最后用FileOutputStream保存到本地。有了这个功能老师期末登记成绩时系统可以一键导出每个班的成绩单实用价值瞬间提升。另一个是管理员重置密码。学生忘记密码这种场景在班级系统里很常见与其让所有人共用一套密码不如在管理员界面上加一个“重置密码”按钮把指定账号密码重置为初始密码。用一句话解释就是管理员在界面上选中用户点按钮后台执行一条UPDATE t_user SET password ? WHERE username ?完事。5.3 从课设到工程几个习惯让我少走了很多弯路整个项目做完我自己最有感触的倒不是哪个SQL写得巧妙而是一些平时容易忽略的小习惯。第一写代码前先花半小时把数据库表结构和用例图画出来这一点值得反复强调。我见过太多同学直接上手写代码写到一半发现表少了一个字段改表结构连带改一堆DAO方法开发效率直线下降。第二实体类名称和数据库表字段保持一致不要这里映射一个名字那里又取另一个。好习惯是数据库字段用下划线风格实体类用驼峰然后通过固定的转换规则对应起来。如果后面用了MyBatis这个规则可以直接由框架自动处理。第三每次修改了数据库结构用版本号管理好init_data.sql文件。我吃过一次亏折腾了半天的表结构忘了导出重装系统后数据库全没了只好顶着麻烦重建。从那以后我养成了修改表结构就立即更新SQL脚本的习惯。第四这个项目虽然是课设级别但如果你在答辩时能把“为什么要用PreparedStatement防注入”“为什么要分层”“为什么成绩表要用外键”这些设计理由讲清楚老师给的分数一定不会低。技术深度不在用了多牛的框架在于你是否真的理解自己写下的每一行代码背后的权衡。回看整个项目学生成绩查询系统麻雀虽小但五脏俱全从界面交互到数据库设计从用户权限到统计报表几乎覆盖了一个业务系统从零到一的全部环节。做一遍这个项目Java基础、JDBC、MySQL、面向对象设计这些课上听起来抽象的知识点全部落地变成了看得见摸得着的东西。接下来如果你想更进一步在这个基础上加上班级均分对比图、成绩趋势折线图、PDF成绩单导出其实就是把同样的设计模式往不同的功能上套自己的技术边界也在这个过程中慢慢拓宽了。