FastAPI PostgreSQL连接校验异常：断开数据库仍返回200而非503

问题原因 #

• SQLAlchemy默认的连接池会保留已建立的有效连接，当你通过pgAdmin断开服务器时，应用侧连接池内可能还存在未失效的旧连接。此时调用test_db_connection会复用这些连接，导致SELECT 1执行成功，接口返回200。
• 从终端日志可见，SELECT 1执行过程无异常，说明当前使用的连接仍处于有效状态，未检测到数据库服务的断开。

解决方案 #

方案1：启用连接池预检测（推荐）

修改database.py中的create_engine，添加pool_pre_ping=True参数，让SQLAlchemy每次从连接池获取连接前，自动发送测试查询验证连接有效性：

from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
from sqlalchemy.sql import text
from dotenv import load_dotenv
import os
    
load_dotenv()

# 启用连接预检测，自动验证连接有效性
engine = create_engine(url=os.getenv('DATABASE_URL'), echo=True, pool_pre_ping=True)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

def test_db_connection():
    try:
        db = SessionLocal()
        db.execute(text("SELECT 1"))
        db.close()
        return True
    except Exception as e:
        print(e)
        return False

方案2：直接使用引擎创建新连接测试

绕过连接池，每次创建全新连接验证数据库状态，确保检测结果实时准确：

def test_db_connection():
    try:
        # 直接创建新连接，不复用连接池中的旧连接
        with engine.connect() as conn:
            conn.execute(text("SELECT 1"))
        return True
    except Exception as e:
        print(e)
        return False

额外优化建议

• 确认你通过pgAdmin操作的是停止PostgreSQL服务，而非仅断开pgAdmin自身与数据库的连接。若只是关闭pgAdmin连接窗口，数据库服务仍在运行，应用自然能正常连接。
• 可搭配pool_recycle参数设置连接最大存活时间，避免闲置连接失效后无法被检测到：

engine = create_engine(
    url=os.getenv('DATABASE_URL'),
    echo=True,
    pool_pre_ping=True,
    pool_recycle=300  # 每5分钟自动回收连接
)

内容的提问来源于stack exchange，提问作者lolo