Symfony4中Doctrine正常但PHPUnit测试无数据库连接问题排查

我之前也碰到过这个Symfony 4下PHPUnit和Doctrine的连接问题，结合你的描述，这个情况不是Bug，核心问题出在测试环境的配置加载机制上。

问题复现场景 #

• Symfony 4环境中，常规命令行操作（比如php bin/console doctrine:schema:create）下Doctrine完全正常，能验证Schema、创建数据库；
• 运行./bin/phpunit执行测试时，抛出SQLSTATE[HY000] [2002] No such file or directory异常，测试代码无法连接数据库；
• 测试代码已按照Symfony官方要求启动内核获取EntityManager：

class PersistingResultTest extends KernelTestCase {
    protected $em;
    protected function setUp() {
        $kernel = self::bootKernel();
        $this->em = $kernel->getContainer()->get('doctrine')->getManager();
    }
    public function testPersistingLogFile() {
        // 测试数据库连接的简单Schema操作
        $tool = new SchemaTool($this->em);
        $tool->createSchema($this->em->getMetadataFactory()->getAllMetadata());
    }
    protected function tearDown() {
        parent::tearDown();
        $this->em->close();
        $this->em = null; // 避免内存泄漏
    }
}

问题核心原因 #

在Symfony 4中，默认情况下PHPUnit测试环境不会自动加载根目录下的.env文件，或者环境变量的加载优先级存在问题，导致Doctrine无法读取到DATABASE_URL配置，进而无法初始化正确的数据库连接。

而常规的bin/console命令会自动加载.env中的配置，所以命令行下Doctrine能正常工作，但测试环境却出现连接失败。

可行的解决方法 #

你已经找到的方案是有效的，这里再补充两种常见的解决思路：

方案1：直接在Doctrine配置文件中指定连接参数 #

把.env中的DATABASE_URL配置复制到config/packages/doctrine.yml（或测试环境专属配置config/packages/test/doctrine.yml）中，明确指定数据库连接信息：

doctrine:
    dbal:
        url: 'mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7'
        # 其他DBAL相关配置...

这种方式绕过了环境变量加载的问题，让测试环境能直接读取到数据库连接参数。

方案2：配置PHPUnit强制加载.env文件 #

修改项目根目录下的phpunit.xml.dist文件，在<php>标签内添加环境变量配置，确保测试环境能正确读取.env中的数据库配置：

<php>
    <env name="APP_ENV" value="test" />
    <!-- 直接引用.env中的DATABASE_URL -->
    <env name="DATABASE_URL" value="%env(DATABASE_URL)%" />
    <!-- 或者直接指定测试环境专属的数据库URL -->
    <!-- <env name="DATABASE_URL" value="mysql://db_user:db_password@127.0.0.1:3306/test_db?serverVersion=5.7" /> -->
</php>

这样PHPUnit启动时会正确加载数据库连接配置，避免连接失败。

总结 #

这个问题并非Symfony或Doctrine的Bug，而是测试环境的配置加载逻辑导致的环境变量读取异常。通过直接在Doctrine配置文件中指定参数，或者确保PHPUnit正确加载.env文件，都可以解决这个问题。

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