萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux C 程式設計 errno 錯誤碼完整對照表與處理最佳實務

C 語言呼叫系統呼叫/函式庫函數失敗時,會設定全域變數 errno (需 #include ) 指示錯誤原因。掌握常見錯誤碼與正確處理模式,能大幅提升除錯效率。

三種取得錯誤訊息的標準方式

  1. perror():輸出至 stderr,格式 "自訂字串: 系統錯誤訊息"。
  2. strerror():回傳錯誤訊息字串,可自行格式化輸出。
  3. printf("%m"):GNU 延伸格式,直接插入 strerror(errno) 結果。
#include 
#include 
#include 

FILE *fp = fopen("nonexist.txt", "r");
if (!fp) {
    perror("fopen failed");                    // 方式 1
    fprintf(stderr, "fopen failed: %s\n", strerror(errno)); // 方式 2
    printf("fopen failed: %m\n");              // 方式 3 (GNU)
}

特殊情況:h_errno

網路函數 gethostbyname()、gethostbyaddr() 錯誤碼存於 h_errno,需用 herror() 或 hstrerror() 處理,不可用 perror/strerror。

struct hostent *h = gethostbyname("example.com");
if (!h) {
    herror("gethostbyname"); // 正確
    // perror("gethostbyname"); // 錯誤:讀取 errno 而非 h_errno
}

Linux 2.4/2.6/3.x/4.x/5.x 常見 errno 定義 (節選)

宏定義值描述
EPERM1操作不被允許 (非 root/權限不足)
ENOENT2檔案或目錄不存在
ESRCH3指定行程不存在
EINTR4系統呼叫被中斷 (訊號)
EIO5I/O 錯誤 (硬體故障)
ENXIO6裝置/位址不存在
E2BIG7參數列表過長
ENOEXEC8執行檔格式錯誤
EBADF9壞的檔案描述符
ECHILD10無子行程
EAGAIN / EWOULDBLOCK11資源暫時不可用 (非阻塞 I/O)
ENOMEM12記憶體不足
EACCES13權限被拒絕
EFAULT14錯誤的位址 (使用者空間指標無效)
ENOTBLK15需要區塊裝置
EBUSY16裝置或資源忙碌
EEXIST17檔案已存在
EXDEV18跨裝置連結
ENODEV19無此裝置
ENOTDIR20非目錄
EISDIR21是目錄
EINVAL22無效參數
ENFILE23系統檔案表滿
EMFILE24行程開啟檔案過多
ENOTTY25非終端機裝置
ETXTBSY26文字檔忙碌 (執行中檔案寫入)
EFBIG27檔案過大
ENOSPC28裝置無剩餘空間
ESPIPE29非法 seek (管道/通訊端)
EROFS30唯讀檔案系統
EMLINK31連結數過多
EPIPE32管道破裂 (寫入無讀端管道)
EDOM33數學函數定義域錯誤
ERANGE34數學函數結果超出範圍
EDEADLK35資源死結會發生
ENAMETOOLONG36檔案名稱過長
ENOLCK37無可用記錄鎖
ENOSYS38功能未實作
ENOTEMPTY39目錄非空
ELOOP40符號連結層級過深
ENOMSG42無所需類型訊息
EIDRM43識別碼已移除
ENOTSOCK88非 Socket
EDESTADDRREQ89需指定目的地址
EMSGSIZE90訊息過大
EPROTOTYPE91協議類型錯誤
ENOPROTOOPT92協議選項不存在
EPROTONOSUPPORT93協議不支援
ESOCKTNOSUPPORT94Socket 類型不支援
EOPNOTSUPP95操作不支援
EPFNOSUPPORT96協議族不支援
EAFNOSUPPORT97地址族不支援
EADDRINUSE98地址已在使用
EADDRNOTAVAIL99地址不可用
ENETDOWN100網路不可用
ENETUNREACH101網路不可達
ENETRESET102連線被網路重置
ECONNABORTED103連線被軟體中止
ECONNRESET104連線被對端重置
ENOBUFS105緩衝區空間不足
EISCONN106已連線
ENOTCONN107未連線
ESHUTDOWN108連線已關閉
ETOOMANYREFS109參考過多
ETIMEDOUT110連線逾時
ECONNREFUSED111連線被拒絕
EHOSTDOWN112主機宕機
EHOSTUNREACH113主機不可達
EALREADY114操作已在進行中
EINPROGRESS115操作進行中
ESTALE116NFS 檔案控制塊過期
EREMOTE117對象在遠端

最佳實務建議

  1. 永遠檢查回傳值,失敗時立即儲存 errno (後續函數呼叫會覆蓋)。
  2. 使用 strerror(errno) 記錄日誌,保留上下文 (函數名、參數、時間戳)。
  3. 區分 可重試錯誤 (EAGAIN, EINTR, EWOULDBLOCK) 與 永久失敗 (ENOENT, EACCES, EPERM),前者應迴圈重試/回退,後者應上報/終止。
  4. 網路程式務必處理 ECONNRESET, ETIMEDOUT, EHOSTUNREACH 並實作指數退避重連。
  5. 多執行緒程式:errno 為執行緒區域變數 (TLS),各緒互不干擾 (需編譯器/庫支援,現代 glibc/pthreads 均支援)。
  6. 使用 strace -f -e trace=all ./program 追蹤系統呼叫與 errno 回傳,快速定位問題。

線上查詢工具

  • man 3 errno、man 2 intro (系統呼叫錯誤碼)。
  • errno -l (moreutils 套件) 列出所有定義。
  • https://errno.dayspring.com/、https://man7.org/linux/man-pages/man3/errno.3.html
copyright © 萬盛學電腦網 all rights reserved