DevToolPal
繁
5xx 伺服器錯誤

500 Internal Server Error

伺服器內部錯誤

意義

伺服器遇到非預期的狀況，無法完成請求。這是伺服器端錯誤的通用狀態碼。

常見原因

  • 應用程式碼中未處理的例外或錯誤
  • 設定錯誤，例如 .htaccess 有誤或缺少環境變數
  • 資料庫或相依服務故障，卻沒有對應到更合適的狀態碼

解決方法

用戶端或訪客

稍後重試；若持續發生，回報發生時間以及回應中的請求 ID。

網站或 API 的維護者

查看應用程式與伺服器的錯誤紀錄，修正例外；原因明確時回傳更具體的狀態碼（502、503、504）。

回應範例

HTTP/1.1 
HTTP/1.1 500 Internal Server Error
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Something went wrong. Request id: 01J9Z6Q4K2."
}

規範

RFC 9110 §15.6.1

常見問題

› 如何找出 500 的原因？

查看請求發生時伺服器或應用程式錯誤紀錄中的堆疊追蹤；只在開發環境啟用除錯模式。

› .htaccess 檔案會造成 500 嗎？

會。.htaccess 中的語法錯誤或未知指令會讓 Apache 回傳 500。