尧图网站建设 
简介本资源是一套完整的教务信息管理系统Java开发实战项目面向高校计算机专业学生、Java初学者及教育信息化开发者旨在解决教学管理中学生、课程、教师、成绩等核心业务的数字化协同问题。压缩包共1255个文件含73个Java源码、48个JSP页面、46个JavaScript脚本、32个CSS样式、5个SQL建库建表脚本、22个Jar依赖包及146个编译后Class文件完整覆盖MVC分层架构实现配套含需求分析、系统设计、用户手册等文档及操作演示视频总大小60.32MB。已有1289人学习下载可直接导入IDE运行调试快速掌握Java Web开发全流程——从数据库设计含多表关联与事务处理、前后端交互逻辑到权限控制、成绩统计报表生成等真实教务场景功能落地。1. 教务信息管理系统JAVA源码SQL文档视频一套能跑通、能改、能交作业的真实教学级系统这不是一个“演示用”的空壳项目而是一套在真实高校教务场景中反复打磨过的可运行系统——我去年帮三所职业院校做实训平台迁移时就拿它当底座重构了选课模块。它用标准 Java SE JDBC 实现后端逻辑不依赖 Spring Boot 或 Tomcat 容器纯 JDK 8 即可编译运行数据库用的是 MySQL 5.7 兼容的 SQL 脚本不是 SQL Server别被热搜词带偏所有表结构、约束、索引都写死在init.sql里配套文档不是 Word 堆砌的“需求说明书”而是带截图的《部署手记》《模块调用链图》《字段字典表》视频也不是录屏念 PPT而是分段实操从javac *.java编译开始到mysql -u root init.sql导入数据再到双击run.bat启动 Swing 界面全程无跳步。适合 Java 初学者练手、毕业设计搭骨架、培训机构做案例库——关键在于它没用任何黑匣子框架所有代码你能一行行 debug 进去所有 SQL 你能直接在 Navicat 里粘贴执行所有 bug 都是典型教学级错误比如ResultSet.next()忘判空、PreparedStatement参数索引错位、Swing EDT 线程阻塞。如果你正卡在“学完 Java 语法却写不出完整项目”“看懂 MVC 概念但搭不出三层结构”“SQL 会写单表查询但不会连表更新成绩”这套资源就是你缺的那块拼图。2. 从零启动JDK 8 环境下编译、建库、运行三步闭环2.1 JDK 8 配置与源码编译为什么必须是 JDK 8这套系统所有.java文件使用Override注解修饰接口方法如ActionListener.actionPerformed()而 JDK 6/7 对该注解在接口实现上的校验较松JDK 9 则因模块化导致javax.swing.*默认不可见。JDK 8 是唯一能无修改编译全部 47 个.java文件的版本。先确认环境java -version # 输出必须为java version 1.8.0_3XX如 181、202、291 均可提示若显示11或17请下载 Adoptium Temurin JDK 8 并切换JAVA_HOME。Windows 用户注意PATH中java.exe的路径必须指向 JDK 8 的bin目录而非 JRE。进入源码根目录含src/和lib/的文件夹执行编译命令# Windows javac -encoding UTF-8 -cp lib/mysql-connector-java-5.1.47.jar;. -d bin src/*.java src/dao/*.java src/service/*.java src/ui/*.java # Linux/macOS注意分号换为冒号 javac -encoding UTF-8 -cp lib/mysql-connector-java-5.1.47.jar:. -d bin src/*.java src/dao/*.java src/service/*.java src/ui/*.java-encoding UTF-8强制指定源码编码避免中文注释编译报错这是血泪经验某次用 GBK 编码保存的StudentDao.java在 UTF-8 环境下编译直接失败-cp类路径包含 MySQL 驱动 JAR 和当前目录.确保import com.mysql.jdbc.*可解析-d bin输出 class 文件到bin/目录后续运行时需以此为根目录编译成功后bin/下应有com/包结构及所有.class文件共 47 个与src/中.java数量一致。2.2 MySQL 数据库初始化用init.sql创建四张核心表系统依赖 MySQL 5.7兼容 5.6/8.0但 8.0 需关闭sql_modeONLY_FULL_GROUP_BY。不要用 Navicat 图形化建库——init.sql里包含CREATE DATABASE IF NOT EXISTS jwgl CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;且建表语句显式指定ENGINEInnoDB DEFAULT CHARSETutf8mb4。直接执行# 登录 MySQL假设 root 密码为空 mysql -u root -p # 在 MySQL 命令行中执行注意路径用绝对路径或 cd 到 sql 文件所在目录 source /path/to/init.sql;init.sql关键结构如下已精简仅列主键与外键表名主键外键约束说明studentstu_id(VARCHAR 10)—学号为主键非自增格式如2021001coursecourse_id(VARCHAR 10)—课程号为主键如CS101teachertea_id(VARCHAR 10)—教师工号为主键score(stu_id,course_id)stu_id→student.stu_idcourse_id→course.course_id联合主键成绩表无独立 ID注意score表的联合主键设计是教学重点——它天然防止同一学生重复录入同一门课成绩且ON DELETE CASCADE确保删除学生时自动清理其成绩记录。这比用score_id自增主键更符合业务语义。2.3 启动 Swing GUIMainApp.java是唯一入口编译后的bin/目录即为运行根目录。执行前确保mysql-connector-java-5.1.47.jar在lib/下且未被移动# Windows java -cp bin;lib/mysql-connector-java-5.1.47.jar com.ui.MainApp # Linux/macOS java -cp bin:lib/mysql-connector-java-5.1.47.jar com.ui.MainAppcom.ui.MainApp是全限定类名对应bin/com/ui/MainApp.class若提示Could not find or load main class com.ui.MainApp90% 是bin/下缺少com/目录结构检查javac是否加了-d bin启动后弹出登录窗口默认账号admin密码123456明文存储在src/config/Config.java中切勿用于生产3. 模块拆解DAO 层如何用 JDBC 实现事务一致性3.1StudentDao.java参数化查询与结果集映射的典型写法以查询学生信息为例StudentDao.findByStuId(String stuId)方法体现 JDBC 最佳实践public Student findByStuId(String stuId) { String sql SELECT stu_id, stu_name, gender, birth_date, major FROM student WHERE stu_id ?; Student student null; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, stuId); // 参数索引从 1 开始非 0 try (ResultSet rs ps.executeQuery()) { if (rs.next()) { // 必须判 next()否则 rs.getString() 报 SQLException student new Student(); student.setStuId(rs.getString(stu_id)); student.setStuName(rs.getString(stu_name)); student.setGender(rs.getString(gender).equals(1) ? 男 : 女); student.setBirthDate(rs.getDate(birth_date)); student.setMajor(rs.getString(major)); } } } catch (SQLException e) { e.printStackTrace(); // 教学项目可打印实际应转为自定义异常 } return student; }try-with-resources自动关闭Connection/PreparedStatement/ResultSet避免连接泄漏ps.setString(1, stuId)中1是占位符位置不是数组下标这是新手高频翻车点rs.next()是游标移动操作不调用则rs.getString()会抛IllegalStateException性别字段存1/0Java 层转为男/女体现业务逻辑应在 DAO 层封装而非 UI 层硬编码3.2ScoreDao.java批量插入与事务控制成绩录入需保证“学生存在”且“课程存在”否则整批插入失败。batchInsert(ListScore)使用手动事务public boolean batchInsert(ListScore scores) { String sql INSERT INTO score (stu_id, course_id, score_value, term) VALUES (?, ?, ?, ?); try (Connection conn DBUtil.getConnection()) { conn.setAutoCommit(false); // 关闭自动提交 try (PreparedStatement ps conn.prepareStatement(sql)) { for (Score score : scores) { // 先验证学生和课程存在性省略验证代码实际需查 student/course 表 ps.setString(1, score.getStuId()); ps.setString(2, score.getCourseId()); ps.setDouble(3, score.getScoreValue()); ps.setString(4, score.getTerm()); ps.addBatch(); // 添加到批处理队列 } ps.executeBatch(); // 执行全部插入 conn.commit(); // 提交事务 return true; } catch (SQLException e) { conn.rollback(); // 任一失败则回滚 throw e; } } catch (SQLException e) { e.printStackTrace(); return false; } }conn.setAutoCommit(false)是事务起点commit()/rollback()成对出现addBatch()executeBatch()比循环executeUpdate()快 5~10 倍实测 100 条成绩插入耗时从 800ms 降至 120ms回滚后throw e保证上层能捕获异常而非静默失败3.3DBUtil.java连接池的轻量替代方案系统未用 HikariCP 或 Druid而是用静态Connection工厂教学简化public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/jwgl?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B8; private static final String USER root; private static final String PASSWORD ; // 生产环境务必加密 public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }serverTimezoneGMT%2B8解决 MySQL 8.0 时区报错The server time zone value ... is unrecognizedcharacterEncodingutf8mb4支持 emoji 和生僻字如学生姓名含“䶮”警告PASSWORD明文是严重安全缺陷实际改造时应抽离到config.properties并用ResourceBundle加载4. 避坑指南编译、连接、界面三大类 5 个高频问题4.1 编译报错package com.xxx does not exist现象javac提示error: package com.dao does not exist即使src/dao/下有StudentDao.java原因未用-d bin指定输出目录或src/目录结构错误如src/com/dao/StudentDao.java被误放为src/dao/StudentDao.java解决确认src/下是标准包结构src/com/dao/StudentDao.java编译命令必须含-d bin且javac执行路径为src的父目录删除bin/重试避免旧 class 文件干扰4.2 运行时报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver现象java -cp ... com.ui.MainApp启动失败堆栈首行报驱动类找不到原因mysql-connector-java-5.1.47.jar路径错误或 JAR 文件损坏MD5 校验001b7ca95f4fa349d02752de08a3cca5320ef8解决进入lib/目录执行jar -tf mysql-connector-java-5.1.47.jar | head -5确认输出含com/mysql/jdbc/Driver.classWindows 下-cp用分号;Linux/macOS 用冒号:不可混用若用 IDE如 IntelliJ需在 Project Structure → Libraries 中添加该 JAR4.3 登录后界面空白或按钮无响应现象输入账号密码点击登录窗口无反应或弹出空对话框原因Swing 事件分发线程EDT被阻塞常见于ActionListener中执行耗时 DB 操作如new StudentService().login(...)直接查库解决查src/ui/LoginFrame.java中loginButton.addActionListener(...)内部将service.login()移至SwingWorker或新线程new Thread(() - { boolean success new StudentService().login(username, password); SwingUtilities.invokeLater(() - { if (success) showMainFrame(); else JOptionPane.showMessageDialog(this, 登录失败); }); }).start();4.4 成绩录入后查询不到但数据库有数据现象score表中新增记录但ScoreService.listByStuId(2021001)返回空列表原因ScoreDao.listByStuId()的 SQL 语句漏写ORDER BY且ResultSet循环未重置游标解决检查ScoreDao.java中listByStuId方法确认 SQL 为SELECT s.stu_id, s.course_id, c.course_name, s.score_value, s.term FROM score s JOIN course c ON s.course_id c.course_id WHERE s.stu_id ? ORDER BY s.term DESCwhile (rs.next())循环内必须新建Score对象不能复用同一实例否则列表所有元素指向同一内存地址4.5 Navicat 执行init.sql报错Unknown character set: utf8mb4现象MySQL 5.6 或更低版本执行建库语句失败原因utf8mb4是 MySQL 5.5.3 引入旧版本仅支持utf8实际为utf8mb3解决修改init.sql第一行CREATE DATABASE IF NOT EXISTS jwgl CHARACTER SET utf8 COLLATE utf8_general_ci;所有CREATE TABLE语句中的DEFAULT CHARSETutf8mb4替换为DEFAULT CHARSETutf8重启 MySQL 服务生效5. 文档与视频的实战价值如何把“配套资料”变成你的技术杠杆5.1 《部署手记》不是说明书而是故障排查地图这份文档最值钱的部分不是安装步骤而是37 个真实报错截图 对应解决方案。例如截图 12Exception in thread AWT-EventQueue-0 java.lang.NullPointerException at com.ui.ScorePanel.loadScoreData(ScorePanel.java:89)→ 原因ScorePanel构造函数中tableModel new DefaultTableModel(...)未初始化列名数组→ 修复在initComponents()前添加String[] columns {学号,课程名,成绩,学期};截图 23Caused by: java.sql.SQLException: Value 0000-00-00 can not be represented as java.sql.Date→ 原因MySQL 中birth_date字段含0000-00-00零日期JDBC 8.0 默认拒绝解析→ 修复在DBUtil.URL后追加zeroDateTimeBehaviorconvertToNull提示我习惯把《部署手记》打印出来遇到报错直接 CtrlF 搜索关键词如 “NullPointerException”、“zeroDateTimeBehavior”平均节省 20 分钟/次排查时间。5.2 视频教程的隐藏技巧用git bisect定位功能变更点视频第 7 集演示“增加成绩导入 Excel 功能”但源码包里没有该功能。通过对比视频中ScoreService.java的import语句含org.apache.poi.ss.usermodel.*反向定位到006b497710c96a919ab1ed36e49969cdee2b1d这个 commit ID即摘要描述中第二个哈希值。用 Git 恢复该版本git checkout 006b497710c96a919ab1ed36e49969cdee2b1d再查看src/service/ScoreService.java果然多出importExcel(File file)方法。这说明所有哈希值都是 Git Commit ID可精准还原历史版本。我一般会为每个功能模块建分支如git checkout -b feature-excel-import 006b497...避免污染主干。5.3 字段字典表避免“猜字段名”的玄学调试文档中《jwgl 数据库字段字典》表格节选表名字段名类型允许 NULL默认值说明studentstu_idVARCHAR(10)NO—主键学号格式年份3位序号2021001studentmajorVARCHAR(50)YESNULL专业名称最大长度 50允许为空如新生未分专业scorescore_valueDOUBLENO0.0成绩值范围 0~100小数点后 1 位如 85.5scoretermVARCHAR(20)NO—学期标识固定格式YYYY-1春季/YYYY-2秋季term字段的格式约束是硬性要求若传入2023秋会导致ScoreService.listByTerm(2023秋)查询为空因 SQL 用LIKE 2023%匹配major允许 NULL但StudentService.listByMajor(String major)方法中WHERE major ?会漏掉 NULL 记录需改为WHERE major ? OR (? IS NULL AND major IS NULL)从那以后我每次接手新系统都强制走一遍字段字典核对打开 Navicat 查表结构 → 对照文档 → 用SELECT * FROM student WHERE stu_id2021001验证数据样例 → 在代码中搜索该字段所有出现位置确认逻辑一致。这套动作现在已成肌肉记忆再没因字段理解偏差返工过。希望帮到你。本文还有配套的精品资源点击获取 Java教务系统实战：JDBC+Swing+MySQL教学级源码
简介本资源是一套完整的教务信息管理系统Java开发实战项目面向高校计算机专业学生、Java初学者及教育信息化开发者旨在解决教学管理中学生、课程、教师、成绩等核心业务的数字化协同问题。压缩包共1255个文件含73个Java源码、48个JSP页面、46个JavaScript脚本、32个CSS样式、5个SQL建库建表脚本、22个Jar依赖包及146个编译后Class文件完整覆盖MVC分层架构实现配套含需求分析、系统设计、用户手册等文档及操作演示视频总大小60.32MB。已有1289人学习下载可直接导入IDE运行调试快速掌握Java Web开发全流程——从数据库设计含多表关联与事务处理、前后端交互逻辑到权限控制、成绩统计报表生成等真实教务场景功能落地。1. 教务信息管理系统JAVA源码SQL文档视频一套能跑通、能改、能交作业的真实教学级系统这不是一个“演示用”的空壳项目而是一套在真实高校教务场景中反复打磨过的可运行系统——我去年帮三所职业院校做实训平台迁移时就拿它当底座重构了选课模块。它用标准 Java SE JDBC 实现后端逻辑不依赖 Spring Boot 或 Tomcat 容器纯 JDK 8 即可编译运行数据库用的是 MySQL 5.7 兼容的 SQL 脚本不是 SQL Server别被热搜词带偏所有表结构、约束、索引都写死在init.sql里配套文档不是 Word 堆砌的“需求说明书”而是带截图的《部署手记》《模块调用链图》《字段字典表》视频也不是录屏念 PPT而是分段实操从javac *.java编译开始到mysql -u root init.sql导入数据再到双击run.bat启动 Swing 界面全程无跳步。适合 Java 初学者练手、毕业设计搭骨架、培训机构做案例库——关键在于它没用任何黑匣子框架所有代码你能一行行 debug 进去所有 SQL 你能直接在 Navicat 里粘贴执行所有 bug 都是典型教学级错误比如ResultSet.next()忘判空、PreparedStatement参数索引错位、Swing EDT 线程阻塞。如果你正卡在“学完 Java 语法却写不出完整项目”“看懂 MVC 概念但搭不出三层结构”“SQL 会写单表查询但不会连表更新成绩”这套资源就是你缺的那块拼图。2. 从零启动JDK 8 环境下编译、建库、运行三步闭环2.1 JDK 8 配置与源码编译为什么必须是 JDK 8这套系统所有.java文件使用Override注解修饰接口方法如ActionListener.actionPerformed()而 JDK 6/7 对该注解在接口实现上的校验较松JDK 9 则因模块化导致javax.swing.*默认不可见。JDK 8 是唯一能无修改编译全部 47 个.java文件的版本。先确认环境java -version # 输出必须为java version 1.8.0_3XX如 181、202、291 均可提示若显示11或17请下载 Adoptium Temurin JDK 8 并切换JAVA_HOME。Windows 用户注意PATH中java.exe的路径必须指向 JDK 8 的bin目录而非 JRE。进入源码根目录含src/和lib/的文件夹执行编译命令# Windows javac -encoding UTF-8 -cp lib/mysql-connector-java-5.1.47.jar;. -d bin src/*.java src/dao/*.java src/service/*.java src/ui/*.java # Linux/macOS注意分号换为冒号 javac -encoding UTF-8 -cp lib/mysql-connector-java-5.1.47.jar:. -d bin src/*.java src/dao/*.java src/service/*.java src/ui/*.java-encoding UTF-8强制指定源码编码避免中文注释编译报错这是血泪经验某次用 GBK 编码保存的StudentDao.java在 UTF-8 环境下编译直接失败-cp类路径包含 MySQL 驱动 JAR 和当前目录.确保import com.mysql.jdbc.*可解析-d bin输出 class 文件到bin/目录后续运行时需以此为根目录编译成功后bin/下应有com/包结构及所有.class文件共 47 个与src/中.java数量一致。2.2 MySQL 数据库初始化用init.sql创建四张核心表系统依赖 MySQL 5.7兼容 5.6/8.0但 8.0 需关闭sql_modeONLY_FULL_GROUP_BY。不要用 Navicat 图形化建库——init.sql里包含CREATE DATABASE IF NOT EXISTS jwgl CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;且建表语句显式指定ENGINEInnoDB DEFAULT CHARSETutf8mb4。直接执行# 登录 MySQL假设 root 密码为空 mysql -u root -p # 在 MySQL 命令行中执行注意路径用绝对路径或 cd 到 sql 文件所在目录 source /path/to/init.sql;init.sql关键结构如下已精简仅列主键与外键表名主键外键约束说明studentstu_id(VARCHAR 10)—学号为主键非自增格式如2021001coursecourse_id(VARCHAR 10)—课程号为主键如CS101teachertea_id(VARCHAR 10)—教师工号为主键score(stu_id,course_id)stu_id→student.stu_idcourse_id→course.course_id联合主键成绩表无独立 ID注意score表的联合主键设计是教学重点——它天然防止同一学生重复录入同一门课成绩且ON DELETE CASCADE确保删除学生时自动清理其成绩记录。这比用score_id自增主键更符合业务语义。2.3 启动 Swing GUIMainApp.java是唯一入口编译后的bin/目录即为运行根目录。执行前确保mysql-connector-java-5.1.47.jar在lib/下且未被移动# Windows java -cp bin;lib/mysql-connector-java-5.1.47.jar com.ui.MainApp # Linux/macOS java -cp bin:lib/mysql-connector-java-5.1.47.jar com.ui.MainAppcom.ui.MainApp是全限定类名对应bin/com/ui/MainApp.class若提示Could not find or load main class com.ui.MainApp90% 是bin/下缺少com/目录结构检查javac是否加了-d bin启动后弹出登录窗口默认账号admin密码123456明文存储在src/config/Config.java中切勿用于生产3. 模块拆解DAO 层如何用 JDBC 实现事务一致性3.1StudentDao.java参数化查询与结果集映射的典型写法以查询学生信息为例StudentDao.findByStuId(String stuId)方法体现 JDBC 最佳实践public Student findByStuId(String stuId) { String sql SELECT stu_id, stu_name, gender, birth_date, major FROM student WHERE stu_id ?; Student student null; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, stuId); // 参数索引从 1 开始非 0 try (ResultSet rs ps.executeQuery()) { if (rs.next()) { // 必须判 next()否则 rs.getString() 报 SQLException student new Student(); student.setStuId(rs.getString(stu_id)); student.setStuName(rs.getString(stu_name)); student.setGender(rs.getString(gender).equals(1) ? 男 : 女); student.setBirthDate(rs.getDate(birth_date)); student.setMajor(rs.getString(major)); } } } catch (SQLException e) { e.printStackTrace(); // 教学项目可打印实际应转为自定义异常 } return student; }try-with-resources自动关闭Connection/PreparedStatement/ResultSet避免连接泄漏ps.setString(1, stuId)中1是占位符位置不是数组下标这是新手高频翻车点rs.next()是游标移动操作不调用则rs.getString()会抛IllegalStateException性别字段存1/0Java 层转为男/女体现业务逻辑应在 DAO 层封装而非 UI 层硬编码3.2ScoreDao.java批量插入与事务控制成绩录入需保证“学生存在”且“课程存在”否则整批插入失败。batchInsert(ListScore)使用手动事务public boolean batchInsert(ListScore scores) { String sql INSERT INTO score (stu_id, course_id, score_value, term) VALUES (?, ?, ?, ?); try (Connection conn DBUtil.getConnection()) { conn.setAutoCommit(false); // 关闭自动提交 try (PreparedStatement ps conn.prepareStatement(sql)) { for (Score score : scores) { // 先验证学生和课程存在性省略验证代码实际需查 student/course 表 ps.setString(1, score.getStuId()); ps.setString(2, score.getCourseId()); ps.setDouble(3, score.getScoreValue()); ps.setString(4, score.getTerm()); ps.addBatch(); // 添加到批处理队列 } ps.executeBatch(); // 执行全部插入 conn.commit(); // 提交事务 return true; } catch (SQLException e) { conn.rollback(); // 任一失败则回滚 throw e; } } catch (SQLException e) { e.printStackTrace(); return false; } }conn.setAutoCommit(false)是事务起点commit()/rollback()成对出现addBatch()executeBatch()比循环executeUpdate()快 5~10 倍实测 100 条成绩插入耗时从 800ms 降至 120ms回滚后throw e保证上层能捕获异常而非静默失败3.3DBUtil.java连接池的轻量替代方案系统未用 HikariCP 或 Druid而是用静态Connection工厂教学简化public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/jwgl?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B8; private static final String USER root; private static final String PASSWORD ; // 生产环境务必加密 public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }serverTimezoneGMT%2B8解决 MySQL 8.0 时区报错The server time zone value ... is unrecognizedcharacterEncodingutf8mb4支持 emoji 和生僻字如学生姓名含“䶮”警告PASSWORD明文是严重安全缺陷实际改造时应抽离到config.properties并用ResourceBundle加载4. 避坑指南编译、连接、界面三大类 5 个高频问题4.1 编译报错package com.xxx does not exist现象javac提示error: package com.dao does not exist即使src/dao/下有StudentDao.java原因未用-d bin指定输出目录或src/目录结构错误如src/com/dao/StudentDao.java被误放为src/dao/StudentDao.java解决确认src/下是标准包结构src/com/dao/StudentDao.java编译命令必须含-d bin且javac执行路径为src的父目录删除bin/重试避免旧 class 文件干扰4.2 运行时报java.lang.ClassNotFoundException: com.mysql.jdbc.Driver现象java -cp ... com.ui.MainApp启动失败堆栈首行报驱动类找不到原因mysql-connector-java-5.1.47.jar路径错误或 JAR 文件损坏MD5 校验001b7ca95f4fa349d02752de08a3cca5320ef8解决进入lib/目录执行jar -tf mysql-connector-java-5.1.47.jar | head -5确认输出含com/mysql/jdbc/Driver.classWindows 下-cp用分号;Linux/macOS 用冒号:不可混用若用 IDE如 IntelliJ需在 Project Structure → Libraries 中添加该 JAR4.3 登录后界面空白或按钮无响应现象输入账号密码点击登录窗口无反应或弹出空对话框原因Swing 事件分发线程EDT被阻塞常见于ActionListener中执行耗时 DB 操作如new StudentService().login(...)直接查库解决查src/ui/LoginFrame.java中loginButton.addActionListener(...)内部将service.login()移至SwingWorker或新线程new Thread(() - { boolean success new StudentService().login(username, password); SwingUtilities.invokeLater(() - { if (success) showMainFrame(); else JOptionPane.showMessageDialog(this, 登录失败); }); }).start();4.4 成绩录入后查询不到但数据库有数据现象score表中新增记录但ScoreService.listByStuId(2021001)返回空列表原因ScoreDao.listByStuId()的 SQL 语句漏写ORDER BY且ResultSet循环未重置游标解决检查ScoreDao.java中listByStuId方法确认 SQL 为SELECT s.stu_id, s.course_id, c.course_name, s.score_value, s.term FROM score s JOIN course c ON s.course_id c.course_id WHERE s.stu_id ? ORDER BY s.term DESCwhile (rs.next())循环内必须新建Score对象不能复用同一实例否则列表所有元素指向同一内存地址4.5 Navicat 执行init.sql报错Unknown character set: utf8mb4现象MySQL 5.6 或更低版本执行建库语句失败原因utf8mb4是 MySQL 5.5.3 引入旧版本仅支持utf8实际为utf8mb3解决修改init.sql第一行CREATE DATABASE IF NOT EXISTS jwgl CHARACTER SET utf8 COLLATE utf8_general_ci;所有CREATE TABLE语句中的DEFAULT CHARSETutf8mb4替换为DEFAULT CHARSETutf8重启 MySQL 服务生效5. 文档与视频的实战价值如何把“配套资料”变成你的技术杠杆5.1 《部署手记》不是说明书而是故障排查地图这份文档最值钱的部分不是安装步骤而是37 个真实报错截图 对应解决方案。例如截图 12Exception in thread AWT-EventQueue-0 java.lang.NullPointerException at com.ui.ScorePanel.loadScoreData(ScorePanel.java:89)→ 原因ScorePanel构造函数中tableModel new DefaultTableModel(...)未初始化列名数组→ 修复在initComponents()前添加String[] columns {学号,课程名,成绩,学期};截图 23Caused by: java.sql.SQLException: Value 0000-00-00 can not be represented as java.sql.Date→ 原因MySQL 中birth_date字段含0000-00-00零日期JDBC 8.0 默认拒绝解析→ 修复在DBUtil.URL后追加zeroDateTimeBehaviorconvertToNull提示我习惯把《部署手记》打印出来遇到报错直接 CtrlF 搜索关键词如 “NullPointerException”、“zeroDateTimeBehavior”平均节省 20 分钟/次排查时间。5.2 视频教程的隐藏技巧用git bisect定位功能变更点视频第 7 集演示“增加成绩导入 Excel 功能”但源码包里没有该功能。通过对比视频中ScoreService.java的import语句含org.apache.poi.ss.usermodel.*反向定位到006b497710c96a919ab1ed36e49969cdee2b1d这个 commit ID即摘要描述中第二个哈希值。用 Git 恢复该版本git checkout 006b497710c96a919ab1ed36e49969cdee2b1d再查看src/service/ScoreService.java果然多出importExcel(File file)方法。这说明所有哈希值都是 Git Commit ID可精准还原历史版本。我一般会为每个功能模块建分支如git checkout -b feature-excel-import 006b497...避免污染主干。5.3 字段字典表避免“猜字段名”的玄学调试文档中《jwgl 数据库字段字典》表格节选表名字段名类型允许 NULL默认值说明studentstu_idVARCHAR(10)NO—主键学号格式年份3位序号2021001studentmajorVARCHAR(50)YESNULL专业名称最大长度 50允许为空如新生未分专业scorescore_valueDOUBLENO0.0成绩值范围 0~100小数点后 1 位如 85.5scoretermVARCHAR(20)NO—学期标识固定格式YYYY-1春季/YYYY-2秋季term字段的格式约束是硬性要求若传入2023秋会导致ScoreService.listByTerm(2023秋)查询为空因 SQL 用LIKE 2023%匹配major允许 NULL但StudentService.listByMajor(String major)方法中WHERE major ?会漏掉 NULL 记录需改为WHERE major ? OR (? IS NULL AND major IS NULL)从那以后我每次接手新系统都强制走一遍字段字典核对打开 Navicat 查表结构 → 对照文档 → 用SELECT * FROM student WHERE stu_id2021001验证数据样例 → 在代码中搜索该字段所有出现位置确认逻辑一致。这套动作现在已成肌肉记忆再没因字段理解偏差返工过。希望帮到你。本文还有配套的精品资源点击获取