Symfony 6配置Docker版PHPStan时出现PHPUnit相关报错如何解决

运行PHPStan静态代码检测时出现大量PHPUnit相关错误，典型报错如下：

类MyTest继承了未知类PHPUnit\Framework\TestCase
调用了未定义方法MyTest::assertFalse()

当前运行环境为Symfony 6，采用PHPStan官方Docker镜像执行检测，现有配置如下：

现有Dockerfile配置 #

FROM ghcr.io/phpstan/phpstan:1-php8.1
RUN composer global require phpstan/phpstan-phpunit phpstan/phpstan-doctrine phpstan/phpstan-symfony

现有PHPStan配置文件内容 #

parameters:
    symfony:
        containerXmlPath: /app/var/cache/dev/App_KernelDevDebugContainer.xml
    scanDirectories:
        - /app/vendor/bin/.phpunit/phpunit-9.5-0/vendor/
    scanFiles:
        - /app/vendor/bin/.phpunit/phpunit-9.5-0/vendor/autoload.php
includes:
    - /composer/vendor/phpstan/phpstan-symfony/extension.neon
    - /composer/vendor/phpstan/phpstan-symfony/rules.neon
    - /composer/vendor/phpstan/phpstan-phpunit/extension.neon
    - /composer/vendor/phpstan/phpstan-phpunit/rules.neon

• 自动加载配置逻辑错误：scanDirectories和scanFiles的作用仅为告知PHPStan需要额外扫描的文件范围，不会主动注册类自动加载规则，PHPStan运行时无法定位PHPUnit类的加载入口，直接判定目标类、类方法不存在。
• PHPUnit路径硬编码风险：Symfony 6通过symfony/phpunit-bridge安装的PHPUnit版本随依赖更新动态变化，写死9.5-0版本号极易出现路径匹配失效，导致扫描不到对应文件。
• 扩展引入不全：Docker全局安装了phpstan/phpstan-doctrine，但配置文件未引入对应规则文件，后续检测Doctrine相关逻辑会出现同类类不存在报错。
• 检测路径未声明：未显式配置PHPStan的检测范围包含测试目录，配合自动加载失效问题，会进一步放大类识别错误。

调整Dockerfile #

补全依赖安装参数，避免全局扩展出现版本兼容问题：

FROM ghcr.io/phpstan/phpstan:1-php8.1
RUN composer global require phpstan/phpstan-phpunit phpstan/phpstan-doctrine phpstan/phpstan-symfony --with-all-dependencies

修改PHPStan配置文件 #

替换错误的扫描配置，补全缺失的扩展引入和路径声明：

parameters:
    symfony:
        containerXmlPath: /app/var/cache/dev/App_KernelDevDebugContainer.xml
    # 替换原scanFiles/scanDirectories配置，通过autoload_files注册自动加载规则
    autoload_files:
        # 用通配符匹配phpunit-bridge安装的PHPUnit版本，避免硬编码版本号
        - /app/vendor/bin/.phpunit/phpunit-*/vendor/autoload.php
    # 显式声明检测路径
    paths:
        - /app/src
        - /app/tests
includes:
    - /composer/vendor/phpstan/phpstan-symfony/extension.neon
    - /composer/vendor/phpstan/phpstan-symfony/rules.neon
    - /composer/vendor/phpstan/phpstan-phpunit/extension.neon
    - /composer/vendor/phpstan/phpstan-phpunit/rules.neon
    # 补全之前遗漏的Doctrine扩展配置
    - /composer/vendor/phpstan/phpstan-doctrine/extension.neon
    - /composer/vendor/phpstan/phpstan-doctrine/rules.neon

前置准备PHPUnit依赖 #

在项目本地执行命令触发symfony/phpunit-bridge下载对应版本的PHPUnit，避免容器扫描时路径不存在：

php bin/phpunit --version

注意：如果调整配置后仍报错，检查PHPStan容器的挂载配置，确保项目本地vendor目录被完整挂载到容器内的/app/vendor路径，不要仅挂载业务代码遗漏依赖目录。

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