Qt 資料庫操作錯誤捕獲：sql.lastError() 使用指南

核心 API

QSqlQuery::lastError() 返回 QSqlError 物件，包含錯誤類型、數據庫原文、驅動文本等詳細資訊。

標準檢查模式

QSqlQuery query;
bool ok = query.exec("INSERT INTO user(name) VALUES('test')");
if (!ok) {
    QSqlError err = query.lastError();
    qDebug() << "SQL Error:" << err.driverText()      // 驅動層錯誤（如 "Duplicate entry")
             << "| DB Text:" << err.databaseText()    // 數據庫原文
             << "| Type:" << err.type();              // 錯誤分類
    // 可根據 err.number() 進行具體處理（如 1062 為主鍵衝突）
}

常見錯誤類型對照

進階技巧

• 開啟 QSqlDatabase::setConnectOptions("MYSQL_OPT_RECONNECT=1") 自動重連。
• 使用 QSqlQuery::prepare() + bindValue() 防注入並獲得更清晰的錯誤定位。
• 封裝通用 execWithLog() 函式，統一記錄 SQL 文本、耗時、錯誤碼，便於審計與排查。