// PostgreSQL 錯誤參考

PostgreSQL 08006:連線失敗

使用期間與伺服器的連線中斷。伺服器處理程序已結束、重新啟動或被終止,或網路中斷了閒置的連線。

SQLSTATE
08006
名稱
connection_failure
類別
連線異常
錯誤訊息
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

它的意義

08006 是客戶端的代碼:已建立的連線在通訊途中失效時,驅動程式就會回報。伺服器無法透過已失效的連線傳回錯誤,所以訊息來自客戶端函式庫。採用 libpq 的工具(psql、psycopg)會印出上方的訊息,PgJDBC 則回報 SQLSTATE 08006 並附上 An I/O error occurred while sending to the backend.

伺服器記錄通常會說明原因:後端當掉後重新啟動、記憶體不足遭系統終止、管理員終止了工作階段,或者防火牆或負載平衡器悄悄切斷閒置的 TCP 連線時,什麼記錄都沒有。

常見原因

  • 該工作階段的伺服器處理程序當掉或遭終止,通常是作業系統在記憶體不足時終結程序所致,這會讓 PostgreSQL 重新啟動所有工作階段。
  • 伺服器已重新啟動或完成容錯移轉。
  • 防火牆、NAT 閘道或雲端負載平衡器中斷了閒置時間超過其逾時設定的連線。
  • 工作階段被終止,原因是 pg_terminate_backend() 或閒置逾時,而用戶端要到下一次查詢才會察覺。

如何修正

  1. 檢查失敗發生時間附近的伺服器記錄,尋找 terminated by signal, server process ... was terminated,或是一次重新啟動。

  2. 如果閒置連線被網路中斷,請在伺服器(或客戶端)啟用 TCP keepalive,讓連線永遠不會被視為閒置。

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. 設定連線池在發放連線前先驗證或回收,並在安全無虞時於全新連線上將操作重試一次。

  4. 如果伺服器記憶體耗盡,請找出是哪個查詢用的,並調低 work_mem 或同時連線的數量。

相關錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。