Linux curl遇到404仍回傳成功:傳輸成功與HTTP失敗怎麼分
排程用curl下載API資料,伺服器明明回傳404,後面的工作卻照常執行。先別急著把錯誤歸到shell:curl預設把「完成HTTP交換」視為成功,資源不存在則是HTTP回應裡的另一層結果。兩者分開看,才能決定程式該停下來,還是保留錯誤內容供查閱。 先分清退出碼與HTTP狀態碼 shell讀到的退出碼是本次curl程序的結果;HTTP狀態碼由伺服器放在回應中。成功連線、送出請求並收到完整404回應,可以同時得到HTTP 404與程序退出碼0。這不表示檔案存在,也不表示API處理了你要做的事。 反過來,DNS解析失敗或連線中斷時,curl也可能根本沒拿到HTTP回應。把所有非零退出碼都寫成「API回傳404」,會把網路問題與應用程式錯誤混在一起。診斷時至少保留退出碼、HTTP狀態,以及適合公開的錯誤內容;不要把憑證或完整敏感回應直接印到共用紀錄。 同一個404,三種選項的結果不同 下面的對照使用curl 8.21.0與自有隔離Python HTTP服務。服務的/missing固定回傳404和一小段JSON,/ok則回傳200。服務沒有對外開放連接埠,也沒有操作真實API;這個案例只用來確認命令行的錯誤處理。 default HTTP 404 exit 0 保留錯誤正文 --fail HTTP 404 exit 22 不輸出錯誤正文 --fail-with-body HTTP 404 exit 22 保留錯誤正文 --fail-with-body HTTP 200 exit 0 保留成功正文 若後面的步驟只看退出碼,預設命令就會放行404。加入--fail後,這次404變成退出碼22;加入--fail-with-body也得到22,但仍可讀到伺服器傳回的錯誤說明。兩個選項解決的是不同需求,並不是正文越少就一定越安全。 --fail-with-body從curl 7.76.0加入,舊機器先跑curl --version核對。沒有這個選項時,不要直接照抄後宣稱相同效果;可以先用--fail,或另行保存HTTP狀態再依服務契約判斷。不同系統的curl可能帶不同版本,不能只靠作業系統名稱猜測。 需要錯誤JSON時,用fail-with-body並立即保存退出碼 若要在自己的開發環境重現,可先啟動下面這個Python測試服務,再從另一個終端執行curl。它只監聽本機位址;不要把示範服務放到正式網站,也不要改成對外監聽來方便測試。執行時保持服務終端開著,結束後用Ctrl+C停止。 from http.server import BaseHTTPRequestHandler, HTTPServer class Demo(BaseHTTPRequestHandler): def do_GET(self): ok = self.path == "/ok" body = (b'{"ok":true}\n' if ok else b'{"error":"not found"}\n') self.send_response(200 if ok else 404) self.send_header("Content-Type", "application/json") self.send_header("Content-Length", str(len(body))) self.end_headers() self.wfile.write(body) HTTPServer(("127.0.0.1", 8080), Demo).serve_forever() 把程式存成demo.py,用python3 demo.py執行。若連接埠已被自己的其他工作占用,就同時修改服務與curl網址的連接埠,不要停止用途不明的程序。先請求/ok確認回應200,再改成/missing。這樣能分清服務未啟動的連線失敗,與服務正常回覆的404。 示範沒有驗證身分、資料庫或第三方服務,狀態由路徑直接決定。它適合檢查下載腳本對HTTP錯誤的分支,卻不能證明你的正式API一定使用相同錯誤格式。移到真實服務時,仍要查它的文件:有些API回傳JSON錯誤,有些回傳HTML,直接把後者交給JSON解析器只會產生另一個錯誤。 url="http://127.0.0.1:8080/missing" curl...
