FastAPI容器在SQL Server宕机时频繁启停问题求助

问题根源分析 #

你遇到的容器频繁启停、健康端点无法访问的问题，核心原因并非异常捕获失效，而是以下几点：

• 每次请求都创建新的SQLAlchemy引擎，且未设置数据库连接超时，请求会长时间阻塞，耗尽容器CPU/内存资源，最终被Docker健康检查或OOM killer终止
• 全局异常处理器可能未覆盖SQLAlchemy或pymssql底层的阻塞级错误，未捕获的异常拖垮了进程
• 健康端点可能隐性依赖数据库连接，数据库宕机时健康检查失败，触发容器重启

具体修复步骤 #

1. 复用SQLAlchemy引擎，避免重复创建

create_engine是重量级操作，每次请求创建会快速耗尽资源，应全局初始化一次，并配置超时与连接池参数：

# 全局初始化引擎，仅执行一次
connection_string = f"mssql+pymssql://(creds)...."
engine = create_engine(
    connection_string,
    connect_args={"timeout": 5},  # 设置5秒连接超时，避免无限阻塞
    pool_pre_ping=True,  # 自动检测失效连接
    pool_recycle=300  # 每5分钟回收连接，避免失效连接堆积
)

@router.get("/abc")
async def serve_abc(request: Request):
    try:
        ip = request.client.host
        user_data = get_user_data(ip)
        return user_data
    
    except Exception as e:
        logger.error(f"获取用户数据失败: {str(e)}")
        return basic_data
         
def get_user_data(ip: str):
    sql_query = "....."
    
    try:
        with engine.connect() as conn:
             df = pd.read_sql(sql_query, conn)
             return df.to_dict(orient='records')
    except pymssql.OperationalError as e:
        logger.error(f"数据库连接失败: {str(e)}")
        return []  # 直接返回空列表，不要再抛出异常
    except Exception as e:
        logger.error(f"查询执行失败: {str(e)}")
        return []

2. 确保健康端点完全独立于数据库

如果你的健康端点（比如/health）包含数据库操作，立刻改成纯内存检查：

@router.get("/health")
async def health_check():
    return {"status": "ok"}

3. 调整Docker容器配置

• 增加容器内存/CPU限制，避免资源耗尽被终止
• 优化健康检查策略，延长超时时间、减少检查频率：

HEALTHCHECK --interval=10s --timeout=5s --start-period=30s --retries=3 \
  CMD curl -f http://localhost:8000/health || exit 1

4. 验证全局异常处理器覆盖范围

确保全局异常处理器能捕获所有同步/异步异常，包括SQLAlchemy底层错误：

from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse

app = FastAPI()

@app.exception_handler(Exception)
async def global_exception_handler(request: Request, exc: Exception):
    logger.error(f"全局异常捕获: {str(exc)}")
    return JSONResponse(
        status_code=200,
        content={"data": basic_data}
    )

关键注意点 #

• 不要在get_user_data中抛出异常，直接返回基础数据，避免上层重复处理的额外开销
• 连接池参数必须配置，防止失效连接堆积导致的资源泄漏
• 健康检查是容器稳定的核心，必须完全脱离外部依赖

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