Laravel项目中Composer包单元测试覆盖率仅识别app目录的问题

以下是几个可行的解决方向：

1. 修正PHPUnit的排除规则 #

PHPUnit默认会排除整个vendor目录的覆盖率统计，即便你在<include>里指定了目标包的src目录，也可能被全局排除规则覆盖。你需要在<coverage>配置里添加反向排除规则，明确保留目标包的源码目录：

<coverage processUncoveredFiles="true">
    <include>
        <directory suffix=".php">./vendor/mypackage/package/src</directory>
        <directory suffix=".php">./app</directory>
    </include>
    <exclude>
        <!-- 排除vendor下其他目录，但保留目标包的src -->
        <directory suffix=".php">./vendor/*</directory>
        <directory suffix=".php">!./vendor/mypackage/package/src</directory>
    </exclude>
</coverage>

2. 确认测试命令的参数 #

确保执行测试生成覆盖率时，没有通过命令行参数限制覆盖范围。直接使用标准的覆盖率生成命令：

phpunit --coverage-html ./coverage-report

避免添加额外的路径过滤参数，防止覆盖phpunit.xml中的配置。

3. 检查Composer包的自动加载配置 #

确认目标包的composer.json中autoload规则正确映射了src目录：

"autoload": {
    "psr-4": {
        "Mypackage\\Package\\": "src/"
    }
}

之后在项目根目录执行composer dump-autoload，确保Laravel能正确加载包内的类，PHPUnit才能追踪到这些类的覆盖情况。

4. 调整路径写法 #

尝试去掉路径开头的./，改用相对项目根目录的简洁路径：

<directory suffix=".php">vendor/mypackage/package/src</directory>

或者直接使用绝对路径（替换为你的项目实际路径）：

<directory suffix=".php">/var/www/your-project/vendor/mypackage/package/src</directory>

5. 升级PHPUnit版本 #

部分旧版本PHPUnit在处理vendor目录下的覆盖率统计时存在兼容性问题，升级到Laravel对应版本支持的最新稳定PHPUnit版本（比如Laravel 10对应PHPUnit 10.x，Laravel 9对应PHPUnit 9.x），可能解决此类问题。

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