CGI 程序訪問報 502 Bad Gateway：服務端兼容性問題排查

現象

自建 Web 頁面調用自編譯的 .cgi 程序（C 語言編譯生成），每次跳轉 CGI 均報錯 502 Bad Gateway，提示「CGI 不兼容」。

錯誤本質

502 屬於服務端錯誤，Web 服務器（Nginx/Apache/Lighttpd 等）作為網關/代理，無法從上游（CGI 進程/FastCGI 進程）獲得合法響應。提示「CGI 不兼容」通常意味著：

1. CGI 可執行文件架構不匹配：服務器運行在 64 位環境，CGI 程序編譯為 32 位（或反之），導致無法加載執行。
2. 缺少動態鏈接庫依賴：CGI 程序依賴特定版本的 glibc、libstdc++、數據庫客戶端庫等，服務器環境中缺失或版本不兼容。
3. CGI 協議輸出格式錯誤：程序未按 CGI 規範輸出 Content-Type: text/html\r\n\r\n 等 HTTP 頭，或輸出到 stderr 導致服務器判定失敗。
4. 權限/路徑問題：服務器進程用戶（如 www-data）無執行權限、工作目錄錯誤、shebang 指向的解釋器不存在（若為腳本）。
5. FastCGI/SCGI 配置錯誤：若用 FastCGI 模式，socket 路徑、進程管理器配置錯誤。

排查步驟

1. 查看服務器錯誤日誌（/var/log/nginx/error.log、/var/log/apache2/error.log），搜索 502、cgi、exec 關鍵字，通常有具體失敗原因（如 execve() failed: Exec format error）。
2. 驗證 CGI 程序架構：
   file your.cgi → 輸出應包含 ELF 64-bit LSB executable, x86-64（匹配服務器架構）。
3. 檢查動態依賴：
   ldd your.cgi → 確保所有 => 指向的庫文件存在，無 not found。
4. 命令行直接測試：
   切換到服務器進程用戶 su -s /bin/bash www-data，執行 ./your.cgi，觀察是否正常輸出 HTML 及 HTTP 頭。若報 Exec format error 或 library not found，即定位到架構/依賴問題。
5. 檢查 CGI 輸出格式：程序必須先打印 HTTP 頭，再空行，再內容：
   printf("Content-Type: text/html\r\n\r\n");
printf("<html>...</html>");
6. 確認服務器 CGI 配置：
   Apache: Options +ExecCGI, AddHandler cgi-script .cgi, ScriptAlias 目錄正確。
   Nginx: 需配合 fcgiwrap 或 spawn-fcgi 運行 CGI，檢查 fastcgi_pass 指向的 socket 正常。

常見修復

• 重新編譯：gcc -o your.cgi your.c -static（靜態鏈接消除依賴）或在目標服務器環境下編譯。
• 安裝缺失庫：apt-get install libc6-dev 等。
• 修正權限：chmod 755 your.cgi，目錄可遍歷。
• 修正輸出：確保 Content-Type 頭正確且以 \r\n\r\n 結束。

502 錯誤**一定是服務端配置或 CGI 程序運行環境問題**，而非前端頁面代碼。憑藉日誌與命令行測試，可快速定位至架構不匹配、缺庫、輸出格式或權限四大類根因。