Laravel模块化项目中PHPUnit+Xdebug无法统计modules代码覆盖率

数据老陈

2026-6-17

解决Laravel模块化项目PHPUnit代码覆盖率为0的问题

1. 确认phpunit.xml的source配置正确性

检查<source>节点是否正确包含modules目录，路径需相对项目根目录，示例配置：

<source>
    <include>
        <directory suffix=".php">./app</directory>
        <directory suffix=".php">./modules</directory>
    </include>
</source>

避免出现相对路径错误（比如错误写成../modules）。

2. 验证Xdebug的coverage模式是否正确启用

终端执行命令查看Xdebug状态：

php -v

若输出的Xdebug行未包含coverage，修改php.ini（或xdebug.ini）配置：

xdebug.mode=coverage
xdebug.start_with_request=yes

修改后重启PHP服务（CLI环境重新打开终端即可）。

3. 检查测试类与模块类的命名空间匹配

确保模块类的命名空间正确（比如Modules\Order\Models\Order），测试类的命名空间对应，且测试方法确实执行了模块中的业务逻辑，避免因命名空间错误导致PHPUnit无法关联测试与被测试类。

4. 排查phpunit.xml的排除规则

检查是否存在<exclude>节点误排除了modules目录，若有则删除对应配置：

<exclude>
    <!-- 移除包含modules的排除规则 -->
</exclude>

5. 显式生成覆盖率报告测试

执行PHPUnit命令时指定生成HTML覆盖率报告：

./vendor/bin/phpunit --coverage-html coverage-report

打开coverage-report/index.html，确认modules目录下的类是“未覆盖”状态还是未被检测到：

未被检测到：说明source配置存在问题
未覆盖：说明测试代码未实际执行到模块逻辑

6. 修复模块类的自动加载配置

确保composer.json中已配置modules目录的自动加载规则：

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Modules\\": "modules/"
    }
},
"autoload-dev": {
    "psr-4": {
        "Tests\\": "tests/"
    }
}

配置完成后执行composer dump-autoload刷新自动加载规则。