：從驅動配置到發(fā)布部署實戰(zhàn))
簡介面向計算機科學與技術專業(yè)學生畢業(yè)設計/課程設計的C Qt學生信息管理系統(tǒng)項目包以Qt構建圖形界面、MySQL作為數據存儲完整覆蓋數據庫設計、界面布局、SQL增刪改查、事件綁定與異常處理等環(huán)節(jié)適合希望系統(tǒng)提升C與數據庫應用能力的開發(fā)者參考。壓縮包共79個文件包括26個cpp源碼、25個h頭文件、23個ui界面文件另含pro工程文件、sql建表腳本、md說明與docx使用報告整體大小212KB結構清晰便于工程導入和學習。已有710人學習下載。項目中內置學生、課程、宿舍、繳費、獎懲等管理模塊并附有完整的畢業(yè)設計報告與數據庫腳本既能幫助快速搭建可運行的學生信息管理Demo也能為畢業(yè)設計文檔編寫、答辯演示和功能擴展提供直接參考。1. 畢設項目是C Qt與MySQL的組合其實并不復雜把 Mysql 集成進界面系統(tǒng)是主要工作量學生信息管理系統(tǒng)可分解成三個問題數據庫建模與訪問、Qt界面交互、發(fā)布部署。第一點決定數據存取的穩(wěn)定性第二點決定演示效果第三點決定能否交得出差?？蚣苓x擇上Qt 5.15 LTS穩(wěn)定MySQL 8.0普遍驅動用QSqlDatabaseORM可選QSqlQuery直接執(zhí)行SQL。要避免直接把SQL字符串拼進槽函數后續(xù)維護很麻煩。真正需要想清楚的是怎么把查詢出來的數據放到表格里刪除一條學生記錄時如何處理關聯成績表以及在沒有安裝Qt的環(huán)境中如何跑起來。2. Mysql數據庫與Qt項目的環(huán)境適配思路里常見問題是驅動版本不匹配和編碼不一致系統(tǒng)要先建庫建表再通過Qt連接最后處理中文亂碼。很多人的畢設一上來就寫界面結果連不上數據庫后面全部返工。正確順序是先讓命令行能與 MySQL 正常通信再寫 Qt 代碼。2.1 數據庫基礎student表給出結構包含 id、name、gender、major、phone、birth_date、enroll_year 等字段成績表 score_info 關聯 student_id 與 course_id學生信息管理系統(tǒng)的核心數據由兩部分組成學生基本信息和課程成績。把這兩類數據放進同一張表會帶來大量冗余所以需要拆成兩個表。student 表存儲學生的自然屬性score 表負責記錄多門課程的成績通過學號把兩張表關聯起來。CREATE DATABASE IF NOT EXISTS student_db DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci; USE student_db; CREATE TABLE IF NOT EXISTS student ( student_id VARCHAR(20) PRIMARY KEY, name VARCHAR(50) NOT NULL, gender ENUM(男,女) DEFAULT 男, major VARCHAR(100), class_name VARCHAR(50), phone VARCHAR(11), birth_date DATE, enroll_year YEAR ) ENGINEInnoDB; CREATE TABLE IF NOT EXISTS score ( id INT AUTO_INCREMENT PRIMARY KEY, student_id VARCHAR(20) NOT NULL, course_name VARCHAR(100) NOT NULL, score DECIMAL(5,1), FOREIGN KEY (student_id) REFERENCES student(student_id) ON DELETE CASCADE ) ENGINEInnoDB;上面的腳本里“CREATE DATABASE IF NOT EXISTS”只會創(chuàng)建一次多次執(zhí)行不會報錯適合在 Qt 啟動時預檢數據庫中自動調用。student_id 用 VARCHAR(20) 而不是 INT因為很多學校的學號帶字母或前導零整數類型會把這些信息丟掉。ENUM 字段在 Qt 表格里顯示中文綁定數據時注意傳給 QSqlTableModel 的值要與枚舉定義一致。score 表使用 AUTO_INCREMENT 作為內部主鍵是為了避免一個學生選多門課時 student_id 重復導致主鍵沖突。外鍵帶 ON DELETE CASCADE刪除學生時數據庫會自動清理該生的所有成績記錄省得在 Qt 代碼里手動先刪成績再刪學生。2.2 在 Windows 下安裝 MySQL 8.0 并配置 Qt 5.15 的連接驅動注意 MSVC 與 MinGW 的驅動文件路徑不同需要將 libmysql.dll 放到正確位置MySQL 安裝配置教程中經常強調字符集安裝時選擇 Server only 后配置類型選 Development Machine 即可重點是字符集必須選 utf8mb4。如果安裝時選錯后面可以統(tǒng)一改表但連接層的字符集還會出問題。Qt 官方在 Windows 上提供 MSVC 和 MinGW 兩套編譯版本MySQL 官網下載的 C 連接器是 MSVC 編譯的兩者不能隨意互用。驅動不匹配是畢設最常見問題表現為 QSqlDatabase 查詢時報 “Driver not loaded”。要確認當前 Qt 是否能加載 MySQL 驅動可以先用一段代碼列出所有可用驅動QStringList drivers QSqlDatabase::drivers(); qDebug() drivers;如果列表里包含 QMYSQL說明驅動文件存在如果只有 QSQLITE說明 qsqlmysql.dll 缺失或路徑不對。缺驅動時有兩個處理方式一是把 Qt 安裝目錄中 plugins/sqldrivers/qsqlmysql.dll 和 MySQL 的 libmysql.dll 復制到程序可執(zhí)行文件旁二是重新編譯驅動但畢設場景下復制文件更快。注意 Qt 套件必須與編譯環(huán)境一致用 MSVC 編譯的 Qt 項目不能搭配 MinGW 的插件文件否則會出現運行時崩潰。2.3 連接字串與編碼配置在代碼中設置連接參數并使用 QSqlQuery 執(zhí)行 DDL 和 DML隨后檢查錯誤細節(jié)連接 MySQL 時用到 QSqlDatabase 單例模式。每次 addDatabase 使用不同的連接名避免多個窗口同時打開默認連接帶來的沖突。QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL, main_conn); db.setHostName(127.0.0.1); db.setPort(3306); db.setDatabaseName(student_db); db.setUserName(root); db.setPassword(your_password); if (!db.open()) { qDebug() open error: db.lastError().text(); return; } QSqlQuery query(db); query.exec(SELECT COUNT(*) FROM student); if (query.next()) { qDebug() total: query.value(0).toInt(); }這里關鍵點是 open 失敗后 lastError().text() 的輸出。如果是 “Access denied”先檢查密碼或用戶名如果是 “Unknown database”說明 student_db 還沒有創(chuàng)建可以先不指定數據庫名連接成功后用 SQL 建庫。端口參數傳遞 3306 即可注意不要寫成字符串Qt 會自動轉換。驅動連接成功后執(zhí)行 SET NAMES utf8mb4 也可以但與數據庫默認字符集重復設置沒有明顯副作用。錯誤排查時先用 MySQL Workbench 或命令行確認同樣的連接參數能夠工作這樣能快速把問題定位到 Qt 側還是 MySQL 側。3. 用 Qt 構建學生信息管理系統(tǒng)的數據層與界面層數據層封裝再界面調用核心是 QSqlTableModel 與信號槽聯動界面層負責錄入與顯示數據層負責查詢與提交。直接用 QSqlQuery 寫每次增刪改并不是不行但 QSqlTableModel 可以大幅減少代碼量。表格控件與數據庫表形成映射關系單元格編輯完成后可以直接提交。3.1 QSqlTableModel 與 QTableView 的組合用法直接修改表格內容即可同步數據庫避免手寫大量 UPDATE 語句QSqlTableModel 是 Qt 提供的表模型它與數據庫表一一對應并提供 select、insert、delete、submit 等接口。用它操作學生表非常自然model new QSqlTableModel(this, db); model-setTable(student); model-setEditStrategy(QSqlTableModel::OnManualSubmit); model-select(); model-setHeaderData(0, Qt::Horizontal, 學號); model-setHeaderData(1, Qt::Horizontal, 姓名); ui-tableView-setModel(model);setEditStrategy 選擇 OnManualSubmit這樣用戶在表格里改數據后只有點擊“保存”按鈕才真正寫入數據庫避免點到其他單元格時立刻更新落庫。調用 submitAll 時如果有一條記錄提交失敗整個事務回滾不會出現一半數據寫進去一半沒有寫。添加一條新記錄的代碼是int row model-rowCount(); model-insertRow(row); model-setData(model-index(row, 0), ui-newIdEdit-text()); model-setData(model-index(row, 1), ui-newNameEdit-text());這里有一個看不見的坑student_id 是主鍵insertRow 之后如果學號輸入為空或重復submitAll 會在數據庫層報錯Qt 這邊只能拿到通用錯誤信息看不到具體字段。因此在提交之前要做一次重復檢查可以通過 QSqlQuery 先查到現有學號集合再與將要插入的數據比對。刪除學生時直接用 removeRow 然后 submitAll外鍵的級聯刪除會自動清理 score 表中的成績記錄這一點在設計表時就避免了遺留孤兒數據。3.1.1 在按鈕槽中實現添加、刪除、修改的邏輯添加、刪除、修改三個操作集中在三個槽函數里界面按鈕通過 clicked 信號連接。修改不是單獨按鈕而是依賴 QTableView 的編輯功能用戶雙擊單元格即可修改需要保存時點擊“保存”按鈕。void MainWindow::onSave() { if (!model-submitAll()) { qDebug() submit error: model-lastError().text(); model-revertAll(); } else { model-submitAll(); ui-statusBar-showMessage(保存成功, 3000); } } void MainWindow::onDelete() { QModelIndex cur ui-tableView-currentIndex(); if (!cur.isValid()) { QMessageBox::warning(this, 提示, 請先選擇要刪除的行); return; } model-removeRow(cur.row()); }代碼中的 model-lastError() 是 QSqlError 類型直接轉 text 輸出即可。刪除時 currentIndex 返回無效索引意味著點擊的是表格空白區(qū)域這時應該提示用戶而不是直接執(zhí)行刪除。revertAll 只回滾還沒有提交到數據庫的修改已經 submitAll 的數據無法撤銷這是設計上的注意點。對畢設來說提交前彈窗讓用戶確認會很加分但確認框不要放在槽函數內部可以單獨抽成一個判斷函數。3.2 用 QSqlQuery 實現按學號與姓名模糊查詢并支持排序前端通過行編輯框輸入條件QSqlTableModel 雖然方便但自定義查詢條件時太受限。比如按學號模糊查詢可以選擇 setFilter 方式也可以換用 QSqlQueryModel。QSqlQueryModel 是只讀模型適合顯示查詢結果不直接編輯。void MainWindow::onSearch() { QString keyword ui-searchEdit-text().trimmed(); QSqlQuery query(db); query.prepare(SELECT student_id, name, gender, major, class_name FROM student WHERE student_id LIKE :kw OR name LIKE :kw ORDER BY enroll_year DESC); query.bindValue(:kw, % keyword %); if (!query.exec()) { qDebug() query.lastError().text(); return; } QSqlQueryModel *resultModel new QSqlQueryModel(this); resultModel-setQuery(std::move(query)); ui-tableView-setModel(resultModel); }代碼中 LIKE 語句加上兩個百分號可以匹配學號或姓名的任意位置例如輸入“張”能把“張三”“老張頭”都查出來。查詢模型替換了原來的表格模型后之前編輯功能會失效這是正常的因為查詢結果本身是只讀視圖。ORDER BY enroll_year DESC 讓新入學的學生排在最前面方便老師查看最近一屆數據。如果想回到全部列表重新執(zhí)行 model-select() 并把模型換回 QSqlTableModel 即可。3.2.1 模糊查詢代碼與參數說明bindValue 綁定參數的做法是為防止 SQL 注入畢設中直接拼字符串也能運行但不建議。用占位符后即使關鍵字包含單引號也不會破壞 SQL 結構。查詢結果為空時QTableView 會顯示空行不會報錯需要另一段判斷邏輯提示“沒有找到匹配記錄”可以使用 query.next() 判斷。關于列頭顯示QSqlQueryModel 默認列名來自數據庫字段名直接顯示英文不好看。給列設置別名更有效查詢中用 AS 重命名例如 SELECT student_id AS 學號, name AS 姓名。但 QTableView 綁定模型后列名會直接變成中文若通過 setHeaderData 會失效應當優(yōu)先選擇 SQL 別名方案。系統(tǒng)常態(tài)下默認表格顯示 student 表全部內容搜索時替換成查詢模型搜索結束后重新加載。3.3 信號槽與數據刷新一致性多個窗口共用同一個數據庫連接使用全局單例管理連接系統(tǒng)如果包含“學生信息管理”和“成績錄入”兩個窗口每個窗口各自調用 addDatabase 會創(chuàng)建多個物理連接浪費資源且容易踩并發(fā)修改的問題。合理設計是讓整個程序共享一個 QSqlDatabase。class DbManager { public: static QSqlDatabase getConnection() { if (QSqlDatabase::contains(main_conn)) { return QSqlDatabase::database(main_conn); } QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL, main_conn); db.setHostName(127.0.0.1); db.setPort(3306); db.setDatabaseName(student_db); db.setUserName(root); db.setPassword(your_password); if (!db.open()) { qDebug() open failed: db.lastError().text(); } return db; } };利用 Qt 的連接池特性每次通過 QSqlDatabase::database(main_conn) 獲取同一個連接句柄不需要重復打開。在子窗口對數據庫做出改變后主窗口需要刷新時直接 model-select()但要注意該操作必須是在同一個連接對象上執(zhí)行。事務操作時兩個窗口同時提交后提交的一方可能會覆蓋前面的記錄畢設中減少這種風險的辦法是提交前都重新 select 一次。4. 發(fā)布與常用排錯場景Qt 程序在另一臺電腦上運行時的常見問題以及 MySQL 驅動缺失的解決步驟能把系統(tǒng)在開發(fā)機上跑通只是第一步交畢設或者給老師演示時經常換到一臺沒有 Qt 環(huán)境的電腦上問題會在發(fā)布環(huán)節(jié)集中爆發(fā)。打包過程有固定的動作不能只復制 exe。4.1 用 windeployqt 工具生成 exe 的依賴文件注意 Qt 版本與編譯器配套并把 MySQL 的 dll 一起放進部署目錄發(fā)布流程從 Release 構建開始。打開 Qt 提供的命令行工具例如 “Qt 5.15.2 (MSVC 2019 64-bit)”進入 Release 輸出目錄。運行windeployqt StudentSystem.exewindeployqt 會遞歸復制 Qt 運行時、平臺插件、樣式插件。但有兩個東西它不會自動處理一是 MySQL 驅動二是 libmysql.dll。手動復制時從 Qt 安裝路徑下找到 plugins/sqldrivers/qsqlmysql.dll復制到發(fā)布目錄的 sqldrivers 子目錄下。然后從 MySQL 安裝目錄的 lib 下復制 libmysql.dll放到 exe 同級目錄。兩個文件缺一不可否則最終運行時會出現 “Driver not loaded”。常見錯誤清單如下錯誤現象原因處理方法程序啟動提示缺少 Qt5Core.dllwindeployqt 未成功或平臺插件缺失重新執(zhí)行 windeployqt確認生成 platforms 目錄QSqlDatabase: QMYSQL driver not loaded缺少 qsqlmysql.dll 或 libmysql.dll檢查 sqldrivers 目錄及 libmysql.dll 位置Access denied for user ‘root’密碼錯誤或 root 權限限制核對 MySQL 賬號密碼確認 host 為 127.0.0.1Unknown database未建庫或庫名不匹配在 MySQL 中執(zhí)行建庫腳本Can’t connect to MySQL serverMySQL 服務未啟動或端口被防火墻攔截打開服務管理器啟動 MySQL80放行 3306windeployqt 生成的目錄里還包括 translations 文件夾保留它用于 qt 國際化支持。如果程序界面顯示中文但按鈕文字變成亂碼多半是源文件編碼問題需要將 .cpp 文件另存為 UTF-8 with BOM。4.2 中文亂碼的兩處根源外部數據源編碼與 Qt 內部顯示編碼建議統(tǒng)一為 UTF8Qt 5 內部使用 Unicode中文處理本身沒大問題。亂碼通常出在三個環(huán)節(jié)源文件編碼、數據庫表字符集、控制臺輸出。源文件用 GB2312 或 ANSI 保存時編譯器 VS 會按本地代碼頁解釋導致中文字符串顯示為“鎴戠殑”之類的內容。解決方案是統(tǒng)一用 UTF-8 with BOM并添加預處理指令查看編譯器警告。數據庫表字符集配置為 utf8mb4 后Qt 連接時不需要額外轉換。但需要注意MySQL 連接層默認字符集可能與表格不一致?？梢栽谶B接后執(zhí)行SET NAMES utf8mb4;這條語句可以放在連接成功后執(zhí)行也可以作為一條 QSqlQuery 調用。如果還是亂碼檢查 Windows 區(qū)域設置是否使用了 Unicode UTF-8在“控制面板-區(qū)域”中勾選“Beta使用 Unicode UTF-8 提供全球語言支持”后重啟很多詭異的亂碼問題會消失。畢設中不建議通過 QString::fromLocal8Bit 來處理那只是掩蓋了編碼不一致的根源。5. 學生信息管理系統(tǒng)的進階用法主要有三條打包、加密連接配置與報表輸出。這三項會讓系統(tǒng)從能用變?yōu)楹糜卯敾A增刪改查完成可以加入一些能夠提升完成度的功能同時保持代碼量可控。下面三個方向任選其一都能讓系統(tǒng)觀感有明顯提升。5.1 把密碼加密存儲到配置文件中不再寫在代碼里每次運行時讀取配置文件代碼中寫死數據庫密碼在開發(fā)時方便但系統(tǒng)一旦給老師或同學演示源碼會被看到數據庫密碼就泄露了。常見做法是把連接參數移到一個 ini 文件程序啟動時讀取。另一個層面本地配置文件本身就是明文所以還需要對密碼做簡單混淆。使用 QCryptographicHash 對密碼進行 SHA-256 加鹽處理然后保存哈希值連接數據庫時把用戶輸入的密碼做同樣處理比對哈希是否一致這樣可以保護密碼不被直接讀出來而真正用于連接數據庫的密碼密鑰可以用 macOS 鑰匙串或 Windows 憑據管理器存儲但實現成本較高不建議在畢設中引入?？尚械姆绞绞翘峁┮粋€配置文件里面存放 MySQL 用戶名和密碼。使用 QSettings 讀取QSettings settings(config.ini, QSettings::IniFormat); settings.beginGroup(mysql); QString host settings.value(host, 127.0.0.1).toString(); int port settings.value(port, 3306).toInt(); QString user settings.value(user, root).toString(); QString password settings.value(password).toString(); settings.endGroup();參數后面的默認值省去了手工填寫的步驟host 默認 127.0.0.1port 默認 3306。密碼字段在部署時由人工寫入。配置文件與 exe 放在同一目錄程序啟動時如果找不到可以直接用寫死的默認值再給出“配置文件缺失使用默認連接參數”的提示這樣能兼容不同使用環(huán)境。5.2 導出一份包含學生信息和成績統(tǒng)計的 Excel 或 PDF 報表能夠提升系統(tǒng)完成度在 Qt 中輸出 Excel 有幾種路徑若目標機器安裝了 Office可以用 QAxObject 操作 Excel COM 組件編程靈活但依賴 Office如果不依賴 Office可以使用 CSV 文件Excel 也能打開通用性好且代碼量少。生成 CSV 的核心是讀取數據庫內容并組合寫文件QFile file(students_report.csv); if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) { return; } QTextStream out(file); out.setEncoding(QStringConverter::Utf8); out 學號,姓名,專業(yè),班級\n; QSqlQuery query(db); query.exec(SELECT student_id, name, major, class_name FROM student); while (query.next()) { out query.value(0).toString() , query.value(1).toString() , query.value(2).toString() , query.value(3).toString() \n; } file.close();上述代碼使用 QTextStream 并設置 UTF-8 編碼生成的 CSV 文件用 Excel 打開時中文能正常顯示。如果把內容變成績統(tǒng)計SQL 中可以用 GROUP BY 和 AVG 計算各課程平均分然后把結果寫入 CSV 另一列。如果需要真正的圖表展示推薦 Qt Charts 模塊在 .pro 文件里添加 QT charts然后使用 QChart 顯示柱狀統(tǒng)計圖能直觀展示各課程平均分差異。5.3 給系統(tǒng)加上一份自檢腳本啟動時驗證 MySQL 驅動、連接與數據表完整性減少現場排錯時間系統(tǒng)接手另一臺電腦運行前任何人都無法預判目標環(huán)境的 MySQL 服務是否啟動、驅動是否完整。因此程序啟動后立即執(zhí)行一次自檢錯誤信息直接彈窗或寫入日志能省去很多現場排查時間。自檢順序先驅動、再連接、后檢查表void MainWindow::selfCheck() { if (!QSqlDatabase::isDriverAvailable(QMYSQL)) { QMessageBox::critical(this, 驅動錯誤, QMYSQL 驅動不可用請檢查 Qt 插件目錄); return; } QSqlDatabase db DbManager::getConnection(); if (!db.isOpen()) { QMessageBox::critical(this, 連接失敗, db.lastError().text()); return; } QSqlQuery query(db); if (!query.exec(SELECT COUNT(*) FROM student)) { QMessageBox::critical(this, 表缺失, student 表不存在請執(zhí)行建表腳本); return; } }isDriverAvailable 檢查的是當前 Qt 編譯是否包含了 MySQL 驅動連接失敗再檢查 MySQL 服務狀態(tài)表缺失則提示執(zhí)行建表腳本。自檢函數在構造函數中使用 QTimer::singleShot(0, this, MainWindow::selfCheck) 調用讓界面先顯示出來然后再進行耗時操作。狀態(tài)欄可顯示最終通過自檢的學生數量如“共加載 128 條學生記錄”用戶一眼就知道數據是否完整。這套流程之后即使在另一臺電腦上部署最多只需要調整 config.ini 里的密碼剩下的錯誤會直接指出具體瓶頸減少無頭緒的日志翻找。本文還有配套的精品資源點擊獲取 Qt與MySQL學生信息管理系統(tǒng)：從驅動配置到發(fā)布部署實戰(zhàn)
簡介面向計算機科學與技術專業(yè)學生畢業(yè)設計/課程設計的C Qt學生信息管理系統(tǒng)項目包以Qt構建圖形界面、MySQL作為數據存儲完整覆蓋數據庫設計、界面布局、SQL增刪改查、事件綁定與異常處理等環(huán)節(jié)適合希望系統(tǒng)提升C與數據庫應用能力的開發(fā)者參考。壓縮包共79個文件包括26個cpp源碼、25個h頭文件、23個ui界面文件另含pro工程文件、sql建表腳本、md說明與docx使用報告整體大小212KB結構清晰便于工程導入和學習。已有710人學習下載。項目中內置學生、課程、宿舍、繳費、獎懲等管理模塊并附有完整的畢業(yè)設計報告與數據庫腳本既能幫助快速搭建可運行的學生信息管理Demo也能為畢業(yè)設計文檔編寫、答辯演示和功能擴展提供直接參考。1. 畢設項目是C Qt與MySQL的組合其實并不復雜把 Mysql 集成進界面系統(tǒng)是主要工作量學生信息管理系統(tǒng)可分解成三個問題數據庫建模與訪問、Qt界面交互、發(fā)布部署。第一點決定數據存取的穩(wěn)定性第二點決定演示效果第三點決定能否交得出差?？蚣苓x擇上Qt 5.15 LTS穩(wěn)定MySQL 8.0普遍驅動用QSqlDatabaseORM可選QSqlQuery直接執(zhí)行SQL。要避免直接把SQL字符串拼進槽函數后續(xù)維護很麻煩。真正需要想清楚的是怎么把查詢出來的數據放到表格里刪除一條學生記錄時如何處理關聯成績表以及在沒有安裝Qt的環(huán)境中如何跑起來。2. Mysql數據庫與Qt項目的環(huán)境適配思路里常見問題是驅動版本不匹配和編碼不一致系統(tǒng)要先建庫建表再通過Qt連接最后處理中文亂碼。很多人的畢設一上來就寫界面結果連不上數據庫后面全部返工。正確順序是先讓命令行能與 MySQL 正常通信再寫 Qt 代碼。2.1 數據庫基礎student表給出結構包含 id、name、gender、major、phone、birth_date、enroll_year 等字段成績表 score_info 關聯 student_id 與 course_id學生信息管理系統(tǒng)的核心數據由兩部分組成學生基本信息和課程成績。把這兩類數據放進同一張表會帶來大量冗余所以需要拆成兩個表。student 表存儲學生的自然屬性score 表負責記錄多門課程的成績通過學號把兩張表關聯起來。CREATE DATABASE IF NOT EXISTS student_db DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci; USE student_db; CREATE TABLE IF NOT EXISTS student ( student_id VARCHAR(20) PRIMARY KEY, name VARCHAR(50) NOT NULL, gender ENUM(男,女) DEFAULT 男, major VARCHAR(100), class_name VARCHAR(50), phone VARCHAR(11), birth_date DATE, enroll_year YEAR ) ENGINEInnoDB; CREATE TABLE IF NOT EXISTS score ( id INT AUTO_INCREMENT PRIMARY KEY, student_id VARCHAR(20) NOT NULL, course_name VARCHAR(100) NOT NULL, score DECIMAL(5,1), FOREIGN KEY (student_id) REFERENCES student(student_id) ON DELETE CASCADE ) ENGINEInnoDB;上面的腳本里“CREATE DATABASE IF NOT EXISTS”只會創(chuàng)建一次多次執(zhí)行不會報錯適合在 Qt 啟動時預檢數據庫中自動調用。student_id 用 VARCHAR(20) 而不是 INT因為很多學校的學號帶字母或前導零整數類型會把這些信息丟掉。ENUM 字段在 Qt 表格里顯示中文綁定數據時注意傳給 QSqlTableModel 的值要與枚舉定義一致。score 表使用 AUTO_INCREMENT 作為內部主鍵是為了避免一個學生選多門課時 student_id 重復導致主鍵沖突。外鍵帶 ON DELETE CASCADE刪除學生時數據庫會自動清理該生的所有成績記錄省得在 Qt 代碼里手動先刪成績再刪學生。2.2 在 Windows 下安裝 MySQL 8.0 并配置 Qt 5.15 的連接驅動注意 MSVC 與 MinGW 的驅動文件路徑不同需要將 libmysql.dll 放到正確位置MySQL 安裝配置教程中經常強調字符集安裝時選擇 Server only 后配置類型選 Development Machine 即可重點是字符集必須選 utf8mb4。如果安裝時選錯后面可以統(tǒng)一改表但連接層的字符集還會出問題。Qt 官方在 Windows 上提供 MSVC 和 MinGW 兩套編譯版本MySQL 官網下載的 C 連接器是 MSVC 編譯的兩者不能隨意互用。驅動不匹配是畢設最常見問題表現為 QSqlDatabase 查詢時報 “Driver not loaded”。要確認當前 Qt 是否能加載 MySQL 驅動可以先用一段代碼列出所有可用驅動QStringList drivers QSqlDatabase::drivers(); qDebug() drivers;如果列表里包含 QMYSQL說明驅動文件存在如果只有 QSQLITE說明 qsqlmysql.dll 缺失或路徑不對。缺驅動時有兩個處理方式一是把 Qt 安裝目錄中 plugins/sqldrivers/qsqlmysql.dll 和 MySQL 的 libmysql.dll 復制到程序可執(zhí)行文件旁二是重新編譯驅動但畢設場景下復制文件更快。注意 Qt 套件必須與編譯環(huán)境一致用 MSVC 編譯的 Qt 項目不能搭配 MinGW 的插件文件否則會出現運行時崩潰。2.3 連接字串與編碼配置在代碼中設置連接參數并使用 QSqlQuery 執(zhí)行 DDL 和 DML隨后檢查錯誤細節(jié)連接 MySQL 時用到 QSqlDatabase 單例模式。每次 addDatabase 使用不同的連接名避免多個窗口同時打開默認連接帶來的沖突。QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL, main_conn); db.setHostName(127.0.0.1); db.setPort(3306); db.setDatabaseName(student_db); db.setUserName(root); db.setPassword(your_password); if (!db.open()) { qDebug() open error: db.lastError().text(); return; } QSqlQuery query(db); query.exec(SELECT COUNT(*) FROM student); if (query.next()) { qDebug() total: query.value(0).toInt(); }這里關鍵點是 open 失敗后 lastError().text() 的輸出。如果是 “Access denied”先檢查密碼或用戶名如果是 “Unknown database”說明 student_db 還沒有創(chuàng)建可以先不指定數據庫名連接成功后用 SQL 建庫。端口參數傳遞 3306 即可注意不要寫成字符串Qt 會自動轉換。驅動連接成功后執(zhí)行 SET NAMES utf8mb4 也可以但與數據庫默認字符集重復設置沒有明顯副作用。錯誤排查時先用 MySQL Workbench 或命令行確認同樣的連接參數能夠工作這樣能快速把問題定位到 Qt 側還是 MySQL 側。3. 用 Qt 構建學生信息管理系統(tǒng)的數據層與界面層數據層封裝再界面調用核心是 QSqlTableModel 與信號槽聯動界面層負責錄入與顯示數據層負責查詢與提交。直接用 QSqlQuery 寫每次增刪改并不是不行但 QSqlTableModel 可以大幅減少代碼量。表格控件與數據庫表形成映射關系單元格編輯完成后可以直接提交。3.1 QSqlTableModel 與 QTableView 的組合用法直接修改表格內容即可同步數據庫避免手寫大量 UPDATE 語句QSqlTableModel 是 Qt 提供的表模型它與數據庫表一一對應并提供 select、insert、delete、submit 等接口。用它操作學生表非常自然model new QSqlTableModel(this, db); model-setTable(student); model-setEditStrategy(QSqlTableModel::OnManualSubmit); model-select(); model-setHeaderData(0, Qt::Horizontal, 學號); model-setHeaderData(1, Qt::Horizontal, 姓名); ui-tableView-setModel(model);setEditStrategy 選擇 OnManualSubmit這樣用戶在表格里改數據后只有點擊“保存”按鈕才真正寫入數據庫避免點到其他單元格時立刻更新落庫。調用 submitAll 時如果有一條記錄提交失敗整個事務回滾不會出現一半數據寫進去一半沒有寫。添加一條新記錄的代碼是int row model-rowCount(); model-insertRow(row); model-setData(model-index(row, 0), ui-newIdEdit-text()); model-setData(model-index(row, 1), ui-newNameEdit-text());這里有一個看不見的坑student_id 是主鍵insertRow 之后如果學號輸入為空或重復submitAll 會在數據庫層報錯Qt 這邊只能拿到通用錯誤信息看不到具體字段。因此在提交之前要做一次重復檢查可以通過 QSqlQuery 先查到現有學號集合再與將要插入的數據比對。刪除學生時直接用 removeRow 然后 submitAll外鍵的級聯刪除會自動清理 score 表中的成績記錄這一點在設計表時就避免了遺留孤兒數據。3.1.1 在按鈕槽中實現添加、刪除、修改的邏輯添加、刪除、修改三個操作集中在三個槽函數里界面按鈕通過 clicked 信號連接。修改不是單獨按鈕而是依賴 QTableView 的編輯功能用戶雙擊單元格即可修改需要保存時點擊“保存”按鈕。void MainWindow::onSave() { if (!model-submitAll()) { qDebug() submit error: model-lastError().text(); model-revertAll(); } else { model-submitAll(); ui-statusBar-showMessage(保存成功, 3000); } } void MainWindow::onDelete() { QModelIndex cur ui-tableView-currentIndex(); if (!cur.isValid()) { QMessageBox::warning(this, 提示, 請先選擇要刪除的行); return; } model-removeRow(cur.row()); }代碼中的 model-lastError() 是 QSqlError 類型直接轉 text 輸出即可。刪除時 currentIndex 返回無效索引意味著點擊的是表格空白區(qū)域這時應該提示用戶而不是直接執(zhí)行刪除。revertAll 只回滾還沒有提交到數據庫的修改已經 submitAll 的數據無法撤銷這是設計上的注意點。對畢設來說提交前彈窗讓用戶確認會很加分但確認框不要放在槽函數內部可以單獨抽成一個判斷函數。3.2 用 QSqlQuery 實現按學號與姓名模糊查詢并支持排序前端通過行編輯框輸入條件QSqlTableModel 雖然方便但自定義查詢條件時太受限。比如按學號模糊查詢可以選擇 setFilter 方式也可以換用 QSqlQueryModel。QSqlQueryModel 是只讀模型適合顯示查詢結果不直接編輯。void MainWindow::onSearch() { QString keyword ui-searchEdit-text().trimmed(); QSqlQuery query(db); query.prepare(SELECT student_id, name, gender, major, class_name FROM student WHERE student_id LIKE :kw OR name LIKE :kw ORDER BY enroll_year DESC); query.bindValue(:kw, % keyword %); if (!query.exec()) { qDebug() query.lastError().text(); return; } QSqlQueryModel *resultModel new QSqlQueryModel(this); resultModel-setQuery(std::move(query)); ui-tableView-setModel(resultModel); }代碼中 LIKE 語句加上兩個百分號可以匹配學號或姓名的任意位置例如輸入“張”能把“張三”“老張頭”都查出來。查詢模型替換了原來的表格模型后之前編輯功能會失效這是正常的因為查詢結果本身是只讀視圖。ORDER BY enroll_year DESC 讓新入學的學生排在最前面方便老師查看最近一屆數據。如果想回到全部列表重新執(zhí)行 model-select() 并把模型換回 QSqlTableModel 即可。3.2.1 模糊查詢代碼與參數說明bindValue 綁定參數的做法是為防止 SQL 注入畢設中直接拼字符串也能運行但不建議。用占位符后即使關鍵字包含單引號也不會破壞 SQL 結構。查詢結果為空時QTableView 會顯示空行不會報錯需要另一段判斷邏輯提示“沒有找到匹配記錄”可以使用 query.next() 判斷。關于列頭顯示QSqlQueryModel 默認列名來自數據庫字段名直接顯示英文不好看。給列設置別名更有效查詢中用 AS 重命名例如 SELECT student_id AS 學號, name AS 姓名。但 QTableView 綁定模型后列名會直接變成中文若通過 setHeaderData 會失效應當優(yōu)先選擇 SQL 別名方案。系統(tǒng)常態(tài)下默認表格顯示 student 表全部內容搜索時替換成查詢模型搜索結束后重新加載。3.3 信號槽與數據刷新一致性多個窗口共用同一個數據庫連接使用全局單例管理連接系統(tǒng)如果包含“學生信息管理”和“成績錄入”兩個窗口每個窗口各自調用 addDatabase 會創(chuàng)建多個物理連接浪費資源且容易踩并發(fā)修改的問題。合理設計是讓整個程序共享一個 QSqlDatabase。class DbManager { public: static QSqlDatabase getConnection() { if (QSqlDatabase::contains(main_conn)) { return QSqlDatabase::database(main_conn); } QSqlDatabase db QSqlDatabase::addDatabase(QMYSQL, main_conn); db.setHostName(127.0.0.1); db.setPort(3306); db.setDatabaseName(student_db); db.setUserName(root); db.setPassword(your_password); if (!db.open()) { qDebug() open failed: db.lastError().text(); } return db; } };利用 Qt 的連接池特性每次通過 QSqlDatabase::database(main_conn) 獲取同一個連接句柄不需要重復打開。在子窗口對數據庫做出改變后主窗口需要刷新時直接 model-select()但要注意該操作必須是在同一個連接對象上執(zhí)行。事務操作時兩個窗口同時提交后提交的一方可能會覆蓋前面的記錄畢設中減少這種風險的辦法是提交前都重新 select 一次。4. 發(fā)布與常用排錯場景Qt 程序在另一臺電腦上運行時的常見問題以及 MySQL 驅動缺失的解決步驟能把系統(tǒng)在開發(fā)機上跑通只是第一步交畢設或者給老師演示時經常換到一臺沒有 Qt 環(huán)境的電腦上問題會在發(fā)布環(huán)節(jié)集中爆發(fā)。打包過程有固定的動作不能只復制 exe。4.1 用 windeployqt 工具生成 exe 的依賴文件注意 Qt 版本與編譯器配套并把 MySQL 的 dll 一起放進部署目錄發(fā)布流程從 Release 構建開始。打開 Qt 提供的命令行工具例如 “Qt 5.15.2 (MSVC 2019 64-bit)”進入 Release 輸出目錄。運行windeployqt StudentSystem.exewindeployqt 會遞歸復制 Qt 運行時、平臺插件、樣式插件。但有兩個東西它不會自動處理一是 MySQL 驅動二是 libmysql.dll。手動復制時從 Qt 安裝路徑下找到 plugins/sqldrivers/qsqlmysql.dll復制到發(fā)布目錄的 sqldrivers 子目錄下。然后從 MySQL 安裝目錄的 lib 下復制 libmysql.dll放到 exe 同級目錄。兩個文件缺一不可否則最終運行時會出現 “Driver not loaded”。常見錯誤清單如下錯誤現象原因處理方法程序啟動提示缺少 Qt5Core.dllwindeployqt 未成功或平臺插件缺失重新執(zhí)行 windeployqt確認生成 platforms 目錄QSqlDatabase: QMYSQL driver not loaded缺少 qsqlmysql.dll 或 libmysql.dll檢查 sqldrivers 目錄及 libmysql.dll 位置Access denied for user ‘root’密碼錯誤或 root 權限限制核對 MySQL 賬號密碼確認 host 為 127.0.0.1Unknown database未建庫或庫名不匹配在 MySQL 中執(zhí)行建庫腳本Can’t connect to MySQL serverMySQL 服務未啟動或端口被防火墻攔截打開服務管理器啟動 MySQL80放行 3306windeployqt 生成的目錄里還包括 translations 文件夾保留它用于 qt 國際化支持。如果程序界面顯示中文但按鈕文字變成亂碼多半是源文件編碼問題需要將 .cpp 文件另存為 UTF-8 with BOM。4.2 中文亂碼的兩處根源外部數據源編碼與 Qt 內部顯示編碼建議統(tǒng)一為 UTF8Qt 5 內部使用 Unicode中文處理本身沒大問題。亂碼通常出在三個環(huán)節(jié)源文件編碼、數據庫表字符集、控制臺輸出。源文件用 GB2312 或 ANSI 保存時編譯器 VS 會按本地代碼頁解釋導致中文字符串顯示為“鎴戠殑”之類的內容。解決方案是統(tǒng)一用 UTF-8 with BOM并添加預處理指令查看編譯器警告。數據庫表字符集配置為 utf8mb4 后Qt 連接時不需要額外轉換。但需要注意MySQL 連接層默認字符集可能與表格不一致?？梢栽谶B接后執(zhí)行SET NAMES utf8mb4;這條語句可以放在連接成功后執(zhí)行也可以作為一條 QSqlQuery 調用。如果還是亂碼檢查 Windows 區(qū)域設置是否使用了 Unicode UTF-8在“控制面板-區(qū)域”中勾選“Beta使用 Unicode UTF-8 提供全球語言支持”后重啟很多詭異的亂碼問題會消失。畢設中不建議通過 QString::fromLocal8Bit 來處理那只是掩蓋了編碼不一致的根源。5. 學生信息管理系統(tǒng)的進階用法主要有三條打包、加密連接配置與報表輸出。這三項會讓系統(tǒng)從能用變?yōu)楹糜卯敾A增刪改查完成可以加入一些能夠提升完成度的功能同時保持代碼量可控。下面三個方向任選其一都能讓系統(tǒng)觀感有明顯提升。5.1 把密碼加密存儲到配置文件中不再寫在代碼里每次運行時讀取配置文件代碼中寫死數據庫密碼在開發(fā)時方便但系統(tǒng)一旦給老師或同學演示源碼會被看到數據庫密碼就泄露了。常見做法是把連接參數移到一個 ini 文件程序啟動時讀取。另一個層面本地配置文件本身就是明文所以還需要對密碼做簡單混淆。使用 QCryptographicHash 對密碼進行 SHA-256 加鹽處理然后保存哈希值連接數據庫時把用戶輸入的密碼做同樣處理比對哈希是否一致這樣可以保護密碼不被直接讀出來而真正用于連接數據庫的密碼密鑰可以用 macOS 鑰匙串或 Windows 憑據管理器存儲但實現成本較高不建議在畢設中引入?？尚械姆绞绞翘峁┮粋€配置文件里面存放 MySQL 用戶名和密碼。使用 QSettings 讀取QSettings settings(config.ini, QSettings::IniFormat); settings.beginGroup(mysql); QString host settings.value(host, 127.0.0.1).toString(); int port settings.value(port, 3306).toInt(); QString user settings.value(user, root).toString(); QString password settings.value(password).toString(); settings.endGroup();參數后面的默認值省去了手工填寫的步驟host 默認 127.0.0.1port 默認 3306。密碼字段在部署時由人工寫入。配置文件與 exe 放在同一目錄程序啟動時如果找不到可以直接用寫死的默認值再給出“配置文件缺失使用默認連接參數”的提示這樣能兼容不同使用環(huán)境。5.2 導出一份包含學生信息和成績統(tǒng)計的 Excel 或 PDF 報表能夠提升系統(tǒng)完成度在 Qt 中輸出 Excel 有幾種路徑若目標機器安裝了 Office可以用 QAxObject 操作 Excel COM 組件編程靈活但依賴 Office如果不依賴 Office可以使用 CSV 文件Excel 也能打開通用性好且代碼量少。生成 CSV 的核心是讀取數據庫內容并組合寫文件QFile file(students_report.csv); if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) { return; } QTextStream out(file); out.setEncoding(QStringConverter::Utf8); out 學號,姓名,專業(yè),班級\n; QSqlQuery query(db); query.exec(SELECT student_id, name, major, class_name FROM student); while (query.next()) { out query.value(0).toString() , query.value(1).toString() , query.value(2).toString() , query.value(3).toString() \n; } file.close();上述代碼使用 QTextStream 并設置 UTF-8 編碼生成的 CSV 文件用 Excel 打開時中文能正常顯示。如果把內容變成績統(tǒng)計SQL 中可以用 GROUP BY 和 AVG 計算各課程平均分然后把結果寫入 CSV 另一列。如果需要真正的圖表展示推薦 Qt Charts 模塊在 .pro 文件里添加 QT charts然后使用 QChart 顯示柱狀統(tǒng)計圖能直觀展示各課程平均分差異。5.3 給系統(tǒng)加上一份自檢腳本啟動時驗證 MySQL 驅動、連接與數據表完整性減少現場排錯時間系統(tǒng)接手另一臺電腦運行前任何人都無法預判目標環(huán)境的 MySQL 服務是否啟動、驅動是否完整。因此程序啟動后立即執(zhí)行一次自檢錯誤信息直接彈窗或寫入日志能省去很多現場排查時間。自檢順序先驅動、再連接、后檢查表void MainWindow::selfCheck() { if (!QSqlDatabase::isDriverAvailable(QMYSQL)) { QMessageBox::critical(this, 驅動錯誤, QMYSQL 驅動不可用請檢查 Qt 插件目錄); return; } QSqlDatabase db DbManager::getConnection(); if (!db.isOpen()) { QMessageBox::critical(this, 連接失敗, db.lastError().text()); return; } QSqlQuery query(db); if (!query.exec(SELECT COUNT(*) FROM student)) { QMessageBox::critical(this, 表缺失, student 表不存在請執(zhí)行建表腳本); return; } }isDriverAvailable 檢查的是當前 Qt 編譯是否包含了 MySQL 驅動連接失敗再檢查 MySQL 服務狀態(tài)表缺失則提示執(zhí)行建表腳本。自檢函數在構造函數中使用 QTimer::singleShot(0, this, MainWindow::selfCheck) 調用讓界面先顯示出來然后再進行耗時操作。狀態(tài)欄可顯示最終通過自檢的學生數量如“共加載 128 條學生記錄”用戶一眼就知道數據是否完整。這套流程之后即使在另一臺電腦上部署最多只需要調整 config.ini 里的密碼剩下的錯誤會直接指出具體瓶頸減少無頭緒的日志翻找。本文還有配套的精品資源點擊獲取