Laravel使用paratest运行代码覆盖率时数据库创建异常问题

你遇到的报错核心是并行测试进程的数据库隔离缺失：

• Laravel 自带的 php artisan test --parallel 命令内置了并行测试适配逻辑，会自动为每个测试进程生成独立的测试数据库（默认在原有测试库名后加_进程ID后缀），各个进程操作自己的数据库不会互相干扰，所以运行正常。
• 你直接调用 paratest 没有走 Laravel 内置的并行适配逻辑，16个测试进程全部共用你在 phpunit.xml 中配置的同一个 mysql-test 数据库，多进程同时执行迁移、删表操作时就会出现两类冲突：要么某个进程删表时其他进程正在访问该表，报「表不存在」错误；要么多个进程同时执行迁移创建表，报「表已存在」错误。
• 单进程执行 phpunit 没有问题，也是因为只有一个进程操作数据库，不存在资源竞争。

方案1（推荐）：直接用 Laravel artisan 命令透传覆盖率参数 #

Laravel 的 test 命令支持透传所有 paratest/phpunit 的参数，你只需要把覆盖率参数直接加在命令后即可，既可以享受 Laravel 自带的数据库隔离能力，也能生成覆盖率报告，命令示例：

XDEBUG_MODE=coverage php artisan test --parallel -p16 --coverage-text --coverage-html ./coverage --coverage-filter ./app --verbose

你不需要额外修改任何配置，该命令会自动处理并行进程的数据库隔离问题，同时生成符合要求的覆盖率报告。

方案2：直接调用 paratest 时手动配置数据库隔离 #

如果你坚持要直接调用 paratest 命令，需要手动补全 Laravel 的并行数据库隔离逻辑：

1. 修改 config/database.php 中 mysql-test 连接的数据库名配置，增加测试进程标识的后缀逻辑：

'mysql-test' => [
    // 其他原有配置保持不变
    'database' => env('DB_DATABASE', 'testing') . (env('TEST_TOKEN') ? '_' . env('TEST_TOKEN') : ''),
],

paratest 会为每个测试进程自动注入 TEST_TOKEN 环境变量，取值为1到你指定的进程数，上述配置会让每个进程使用独立的测试数据库。
2. 执行 paratest 命令时增加 Laravel 并行测试标识：

XDEBUG_MODE=coverage LARAVEL_PARALLEL_TESTING=1 vendor/bin/paratest -p16 --coverage-text --verbose --runner=WrapperRunner

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