Docker Compose中Django+PostgreSQL运行测试时数据库异常

• 先定位具体错误：
  直接执行sudo docker compose run --rm app sh进入容器终端，手动运行python3 manage.py test，查看完整报错堆栈，这比仅看日志片段更易定位问题。

• 检查Docker Compose配置细节：

  • 确认app服务的依赖配置：在docker-compose.yml中，app的depends_on是否包含数据库服务（比如db）？注意depends_on仅保证启动顺序，不保证服务就绪，可在测试命令前添加数据库就绪检测脚本，示例（PostgreSQL）：

    sudo docker compose run --rm app sh -c 'until pg_isready -h db -U postgres; do sleep 1; done; python3 manage.py test'
    

    （MySQL需替换为对应的mysqladmin ping检测命令）
  • 验证代码卷挂载：确认app服务的volumes配置是否将本地项目目录正确映射到容器内工作目录，比如./:/app，避免容器内找不到测试代码文件。
  • 核对环境变量：检查environment中是否配置了测试所需变量，比如DATABASE_URL、DEBUG，确保测试数据库连接参数和docker-compose.yml中数据库服务的配置一致（数据库主机名是服务名，而非localhost）。

• 检查Django测试配置：

  • 打开settings.py，确认TEST数据库的配置是否正确，需使用和开发环境一致的数据库服务，避免测试时尝试连接本地不存在的数据库。
  • 排查测试用例是否依赖未启动的外部服务（比如Redis、RabbitMQ），如果有，需确保这些服务已在docker-compose.yml中定义并启动。

• 权限排查：

  • 检查容器内运行命令的用户权限：如果Dockerfile中创建了非root用户，需确认挂载的代码卷拥有该用户的读写权限，可进入容器后执行ls -l查看目录权限。

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