FastAPI在GitHub Actions跑测试时因优先连接生产DB失败如何解决？

该问题与FastAPI的依赖覆盖机制无关，本质是Python模块导入规则导致的执行顺序问题：

• 测试脚本执行from main import app导入应用实例时，Python会先逐行执行main.py的所有模块顶层代码
• 你将生产库初始化语句models.Base.metadata.create_all(bind=engine)直接写在main.py的模块顶层，导入动作触发后会立刻执行这行代码，此时后续的依赖覆盖逻辑还未运行，直接就发起了生产数据库连接请求
• GitHub Actions运行环境默认无法访问你的私有生产数据库，因此抛出连接失败错误。本地测试能正常运行是因为你本地环境的生产数据库配置可访问，或环境变量默认指向了本地可用的数据库实例。

方案1：调整生产代码初始化逻辑（推荐） #

将模块顶层的数据库初始化逻辑迁移到FastAPI的生命周期事件中，避免导入模块时自动执行初始化：

# main.py 调整示例
from contextlib import asynccontextmanager
from fastapi import FastAPI
import models
from database import engine

@asynccontextmanager
async def lifespan(app: FastAPI):
    # 仅在应用实际启动时执行数据库初始化
    models.Base.metadata.create_all(bind=engine)
    yield
    # 应用关闭时的清理逻辑可写在此处

app = FastAPI(lifespan=lifespan)

# 原有路由等其他逻辑保持不变

调整后，测试阶段导入app实例不会触发生产库连接，依赖覆盖逻辑可正常生效。

方案2：覆盖CI测试环境的数据库配置 #

如果不想改动生产代码，可以直接在CI测试步骤中将生产数据库相关的环境变量替换为测试用PostgreSQL配置，无需注入生产库密钥：

# 调整工作流中Test with pytest步骤的env配置
- name: Test with pytest
  env:
    # 直接使用CI启动的测试PostgreSQL配置
    NAME: test
    USERNAME: test
    PASSWORD: testing
    PORT: 5432
    HOST: localhost
  run: |
    cd backend
    python -m pytest tests/

这样main.py顶层的初始化逻辑执行时，会直接连接CI提供的测试数据库实例，不会发起生产库连接请求。

内容的提问来源于stack exchange，提问作者Samuel Diaz Bidot