簡(jiǎn)介這是一套基于Java Swing與MySQL開(kāi)發(fā)的學(xué)校教務(wù)管理系統(tǒng)完整源碼定位為高校Java課程設(shè)計(jì)、期末大作業(yè)及畢業(yè)設(shè)計(jì)備題資源難度適中且已通過(guò)助教老師審定。項(xiàng)目涵蓋學(xué)生信息管理、教師信息管理、課程安排、成績(jī)錄入與查詢、登錄鑒權(quán)等常見(jiàn)教務(wù)業(yè)務(wù)模塊界面采用Swing桌面組件構(gòu)建數(shù)據(jù)層通過(guò)JDBC連接MySQL附帶SQL初始化腳本與Maven工程配置有助于理解業(yè)務(wù)邏輯、界面事件處理、數(shù)據(jù)庫(kù)表設(shè)計(jì)及客戶端與數(shù)據(jù)庫(kù)交互流程。壓縮包共包含39個(gè)文件以25個(gè)Java源文件為主另有6張界面運(yùn)行截圖、5個(gè)XML配置文件、1個(gè)SQL腳本、1個(gè)README說(shuō)明文檔及.gitignore等整體大小僅240KB結(jié)構(gòu)清晰緊湊便于導(dǎo)入IDE直接運(yùn)行和學(xué)習(xí)。源碼已經(jīng)本地編譯驗(yàn)證可穩(wěn)定運(yùn)行評(píng)審分達(dá)到98分代碼結(jié)構(gòu)與命名規(guī)范具有一定示范性。目前已有220人學(xué)習(xí)下載適合需要快速完成期末大作業(yè)或課程設(shè)計(jì)的Java初學(xué)者參考借鑒。1. JavaSwingMySQL教務(wù)管理系統(tǒng)課程設(shè)計(jì)里最實(shí)在的一塊拼圖JavaSwingMySQL教務(wù)管理系統(tǒng)是 Java 期末大作業(yè)里被點(diǎn)名最多的一道題也是課程設(shè)計(jì)里的默認(rèn)組合Swing 畫界面JDBC 連 MySQLMaven 管依賴和構(gòu)建。這份資源我完整跑過(guò)一遍pom.xml、educational_admin.sql、src 和 test 都在導(dǎo)入 IDEA 改好連接就能啟動(dòng)。場(chǎng)景很直觀登錄區(qū)分管理員、教師、學(xué)生三類角色之后分別維護(hù)學(xué)生信息、課程、選課和成績(jī)。功能不算驚艷但面向?qū)ο?、JDBC 操作、Swing 事件模型全覆蓋交作業(yè)足夠了。適合三類人現(xiàn)在要交作業(yè)的、想照著 SwingMySQL 完整例子復(fù)現(xiàn)的、以及拿到源碼不知道怎么講設(shè)計(jì)結(jié)構(gòu)的。但 target 里已有 classes 不代表你能直接跑不同 JDK/MySQL 版本會(huì)把“可運(yùn)行”變成“環(huán)境不對(duì)”我建議先看完下面的目錄和腳本再動(dòng)手。2. 先讀懂項(xiàng)目骨架pom.xml、educational_admin.sql 與 Swing 分層結(jié)構(gòu)拿到壓縮包先別急著點(diǎn)運(yùn)行。我的習(xí)慣是先看目錄再讀 SQL 腳本最后才打開(kāi) IDEA。這個(gè)順序能幫你三分鐘判斷資源完整度也能避開(kāi)很多后面才爆出來(lái)的環(huán)境問(wèn)題。2.1 目錄結(jié)構(gòu)Maven 布局里哪些是重點(diǎn)先從 zip 里解出來(lái)的根目錄開(kāi)始看正常的 Maven 工程長(zhǎng)這樣educational_admin/ ├── pom.xml ├── educational_admin.sql ├── README.md ├── .gitignore ├── src/ │ ├── main/ │ │ ├── java/ │ │ └── resources/ │ └── test/ │ └── java/ ├── target/ │ └── classes/先說(shuō)結(jié)論pom.xml 是整個(gè)項(xiàng)目的依賴和打包配置核心educational_admin.sql 是數(shù)據(jù)庫(kù)初始化腳本src/main/java 里是業(yè)務(wù)代碼src/test 用來(lái)放單元測(cè)試target/classes 是上一次編譯的產(chǎn)物。資源里出現(xiàn) target 和 classes說(shuō)明作者是在本機(jī)成功編譯過(guò)才打包的這一點(diǎn)比很多只丟源碼的壓縮包靠譜。再看 .gitignore。它在這里的作用不是運(yùn)行而是告訴你作者是用 Git 管理版本的里面通常忽略了 target、.idea、*.iml 這些本地文件。你在這個(gè)基礎(chǔ)上繼續(xù)用 Git 維護(hù)課程設(shè)計(jì)就不用自己重新補(bǔ) ignore 規(guī)則。至于壓縮包根目錄常見(jiàn)的 -master 后綴只是從 Git 平臺(tái)打 zip 時(shí)留下的分支名不影響項(xiàng)目?jī)?nèi)容。打開(kāi) pom.xml 后我一般先看 dependencies 里有沒(méi)有 mysql-connector-java。純 Swing JDBC 的課程設(shè)計(jì)通常只依賴這一個(gè)第三方庫(kù)如果里面還出現(xiàn)了 JFreeChart、POI 之類的說(shuō)明還有導(dǎo)出圖表或 Excel 的功能。你先記下依賴列表后面避坑章節(jié)會(huì)用到。dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId !-- 版本號(hào)以你本地 Maven 實(shí)際拉到的最新版為準(zhǔn) -- /dependency注意這個(gè)依賴的版本直接決定了驅(qū)動(dòng)類名5.x 是 com.mysql.jdbc.Driver8.x 是 com.mysql.cj.jdbc.Driver。這看起來(lái)是小問(wèn)題但它是課程設(shè)計(jì)項(xiàng)目里最常見(jiàn)的啟動(dòng)報(bào)錯(cuò)來(lái)源之一后面會(huì)展開(kāi)。pom.xml 里如果看不到版本號(hào)可以把鼠標(biāo)放在 IDEA 的 dependency 上按住 Ctrl 查看實(shí)際解析到的版本或者用 mvn dependency:tree 輸出。2.2 educational_admin.sql表結(jié)構(gòu)里藏著業(yè)務(wù)邊界建庫(kù)腳本是整個(gè)項(xiàng)目的“定盤星”。界面上的每個(gè)按鈕本質(zhì)上都在對(duì)這個(gè)腳本里的表做增刪改查所以一定要先讀一遍。教務(wù)管理系統(tǒng)常規(guī)的表就那幾類賬號(hào)表、學(xué)生表、教師表、課程表、選課記錄表、成績(jī)表。資源的命名可能叫 user 也可能叫 t_user前綴不重要字段邏輯基本逃不出下面這些DROP TABLE IF EXISTS t_user; CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL COMMENT 登錄名, password VARCHAR(50) NOT NULL COMMENT 密碼, role VARCHAR(10) NOT NULL COMMENT admin/teacher/student ); DROP TABLE IF EXISTS t_student; CREATE TABLE t_student ( id INT PRIMARY KEY AUTO_INCREMENT, student_no VARCHAR(20) NOT NULL, name VARCHAR(50) NOT NULL, major VARCHAR(50), class_name VARCHAR(50) ); DROP TABLE IF EXISTS t_course; CREATE TABLE t_course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL, teacher_id INT, max_count INT DEFAULT 50, selected_count INT DEFAULT 0 ); DROP TABLE IF EXISTS t_selection; CREATE TABLE t_selection ( id INT PRIMARY KEY AUTO_INCREMENT, student_id INT, course_id INT, score DECIMAL(5,2) DEFAULT NULL );執(zhí)行這些腳本后你會(huì)發(fā)現(xiàn)整個(gè)系統(tǒng)的業(yè)務(wù)邊界也清楚了學(xué)生通過(guò) t_selection 和 t_course 關(guān)聯(lián)成績(jī)掛在選課記錄上教師通過(guò) teacher_id 關(guān)聯(lián)課程。這就是“學(xué)生選課、教師錄成績(jī)、管理員維護(hù)基礎(chǔ)數(shù)據(jù)”閉環(huán)的物理基礎(chǔ)。腳本里通常還有初始數(shù)據(jù)最常見(jiàn)的是給每個(gè)角色預(yù)設(shè)一個(gè)賬號(hào)。沒(méi)有初始賬號(hào)的話登錄頁(yè)就是空轉(zhuǎn)你導(dǎo)入后必須先手工插一條管理員否則永遠(yuǎn)登不進(jìn)去。我的做法是先執(zhí)行下面的查詢確認(rèn)腳本里到底有沒(méi)有賬號(hào)SELECT * FROM t_user;如果結(jié)果是空表自己補(bǔ)一條最低限度的管理員即可密碼字段先在后臺(tái)用已知的明文跑通后再考慮加密。這里先不展開(kāi)加密最后一章會(huì)講。2.3 Swing 分層View、Service、DAO 誰(shuí)管什么很多課程設(shè)計(jì)項(xiàng)目的真實(shí)形態(tài)是“類都寫在一個(gè) JFrame 里”按鈕一多一個(gè)類能有兩千行。能跑但很難講也難改。合理的結(jié)構(gòu)是三層Swing 窗體只負(fù)責(zé)接收鼠標(biāo)鍵盤事件和展示數(shù)據(jù)Service 層處理登錄校驗(yàn)、選課資格這類業(yè)務(wù)規(guī)則DAO 層只寫 JDBC不摻界面邏輯。我先給一個(gè) DAO 層的典型寫法你看完后可以對(duì)照資源里的包名去定位public class UserDao { public User findByUsernameAndPassword(String username, String password) { String sql SELECT id, username, role FROM t_user WHERE username? AND password?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { User user new User(); user.setId(rs.getInt(id)); user.setUsername(rs.getString(username)); user.setRole(rs.getString(role)); return user; } } } catch (SQLException e) { e.printStackTrace(); } return null; } }這里我特意用了 PreparedStatement 而不是 Statement因?yàn)橛米址唇訉懗鰜?lái)的 SQL 在答辯時(shí)被問(wèn)到“如何防 SQL 注入”會(huì)很被動(dòng)。參數(shù)用問(wèn)號(hào)占位再通過(guò) setString 傳值既安全又不用處理引號(hào)轉(zhuǎn)義。連接從 DBUtil 統(tǒng)一獲取正常情況下它會(huì)讀一個(gè) db.properties 文件。最低成本的寫法是直接放在一個(gè)常量類里但為了不改代碼就能換數(shù)據(jù)庫(kù)我更推薦用 properties 文件jdbc.urljdbc:mysql://localhost:3306/educational_admin?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password你的密碼注意 URL 里的 serverTimezone 參數(shù)MySQL 8.x 驅(qū)動(dòng)不寫這個(gè)十有八九會(huì)報(bào)時(shí)區(qū)異常。后面的避坑章節(jié)會(huì)專門再說(shuō)。三層拆分之后JFrame 里就不需要知道 SQL 怎么寫了它只調(diào) ServiceService 再調(diào) DAO邊界清清楚楚。答辯時(shí)老師問(wèn)“你這個(gè)功能怎么實(shí)現(xiàn)的”你就能按這條鏈路講下來(lái)而不是翻幾百行代碼找按鈕。3. 核心代碼拆解登錄校驗(yàn)、學(xué)生管理、選課事務(wù)的 JDBC 寫法這一章專門拆三個(gè)最常出問(wèn)題的功能點(diǎn)登錄、表格刷新、事務(wù)。這三個(gè)點(diǎn)懂了剩下都是重復(fù)動(dòng)作。3.1 登錄事件轉(zhuǎn)發(fā)與角色跳轉(zhuǎn)Swing 登錄界面本質(zhì)上是把 JTextField 和 JPasswordField 里拿到的值交給 Service 層去數(shù)據(jù)庫(kù)比對(duì)然后根據(jù)角色打開(kāi)不同的主窗口。按鈕事件里的代碼如下JButton loginBtn new JButton(登錄); loginBtn.addActionListener(e - { String username usernameField.getText().trim(); String password new String(passwordField.getPassword()); if (username.isEmpty() || password.isEmpty()) { JOptionPane.showMessageDialog(frame, 用戶名和密碼不能為空); return; } User user new UserService().login(username, password); if (user ! null) { frame.dispose(); if (admin.equals(user.getRole())) { new AdminMainFrame().setVisible(true); } else if (teacher.equals(user.getRole())) { new TeacherMainFrame().setVisible(true); } else { new StudentMainFrame(user).setVisible(true); } } else { JOptionPane.showMessageDialog(frame, 用戶名或密碼錯(cuò)誤); } });這里有兩個(gè)容易被忽視的點(diǎn)。第一密碼框要用 getPassword() 而不是 getText()因?yàn)樗祷?char[] 而不是 String這是 Java 在密碼處理上默認(rèn)的安全習(xí)慣。第二登錄成功后要用 frame.dispose() 把登錄窗口銷毀而不是 setVisible(false)否則進(jìn)程里掛著隱藏窗口內(nèi)存上沒(méi)必要。UserService.login 內(nèi)部就是查 t_user 表比對(duì)成功后返回一個(gè)帶 role 的 User 對(duì)象。如果資源里沒(méi)有 Service 層直接在事件里寫 JDBC也能跑但建議你自己拆一層出來(lái)因?yàn)檫@正好是答辯可以講的設(shè)計(jì)點(diǎn)界面層不知道 SQL數(shù)據(jù)層不知道按鈕。3.2 學(xué)生管理JTable 刷新模型別追加舊數(shù)據(jù)教務(wù)系統(tǒng)里學(xué)生列表幾乎都用 JTable DefaultTableModel。經(jīng)典翻車現(xiàn)場(chǎng)是每次點(diǎn)“查詢”都在往表格里 addRow但是舊數(shù)據(jù)還留在 model 里結(jié)果越點(diǎn)越多。正確的刷新邏輯是先清空再填充private void loadStudentData() { String sql SELECT id, student_no, name, major FROM t_student ORDER BY id; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { DefaultTableModel model (DefaultTableModel) studentTable.getModel(); model.setRowCount(0); while (rs.next()) { model.addRow(new Object[]{ rs.getInt(id), rs.getString(student_no), rs.getString(name), rs.getString(major) }); } } catch (SQLException ex) { JOptionPane.showMessageDialog(this, 查詢失敗 ex.getMessage(), 錯(cuò)誤, JOptionPane.ERROR_MESSAGE); } }setRowCount(0) 是清空舊數(shù)據(jù)的關(guān)鍵缺了它第二次查詢開(kāi)始表格就會(huì)出現(xiàn)重復(fù)。如果你在初始化表格時(shí)用的是這種寫法studentTable.setModel(new DefaultTableModel( new Object[]{ID, 學(xué)號(hào), 姓名, 專業(yè)}, 0 ));那么 loadStudentData 里就可以直接強(qiáng)轉(zhuǎn) DefaultTableModel不需要每次重設(shè)表頭。如果資源里表格沒(méi)有正確初始化強(qiáng)制轉(zhuǎn)換會(huì)拋 ClassCastException那就先改初始化那行再調(diào)刷新。刪除操作的處理邏輯是從表格選中行拿到主鍵執(zhí)行 delete再重新調(diào)用 loadStudentData 刷新界面。int selectedRow studentTable.getSelectedRow(); if (selectedRow 0) { int id (int) studentTable.getValueAt(selectedRow, 0); new StudentDao().deleteById(id); loadStudentData(); }這里注意 getValueAt 返回的是 Object先轉(zhuǎn)成 Integer 再變成 int。很多同學(xué)忘了強(qiáng)轉(zhuǎn)編譯直接報(bào)錯(cuò)或者因?yàn)楸砀窳许樞虿粚?duì)把第二列的學(xué)號(hào)當(dāng)成主鍵刪了刪出來(lái)的數(shù)據(jù)和 UI 顯示完全對(duì)不上。所以建議在表格里把主鍵列放在第一列并在初始化時(shí)隱藏它或者單獨(dú)維護(hù)一個(gè) List 來(lái)映射行號(hào)到主鍵。3.3 選課與成績(jī)錄入JDBC 事務(wù)保證數(shù)據(jù)一致性選課這個(gè)動(dòng)作會(huì)同時(shí)影響兩張表在 t_selection 里插入一條選課記錄同時(shí)把 t_course 里的 selected_count 加一。如果第一個(gè)操作成功、第二個(gè)失敗選課記錄就成了孤兒數(shù)據(jù)。避免這個(gè)問(wèn)題必須把兩個(gè)操作放進(jìn)同一個(gè)事務(wù)里public boolean chooseCourse(int studentId, int courseId) { Connection conn null; try { conn DBUtil.getConnection(); conn.setAutoCommit(false); String insertSql INSERT INTO t_selection(student_id, course_id, score) VALUES(?,?,NULL); try (PreparedStatement ps conn.prepareStatement(insertSql)) { ps.setInt(1, studentId); ps.setInt(2, courseId); ps.executeUpdate(); } String updateSql UPDATE t_course SET selected_count selected_count 1 WHERE id?; try (PreparedStatement ps conn.prepareStatement(updateSql)) { ps.setInt(1, courseId); ps.executeUpdate(); } conn.commit(); return true; } catch (SQLException e) { if (conn ! null) { try { conn.rollback(); } catch (SQLException ex) { ex.printStackTrace(); } } return false; } finally { if (conn ! null) { try { conn.setAutoCommit(true); } catch (SQLException e) { e.printStackTrace(); } DBUtil.close(conn); } } }這段代碼有幾個(gè)細(xì)節(jié)。第一setAutoCommit(false) 必須在所有操作之前調(diào)用否則每條 SQL 都自動(dòng)提交事務(wù)就形同虛設(shè)。第二finally 里把 autoCommit 恢復(fù)成 true 是個(gè)好習(xí)慣因?yàn)檫B接要還回池里如果保持 false同一個(gè)連接下一次被使用時(shí)前一個(gè)事務(wù)未提交的操作狀態(tài)會(huì)帶過(guò)來(lái)。第三兩個(gè) PreparedStatement 分別在 try-with-resources 里自己關(guān)閉但 Connection 是在最外層手動(dòng)關(guān)閉因?yàn)槭聞?wù)期間不能用 try-with-resources 提前把連接關(guān)掉。教師錄成績(jī)?cè)谠砩细?jiǎn)單本質(zhì)就是一條 update 語(yǔ)句UPDATE t_selection SET score 8.5 WHERE student_id ? AND course_id ?但如果學(xué)生選了多門課而界面只給了學(xué)號(hào)和分?jǐn)?shù)沒(méi)給課程號(hào)那 update 就會(huì)把所有課程成績(jī)一起改掉。這一點(diǎn)很多課程設(shè)計(jì)項(xiàng)目都會(huì)踩建議在成績(jī)錄入界面把課程作為必選項(xiàng)或者用 JTable 展示選課記錄時(shí)直接點(diǎn)擊某一行進(jìn)行編輯減少這種歧義。4. 本地編譯運(yùn)行全流程MySQL 建庫(kù)、Maven 打包與啟動(dòng)參數(shù)前兩章是拆架構(gòu)這一章回到地面怎么把資源里的代碼變成你電腦上能看到登錄窗的實(shí)際運(yùn)行程序。按順序做十分鐘能跑起來(lái)。4.1 MySQL 初始化命令行導(dǎo)入腳本與賬號(hào)確認(rèn)如果你的 MySQL 裝的是 5.7 或 8.0最穩(wěn)的導(dǎo)入方式是在命令行里執(zhí)行mysql -u root -p educational_admin.sql回車后會(huì)提示輸入密碼輸入 root 的密碼腳本里的建庫(kù)建表和初始數(shù)據(jù)就全部執(zhí)行了。這里注意腳本里如果有 DROP TABLE 語(yǔ)句它會(huì)把同名表先刪掉再重建所以不要在已經(jīng)存有自己數(shù)據(jù)的庫(kù)上執(zhí)行先看一眼腳本頭部有沒(méi)有 DROP 字樣。導(dǎo)入完成后用下面這條命令驗(yàn)證一下表是否建出來(lái)了mysql -u root -p -e USE educational_admin; SHOW TABLES;這一步非常有必要因?yàn)楹芏嗾n程設(shè)計(jì)項(xiàng)目里 SQL 腳本的字符集、表名可能和 Java 代碼里寫的不一致。如果 Java 代碼里查的是 t_student而 SQL 腳本里建的表叫 student那你代碼怎么改都會(huì)報(bào)“表不存在”。先確認(rèn)表名再對(duì)照代碼里的 SQL避免在這個(gè)問(wèn)題上浪費(fèi)時(shí)間。圖形化工具比如 Navicat、MySQL Workbench 也可以導(dǎo)入但要注意導(dǎo)入時(shí)保持 UTF-8 編碼。命令行默認(rèn)讀取腳本文件的編碼Windows 下如果你的腳本是 GBK 保存的就會(huì)出現(xiàn)亂碼。資源里的腳本我建議用記事本或 VSCode 打開(kāi)把右下角的編碼確認(rèn)成 UTF-8 后再執(zhí)行。4.2 Maven 編譯打包在 IDEA 里還是命令行里跑資源是標(biāo)準(zhǔn) Maven 工程所以最高效的方式是直接用 IDEA 打開(kāi)根目錄。IDEA 會(huì)自動(dòng)識(shí)別 pom.xml開(kāi)始下載依賴右下角進(jìn)度條走完基本就準(zhǔn)備好了。如果你想用命令行驗(yàn)證這幾個(gè)命令是最常用的mvn clean compile mvn packageclean 會(huì)清掉 target 目錄里的舊 class避免新舊代碼混雜compile 把 src/main/java 編譯成 classpackage 進(jìn)一步打 jar。對(duì)于結(jié)構(gòu)不復(fù)雜的 Swing 課程設(shè)計(jì)執(zhí)行到 package 就已經(jīng)能看到 target 目錄下生成帶依賴或純項(xiàng)目的 jar 了。但這里有一個(gè)非常大的坑普通的 Maven project 打出來(lái)的 jar 不包含第三方依賴。也就是說(shuō)你直接 java -jar xxx.jar 會(huì)報(bào) NoClassDefFoundError提示找不到 mysql 驅(qū)動(dòng)類。因?yàn)槟銢](méi)有把 mysql-connector-java 這個(gè) jar 打包進(jìn)去。解決方式是加 maven-shade-plugin把依賴合并進(jìn)最終 jarplugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-shade-plugin/artifactId !-- 版本號(hào)按你本地 Maven 倉(cāng)庫(kù)能拿到的版本填 -- executions execution phasepackage/phase goalsgoalshade/goal/goals /execution /executions configuration transformers transformer implementationorg.apache.maven.plugins.shade.resource.ManifestResourceTransformer mainClasscom.yourpackage.Main/mainClass /transformer /transformers /configuration /pluginmainClass 里的類名要換成資源里真正帶 main 方法的啟動(dòng)類一般是 MainFrame 或者 Main。如果你不確定就打開(kāi) src/main/java 往下翻找?guī)?public static void main 的類。配置正確后執(zhí)行 mvn clean packagetarget 下會(huì)同時(shí)出現(xiàn)原始 jar 和帶依賴的 jar帶依賴的那個(gè)命名一般是 xxx.jar直接雙擊或者 java -jar 都能跑。如果只是自己交作業(yè)我一般只在 IDEA 里點(diǎn)綠色運(yùn)行按鈕不去打包。但如果你要演示給老師看或者想在一臺(tái)沒(méi)裝 IDEA 的機(jī)器上演示shade 插件這一步是繞不過(guò)去的。4.3 啟動(dòng)前的三個(gè)檢查時(shí)區(qū)、SSL、字符集即使導(dǎo)入成功第一次運(yùn)行仍可能被 JDBC 連接串卡住。這一節(jié)把最常見(jiàn)的三個(gè)連接參數(shù)一次說(shuō)清。先看一個(gè)配置文件的完整寫法jdbc.urljdbc:mysql://localhost:3306/educational_admin?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 jdbc.usernameroot jdbc.password你的密碼useSSLfalse 是在本地開(kāi)發(fā)時(shí)推薦的避免 MySQL 8.x 默認(rèn)啟用 SSL 后出現(xiàn) SSLHandshakeException。serverTimezoneAsia/Shanghai 是為了解決報(bào)錯(cuò) “The server time zone value й?? is unrecognized” 這個(gè)問(wèn)題本質(zhì)是驅(qū)動(dòng)和服務(wù)器時(shí)區(qū)不一致。characterEncodingutf8 保證傳入數(shù)據(jù)庫(kù)的中文不亂碼但要注意它只對(duì)當(dāng)前連接有效數(shù)據(jù)庫(kù)和表本身的字符集也要是 utf8mb4否則結(jié)果集里還是亂碼。還有一個(gè)參數(shù) allowPublicKeyRetrievaltrue 值得提它經(jīng)常和 MySQL 8.0 的 caching_sha2_password 插件一起出現(xiàn)。如果連接報(bào)錯(cuò)提示 Public Key Retrieval is not allowed就在 URL 后面追加這個(gè)參數(shù)。這三個(gè)參數(shù)都不算稀奇但放一起能解決 80% 的“MySQL 連接不上”問(wèn)題。啟動(dòng)前最后檢查一件事如果你在 Windows 命令行跑MySQL 服務(wù)默認(rèn)不會(huì)自動(dòng)啟動(dòng)。用管理員身份打開(kāi)命令提示符輸入 net start mysql或者在服務(wù)管理器里啟動(dòng) MySQL。這個(gè)說(shuō)起來(lái)有點(diǎn)基礎(chǔ)但課程設(shè)計(jì)驗(yàn)收現(xiàn)場(chǎng)十個(gè)卡死跳過(guò)的項(xiàng)目里有四五個(gè)是服務(wù)沒(méi)開(kāi)。5. 避坑指南SwingMySQL 項(xiàng)目最常見(jiàn)的五個(gè)坑與排查路徑這一章是血淚總結(jié)。每一個(gè)坑都是我親眼見(jiàn)人踩過(guò)其中一半自己也踩過(guò)按“現(xiàn)象 → 原因 → 解決”寫你可以直接對(duì)照著排查。5.1 驅(qū)動(dòng)類找不到ClassNotFoundException 但 pom 里明明有依賴現(xiàn)象啟動(dòng)后控制臺(tái)第一行報(bào) java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver然后程序退出。原因要么依賴沒(méi)有真正導(dǎo)入要么你用的是 MySQL Connector/J 5.x驅(qū)動(dòng)類名是 com.mysql.jdbc.Driver而 8.x 驅(qū)動(dòng)才叫 com.mysql.cj.jdbc.Driver。代碼里 Class.forName 寫反了加載就會(huì)失敗。解決先看 pom.xml 里 mysql-connector-java 的版本。如果是 8.x把 Class.forName 的值改成 com.mysql.cj.jdbc.Driver如果是 5.1.x改回 com.mysql.jdbc.Driver。同時(shí)確認(rèn) IDEA 的 Maven 面板沒(méi)有紅色依賴如果依賴報(bào)錯(cuò)就執(zhí)行右側(cè)的 Reload All Maven Projects。最內(nèi)部的排查命令是mvn dependency:tree只要能列出 mysql-connector-java 節(jié)點(diǎn)就說(shuō)明依賴解析到了。如果依賴在 pom 里不在那問(wèn)題出在 IDEA 的本地倉(cāng)庫(kù)索引刪除項(xiàng)目里的 .idea 文件夾重新導(dǎo)入一次就好。5.2 中文亂碼界面、數(shù)據(jù)庫(kù)、連接三個(gè)地方要一致現(xiàn)象學(xué)生名單里的中文在界面上顯示成問(wèn)號(hào)或者數(shù)據(jù)庫(kù)里表數(shù)據(jù)正常但 JTable 里全是 。原因字符集鏈路有三層界面 Java 文件編碼、JDBC 連接參數(shù)、MySQL 庫(kù)表和客戶端編碼只要有一層是 GBK 而其他層是 UTF-8中文就會(huì)爛。最常見(jiàn)的是連接 URL 里沒(méi)寫 characterEncodingutf8或者建庫(kù)腳本里用了 DEFAULT CHARSETlatin1。解決建庫(kù)統(tǒng)一用 utf8mb4URL 里追加 characterEncodingutf8IDEA 里再檢查一下 File Encoding 設(shè)置保證項(xiàng)目編譯器輸出都是 UTF-8。如果是 Windows 控制臺(tái)運(yùn)行看到中文亂碼在運(yùn)行時(shí)加 JVM 參數(shù) -Dfile.encodingUTF-8。這三處一致了亂碼基本消失。如果還存在問(wèn)題去查 MySQL 變量的 global character_set_server 是不是 utf8mb4。5.3 界面卡死Swing 的 EDT 線程里跑了 JDBC現(xiàn)象點(diǎn)“查詢”按鈕之后整個(gè)窗口拖不動(dòng)鼠標(biāo)一直轉(zhuǎn)圈十幾秒后才有響應(yīng)或者干脆假死。原因Swing 是單線程模型所有界面刷新必須在事件分發(fā)線程 EDT 上執(zhí)行。如果你在按鈕事件里直接發(fā)起數(shù)據(jù)庫(kù)查詢JDBC 等待響應(yīng)時(shí) EDT 被堵死界面自然不動(dòng)。解決用 SwingWorker 包一層把耗時(shí)查詢放到后臺(tái)線程完成后回到 EDT 更新界面。一個(gè)典型的修復(fù)模板是這樣new SwingWorkerVoid, Void() { Override protected Void doInBackground() { dao.queryAll(); // 放耗時(shí)查詢 return null; } Override protected void done() { loadStudentData(); // 回到界面線程刷新 } }.execute();注意 doInBackground 里不能碰任何 Swing 組件否則仍然有線程安全問(wèn)題。把查詢結(jié)果先存在類成員變量里done 方法里再讀取并填充 JTable。課程設(shè)計(jì)項(xiàng)目數(shù)據(jù)量小很多人不寫這一步也能跑但一旦老師錄入了上千條數(shù)據(jù)卡一次答辯印象分就低了。5.4 JTable 表格不顯示數(shù)據(jù)或表頭錯(cuò)位現(xiàn)象查詢返回了結(jié)果數(shù)據(jù)庫(kù)里也有數(shù)據(jù)但表格空蕩蕩或者數(shù)據(jù)出現(xiàn)但表頭還是默認(rèn)的 A、B、C。原因表格還沒(méi)有初始化 TableModel 時(shí)你就去 setRowCount 或 addRow摸了個(gè)空模型或者是強(qiáng)轉(zhuǎn) DefaultTableModel 失敗。另一個(gè)原因是 ResultSet 里的列名和表頭不映射你 getString(student_no) 里面名字寫錯(cuò)異常被 catch 吞掉導(dǎo)致界面毫無(wú)反饋。解決在窗體構(gòu)造方法里先把表格模型定死studentTable.setModel(new DefaultTableModel( new Object[]{ID, 學(xué)號(hào), 姓名, 專業(yè)}, 0 ));然后每次查詢都基于這個(gè)固定模型往里面加行。如果 catch 到 SQLException別只 e.printStackTrace加一個(gè) JOptionPane 把錯(cuò)誤信息彈出來(lái)否則你死活不知道數(shù)據(jù)為什么沒(méi)進(jìn)來(lái)。順帶說(shuō)一句ResultSet 里的列名是大小寫不敏感的但下劃線和大小寫風(fēng)格要和 SQL 里 select 出來(lái)的別名對(duì)齊最簡(jiǎn)單的方式是 select id, student_no 而不是 select *。5.5 打包后 NoClassDefFoundErrorjar 能運(yùn)行但不能碰 MySQL現(xiàn)象IDEA 里運(yùn)行一切正常但雙擊 jar 包報(bào)錯(cuò)NoClassDefFoundError 指向 com/mysql/cj/jdbc/Driver或者提示類路徑里找不到某個(gè)包。原因默認(rèn)的 maven-jar-plugin 只打包項(xiàng)目自己的類不包含任何第三方依賴。你的 IDE 運(yùn)行環(huán)境里有 mysql-connector-java但 jar 跑起來(lái)后就沒(méi)有這個(gè)依賴了。另一個(gè)可能是 MANIFEST.MF 里沒(méi)寫 Main-Class導(dǎo)致雙擊時(shí)提示無(wú)法加載主類。解決按第四章給 maven-shade-plugin 的配置在 pom.xml 里加上插件且指定 mainClass再執(zhí)行 mvn clean package。打包成功后用這個(gè)命令驗(yàn)證一下 jar 里的 MANIFEST 是否有主類java -jar target/your-project.jar如果還不行用 jar tf 查看是否能看到 com/mysql/cj 相關(guān) class?？床坏骄褪?shade 配置沒(méi)生效檢查 executions 是否掛在 package 階段以及插件版本是否被成功解析。從這個(gè)坑往后我拿到任何 Maven Swing 項(xiàng)目都會(huì)先看一眼 pom 有沒(méi)有打包插件沒(méi)有就先補(bǔ)上再談別的。6. 答辯前這樣升級(jí)密碼加密、預(yù)編譯、連接池與發(fā)行包想要從“能跑”變成“能講”不用大改功能做對(duì)三個(gè)細(xì)節(jié)就夠了。第一個(gè)是密碼存儲(chǔ)。資源初始賬號(hào)里如果 password 還是明文 123456答辯時(shí)老師第一個(gè)問(wèn)題大概率是“密碼怎么防泄露”。改成哈希存儲(chǔ)登錄校驗(yàn)也同步改成哈希比對(duì)是很加分的改動(dòng)MessageDigest md MessageDigest.getInstance(SHA-256); byte[] digest md.digest(password.getBytes(StandardCharsets.UTF_8)); String hashed HexFormat.of().formatHex(digest);登錄時(shí)用相同邏輯對(duì)輸入做哈希再拿哈希值去查庫(kù)。如果資源里的登錄是直接 SELECT ... WHERE password?你可以先跑通再把它替換成哈希版本。要更嚴(yán)謹(jǐn)還可以加鹽但加鹽需要在庫(kù)里額外存一列課程設(shè)計(jì)做到哈希這步就足夠說(shuō)明你有安全意識(shí)了。第二個(gè)改動(dòng)是統(tǒng)一走 PreparedStatement。我見(jiàn)過(guò)不少源碼里用 Statement 字符串拼接寫查詢雖然能跑但屬于答辯現(xiàn)場(chǎng)的高危雷區(qū)。如果你在資源里發(fā)現(xiàn)這類寫法不用全部重寫把最核心的登錄和查詢改成預(yù)編譯然后準(zhǔn)備一句話“這里用占位符防止 SQL 注入對(duì)用戶輸入不做字符串拼接”。這句話在面試題里也常被問(wèn)到背下它比背一行代碼更值。第三個(gè)改動(dòng)是連接管理。很多簡(jiǎn)單項(xiàng)目每次查庫(kù)都 DriverManager.getConnection操作完了關(guān)閉。答辯時(shí)你可以主動(dòng)提連接池這個(gè)概念最低成本的演示是引入 HikariCPHikariConfig config new HikariConfig(); config.setJdbcUrl(URL); config.setUsername(USER); config.setPassword(PASSWORD); config.setMaximumPoolSize(10); HikariDataSource ds new HikariDataSource(config); Connection conn ds.getConnection();注意這需要 pom.xml 里加 HikariCP 依賴如果不想引入第三方庫(kù)也可以用 DBCP。關(guān)鍵是讓老師看到你理解“頻繁創(chuàng)建連接很浪費(fèi)”這件事。這三個(gè)改動(dòng)做完項(xiàng)目的代碼量不會(huì)增加多少但答辯能從“我做了個(gè)系統(tǒng)”變成“我考慮了安全、性能和擴(kuò)展性”。我做過(guò)最蠢的一件事是拿到一份課程設(shè)計(jì)源碼后連 MySQL 服務(wù)都沒(méi)啟動(dòng)就急著點(diǎn)運(yùn)行報(bào)錯(cuò)后以為是源碼壞了來(lái)回折騰了一小時(shí)。從那以后每次拿到源碼我都會(huì)強(qiáng)制走一遍建庫(kù) → 改連接 → 編譯 → 運(yùn)行的流程再開(kāi)始動(dòng)手改界面。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取