Django 運行過程中，數據庫連接的健康狀態直接影響應用的穩定性和數據訪問準確性。長時間空閑的數據庫連接經常因外部機制被回收，進而引發數據查詢異常和返回無效結果。

本文圍繞 Django 中數據庫連接長時間空閑導致的連接失效問題，介紹相關的背景成因，并給出配置與中間件層面的解決辦法，包括如何自動檢測與維護數據庫連接的可用性，保障項目高可用和穩定運行。

應用場景

Django 在運行過程中會維護自己的數據庫連接池。如果連接被長時間占用或者在網絡上處于空閑狀態，有些數據庫中間件、負載均衡器、云數據庫自身的連接管理機制（比如超時、空閑回收）會自動斷開這些連接。Django 并不會主動發現已有的連接已經失效，依然會用“假裝還活著”的連接去請求數據。這時候，實際查詢沒有真正訪問到數據庫，ORM 返回 None，而不是拋出數據庫連接異常。這種情況下，數據庫層的數據并沒有問題，只是 Django 進程用的連接已經失效，直到服務重啟，連接池被清空并重新建立連接，才又能正常查到數據。

PaymentOrderFinance.objects.filter(id=123).first()

這種現象背后的根本原因，通常與數據庫連接的“長時間空閑失效”有關。

• 云數據庫有連接超時或空閑連接回收策略，斷掉了長時間未活躍的連接。
• 網絡不穩定，導致連接短暫丟失又自動恢復，但 ORM 沒有感知到。
• 負載均衡層或者中間件（比如 ProxySQL、云數據庫代理層）清理了“空閑連接”。

實現方式

可以在 Django 的數據庫配置中添加 CONN_MAX_AGE（連接最大存活時間），比如設置為 60 秒或者更短，讓 Django 自動定期重建連接，減少連接失效的概率。還可以用數據庫健康檢查機制，或者用中間件對查詢失敗做重試處理。
例如：

DATABASES = {'default': {# ...'CONN_MAX_AGE': 60,  # 單位為秒}
}

這樣 Django 會自動在每次查詢時判斷連接是否存活，超過設置時間會重連數據庫，從而避免這種“假死連接”導致的 None 返回。

并項目下新建中間件 db_keepalive.py 定義一個 Django 中間件類 EnsureDbConnectionMiddleware，用于每次 HTTP 請求到來時自動檢測并維護數據庫連接的可用性。具體來說，中間件在請求處理流程的最前面調用 connection.close_if_unusable_or_obsolete()，確保如果當前數據庫連接已經失效或變得不可用，就會自動關閉這個連接，避免后續操作因連接異常導致報錯。這樣可以減少數據庫連接因長時間空閑或網絡問題導致的不可用情況，保證后續每一次數據庫訪問時連接狀態都是健康的。這個中間件適用于需要高可用、穩定數據庫連接的場景，比如長時間運行的 Web 服務，能夠有效預防由于數據庫連接斷開引起的異常。

# coding:utf-8
'''
@IDE     ：PyCharm 
@Project ：ManageBak-HS.py 
@File    ：db_keepalive.py
@Author  ：Mr數據楊
@Date    ：2025/7/25
@Desc    : 
'''from django.db import connectionclass EnsureDbConnectionMiddleware:def __init__(self, get_response):self.get_response = get_responsedef __call__(self, request):# 每次請求自動檢測數據庫連接connection.close_if_unusable_or_obsolete()response = self.get_response(request)return response

在 Django 項目的 settings.py 文件的 MIDDLEWARE 配置中，將這個中間件類添加到合適的位置后，即可實現對所有請求的數據庫連接健康管理，提升系統的健壯性和穩定性。

MIDDLEWARE = ["dvadmin.utils.middleware.ApiLoggingMiddleware", # 必須第一個.......
]

總結

數據庫連接因空閑被回收引發的失效現象，常見于云數據庫、負載均衡或網絡環境下，容易導致數據查詢異常。通過合理設置 CONN_MAX_AGE 參數和添加數據庫連接健康檢測中間件，可以有效降低“假死連接”產生的概率，提升查詢準確性和系統穩定性。

針對生產環境，建議結合實際場景持續優化數據庫連接管理策略，關注不同數據庫平臺的連接處理細節。未來，結合自動化健康監測與智能重連機制，有望進一步提升 Django 應用的高可用能力，減少因底層連接斷開帶來的潛在風險。