运行pytest时无法通过SQLAlchemy连接Docker内的测试PostgreSQL

先修正你已经定位到的两处配置错误，这是解决连接问题的核心：

1. 修正docker-compose.yml中测试数据库的密码变量 #

找到db_test服务的环境变量配置，把错误的密码变量替换为正确值：

# 错误配置
services:
  db_test:
    environment:
      - POSTGRES_PASSWORD: ${POSTGRES_USER_TEST}

# 修正后配置
services:
  db_test:
    environment:
      - POSTGRES_PASSWORD: ${POSTGRES_PASSWORD_TEST}

2. 修正测试数据库的主机环境变量 #

将环境变量POSTGRES_HOST_TEST的值从db改为db_test，确保conftest.py生成的连接URL指向正确的容器：

# conftest.py中生成测试数据库连接URL的示例代码
import os
from sqlalchemy.ext.asyncio import create_async_engine

DATABASE_URL_TEST = f"postgresql+asyncpg://{os.getenv('POSTGRES_USER_TEST')}:{os.getenv('POSTGRES_PASSWORD_TEST')}@{os.getenv('POSTGRES_HOST_TEST')}:5432/{os.getenv('POSTGRES_DB_TEST')}"
engine_test = create_async_engine(DATABASE_URL_TEST)

修正后POSTGRES_HOST_TEST的值为db_test，URL会正确指向测试数据库容器。

验证修正 #

修改配置后，执行以下步骤确保生效：

• 停止并清理现有容器：docker-compose down -v（-v会删除数据卷，避免旧配置残留）
• 重新启动数据库容器：docker-compose up -d db db_test
• 运行pytest测试，检查连接是否恢复正常

除了双容器方案，还有以下几种常用的测试数据库策略：

• 主数据库的独立Schema：无需额外容器，在主数据库中创建测试专用Schema，每个测试前清空Schema。优点是节省资源，缺点是需要严格隔离逻辑，避免污染主数据。
• 内存数据库（如SQLite）：测试时使用SQLite内存模式（sqlite:///:memory:），无需容器，启动速度极快。适合不需要PostgreSQL特定特性的测试，缺点是无法覆盖PostgreSQL专属语法或功能。
• Testcontainers动态容器：在测试代码中自动创建临时PostgreSQL容器，测试完成后自动销毁。优点是完全隔离，无需提前维护容器，缺点是每次测试启动容器会增加少量耗时。
• 事务回滚机制：测试开始前开启数据库事务，测试结束后回滚事务，不提交任何数据。优点是速度快，数据自动保持干净，缺点是需要测试框架支持事务管理（如pytest-asyncio配合SQLAlchemy的事务控制）。

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