Docker部署Symfony时PHPUnit测试无法连接数据库故障排查

报错核心是执行PHPUnit的运行环境无法解析database这个MySQL主机名，本质是执行命令的网络环境不对：

• Docker Compose启动服务时会创建专属内部网络，同网络内的容器可以直接通过服务名做DNS解析，你的app容器和database容器默认就在这个网络里，所以Apache承载的常规业务请求（运行在app容器内部）可以正常通过database:3306连上数据库，这就是业务访问无异常的原因。
• 服务名database的解析规则仅在Compose内部网络生效，你大概率是直接在宿主机项目目录下执行了./vendor/bin/phpunit，或者尝试在镜像构建阶段跑测试——这两个场景的运行环境都不在Compose的内部网络里，根本找不到database对应的主机地址，直接抛出解析失败的异常。

根据你执行测试的场景选对应方案即可：

方案1：在运行中的app容器内执行测试（推荐） #

这是最符合容器化逻辑的方案，完全不需要改现有配置：

1. 先确保所有服务正常后台启动：

   docker-compose up -d
   

2. 进入app容器的交互终端：

   docker-compose exec app bash
   

3. 进入容器后直接执行测试命令即可：

   ./vendor/bin/phpunit
   

如果不想进交互终端，可以直接单条命令执行测试：

docker-compose exec app ./vendor/bin/phpunit

方案2：宿主机直接执行测试（适配IDE调试场景） #

如果需要在宿主机直接跑测试（比如用PhpStorm做本地单测调试），修改测试环境的数据库连接配置即可：
编辑项目根目录下的.env.test文件，把DATABASE_URL中的主机名从database改成127.0.0.1即可：

DATABASE_URL="mysql://root:root@127.0.0.1:3306/app"

注意用这个方案要先确认宿主机的3306端口没有被本地安装的MySQL等服务占用，否则会连错数据库。

避坑提醒 #

不要把数据库相关的测试、初始化命令写到Dockerfile的构建步骤（RUN指令）里：镜像构建时启动的临时构建容器不会接入Compose创建的内部网络，永远无法连通database服务，这类操作都要等容器启动后，通过docker-compose exec或者启动入口脚本在运行态的容器内执行。

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