运行PHPUnit时提示‘DATABASE_URL’环境变量未找到的解决方法

我之前也碰到过一模一样的问题——明明.env里已经配置了DATABASE_URL，但直接跑phpunit命令就是报环境变量找不到的错。这是因为直接调用phpunit二进制文件时，没有触发Symfony完整的环境加载流程，导致.env里的变量没被读取到。给你几个实用的解决办法：

方法1：用Symfony自带的测试脚本执行 #

Symfony Flex已经帮我们生成了bin/phpunit脚本，它会自动初始化Symfony内核并加载所有环境配置（包括.env里的变量），直接用这个命令跑测试就不会有问题：

php bin/phpunit

如果需要指定测试环境，还可以加上参数：

php bin/phpunit --env=test

方法2：在phpunit.xml.dist中配置环境变量 #

如果习惯直接用phpunit命令，你可以在项目根目录的phpunit.xml.dist（或phpunit.xml）里的<php>标签下直接定义DATABASE_URL，或者配置让它加载环境配置文件：

<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
         bootstrap="vendor/autoload.php"
         colors="true">
    <!-- 其他配置 -->
    <php>
        <!-- 直接配置测试用的数据库连接 -->
        <env name="DATABASE_URL" value="mysql://user:password@127.0.0.1:3306/db_test?serverVersion=8.0"/>
        <!-- 设置APP_ENV让Symfony自动加载对应环境的配置文件 -->
        <env name="APP_ENV" value="test"/>
        <env name="KERNEL_CLASS" value="App\Kernel"/>
    </php>
</phpunit>

建议在.env.test里单独配置测试专用的数据库（比如用SQLite内存库），这样测试环境和开发环境的数据库不会互相干扰。

方法3：执行命令前手动加载.env变量 #

如果你一定要直接调用phpunit二进制文件，可以先手动加载.env里的变量（仅适用于bash/zsh等shell环境）：

export $(grep -v '^#' .env | xargs) && php vendor/phpunit/phpunit/phpunit

不过这个方法比较繁琐，不如前两种靠谱，毕竟如果.env里有特殊字符可能会出问题。

另外还要确认一下：你的.env文件确实在项目根目录，并且有可读权限，测试进程能正常访问它。如果存在.env.test文件，测试环境会优先加载这个文件里的配置，所以要确保里面也有DATABASE_URL的定义（或者让它继承.env的配置）。

内容的提问来源于stack exchange，提问作者Jérôme Verstrynge