Symfony 5.4升级后phpunit未加载.env.test环境变量问题

核心问题定位 #

升级后测试环境未加载.env.test、APP_ENV始终为dev，本质是测试环境的变量传递逻辑与Symfony 5.x的Dotenv加载机制未对齐，以下是分步规范修复方案：

1. 修正tests/bootstrap.php配置 #

确保bootstrap文件正确触发Symfony的环境变量自动加载逻辑，替换为官方标准内容：

<?php

use Symfony\Component\Dotenv\Dotenv;

require dirname(__DIR__).'/vendor/autoload.php';

if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) {
    require dirname(__DIR__).'/config/bootstrap.php';
} elseif (method_exists(Dotenv::class, 'bootEnv')) {
    (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
}

关键逻辑：bootEnv方法会根据当前APP_ENV的值，自动加载对应环境的配置文件（.env.test会覆盖.env中的同名变量）。

2. 标准化phpunit.xml.dist配置 #

无需同时添加<server>和<env>节点，仅保留<env>节点并开启强制覆盖即可：

<?xml version="1.0" encoding="UTF-8"?>

<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
         bootstrap="tests/bootstrap.php"
         colors="true"
>
    <php>
        <env name="APP_ENV" value="test" force="true"/>
        <env name="APP_DEBUG" value="0"/>
        <env name="KERNEL_CLASS" value="App\Kernel"/>
        <!-- 其他测试专属环境变量可在此定义，或由.env.test覆盖 -->
    </php>

    <testsuites>
        <testsuite name="Project Test Suite">
            <directory>tests</directory>
        </testsuite>
    </testsuites>

    <coverage processUncoveredFiles="true">
        <include>
            <directory suffix=".php">src</directory>
        </include>
    </coverage>
</phpunit>

force="true"确保该值会覆盖任何外部传入的APP_ENV变量，保证测试环境的独立性。

3. 验证依赖与文件完整性 #

• 检查composer.json中依赖版本是否匹配5.4：

  "require-dev": {
      "symfony/phpunit-bridge": "^5.4",
      "symfony/dotenv": "^5.4"
  }
  

  执行composer update确保依赖完全更新。
• 确认项目根目录下.env.test文件存在，且包含基础测试环境配置（如APP_ENV=test、APP_DEBUG=0）。

4. 测试命令验证 #

运行测试时避免手动传入环境变量干扰，直接执行：

php bin/phpunit

此时APP_ENV会被phpunit强制设置为test，bootstrap文件自动加载.env.test，覆盖.env中的开发环境配置。

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