MySQL 錯誤碼快速查詢兩大官方渠道：文檔與 perror 工具

MySQL 錯誤碼快速查詢兩大官方渠道：文檔與 perror 工具

遇到 MySQL 錯誤碼（如 1062、1105、1267、13）需快速知曉含義。本文介紹兩種官方權威查詢方式：在線文檔與本地 perror 命令，並附帶常見錯誤碼速查表。

方式一：官方在線文檔（最新版）

MySQL 8.0 Error Messages Reference
覆蓋 Server、Client、Global、SQLState 所有錯誤碼，含詳細描述與處理建議。

方式二：本地 perror 命令（離線首選）

MySQL 安裝包自帶 perror 工具，可直接翻譯系統/存儲引擎錯誤碼。

# 查找 perror 路徑
which perror
# /usr/bin/perror

# 或 find 定位
find / -name perror
# /opt/mysql/mysql-5.5.39-linux2.6-i686/bin/perror
# /usr/bin/perror

# 使用示例
perror 13
# OS error code 13: Permission denied

perror 1062
# MySQL error code 1062: Duplicate entry '%s' for key '%s'

perror 1105
# MySQL error code 1105: Unknown error

常見錯誤碼速查表

進階：錯誤碼分類

• 1xxx：Server 核心錯誤
• 2xxx：Client 通信錯誤
• 3xxx：SQLState 標準錯誤
• OS errno：系統調用失敗（需 perror 翻譯）

最佳實踐

1. 日誌中見到數字錯誤碼，**優先 perror 秒級定位**
2. 需查看詳細描述/處理建議，**查閱官方文檔**
3. 應用層異常處理捕獲 SQLException.getErrorCode() 映射業務錯誤碼