Laravel 10、PHP 8.1及PHPUnit 10升级后测试任务报错求助

常见修复点整理 #

1. 调整 phpunit.xml 配置适配 PHPUnit 10 #

PHPUnit 10 对配置文件语法做了不少变更，检查以下内容：

• 把旧的 bootstrap 属性改成标签形式：
  旧写法：

  <phpunit bootstrap="vendor/autoload.php">
  

  新写法：

  <phpunit>
    <bootstrap>vendor/autoload.php</bootstrap>
  

• 移除 processIsolation 这类已废弃的属性，改用 <php> 标签内的对应配置，或者替换为新属性名
• 核对 testsuite 的路径和命名空间配置，PHPUnit 10 对路径匹配的严格性更高，避免路径写错

2. 修复测试代码的兼容性问题 #

• 自定义测试基类要确认继承的是正确的父类，Laravel 10 提供的 Tests\TestCase 已经适配 PHPUnit 10，但如果是自己写的测试类，要确保继承 PHPUnit\Framework\TestCase 或者 Laravel 的基类
• 替换已废弃的断言方法：比如 assertInternalType 换成 assertIsArray/assertIsString 等具体类型断言，assertRegExp 换成 assertMatchesRegularExpression

3. 检查 CI/CD 或本地运行脚本 #

• 运行测试的命令要适配 PHPUnit 10，建议直接用 ./vendor/bin/phpunit 执行，不要加过时参数
• 更新 composer.json 里的测试脚本：

  "scripts": {
    "test": "./vendor/bin/phpunit"
  }
  

• 确认 PHP 8.1 所需的扩展（如 mbstring、xml、curl）都已安装，PHPUnit 10 对部分扩展的依赖有更新

4. 更新 Laravel 测试相关依赖 #

执行以下命令确保测试组件是最新适配版本：

composer update laravel/framework nunomaduro/collision

collision 包负责美化 Laravel 的测试输出，版本不兼容很容易导致流程末尾报错

5. 排查详细错误输出 #

即使测试全过，也要看 PHPUnit 的详细日志：

./vendor/bin/phpunit -v

找到末尾报错的具体内容，比如可能是某个测试的清理（teardown）环节出错，或者测试报告生成时的问题，针对性修复

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