如何通过SQLSTATE错误码获取MySQL对应错误文本？

刚好之前做项目时遇到过类似的场景——把查询逻辑和错误展示拆分到两个页面，只靠SQLSTATE码拿对应错误文本，确实挺实用的。这里给你两个可行的方案：

方案1：手动维护错误码映射表（推荐） #

因为MySQL的SQLSTATE错误码是遵循ANSI SQL标准的，常用码对应的错误文本基本固定，你可以把需要的错误码整理成一个映射数组，然后封装成函数直接调用，完全不需要依赖数据库连接，适合页面B无法访问数据库的场景。

举个PHP实现的例子（你可以根据自己的开发语言调整逻辑）：

function get_sqlstate_error_text($sqlstate) {
    // 这里可以根据业务需求补充更多常用的SQLSTATE码
    $sqlstate_error_map = [
        '42S02' => 'Base table or view not found',
        '42S22' => 'Column not found',
        '23000' => 'Integrity constraint violation',
        '1062'  => 'Duplicate entry', // 若你拿到的是MySQL原生错误码也可加入
        '40001' => 'Deadlock found when trying to get lock',
    ];
    
    // 找不到对应码时返回默认提示
    return $sqlstate_error_map[$sqlstate] ?? 'Unknown database error';
}

注意：你可以参考MySQL官方的SQLSTATE错误列表补充更多映射关系，也能把错误文本改成更贴合业务的表述（比如翻译成中文）。

方案2：利用MySQL内置系统表（如果页面B能访问数据库） #

如果页面B可以连接到MySQL数据库，哪怕拿不到最后执行的查询，也可以通过查询系统表INFORMATION_SCHEMA.SQLSTATE_MESSAGES来获取标准错误文本（这个表从MySQL 8.0版本开始提供）。

你可以封装一个查询函数，比如：

function get_sqlstate_error_text($sqlstate, $pdo_connection) {
    try {
        $stmt = $pdo_connection->prepare("
            SELECT MESSAGE_TEXT 
            FROM INFORMATION_SCHEMA.SQLSTATE_MESSAGES 
            WHERE SQL_STATE = :sqlstate 
            AND LANGUAGE = 'en'
        ");
        $stmt->bindParam(':sqlstate', $sqlstate);
        $stmt->execute();
        
        $result = $stmt->fetch(PDO::FETCH_ASSOC);
        return $result['MESSAGE_TEXT'] ?? 'Unknown database error';
    } catch (PDOException $e) {
        return 'Failed to retrieve error message';
    }
}

注意：这个方法需要确保数据库账号有访问INFORMATION_SCHEMA的权限，调整LANGUAGE参数还能获取不同语言的错误文本（比如'zh'）。

额外提示 #

SQLSTATE的前两位代表错误类别，比如42开头属于语法或数据库对象相关错误，23开头属于完整性约束错误，如果需要更通用的提示，也可以按类别做模糊匹配，但要精确错误文本的话，还是精确映射单个码更可靠。

内容的提问来源于stack exchange，提问作者mondersky