PHPUnit覆盖率异常：静态方法未覆盖，行覆盖率与方法覆盖率不符

你遇到的这个情况确实有点费解——明明用phpunit --coverage-html生成的报告显示行覆盖率在85-90%，但被测的ClassHelper类却没有任何方法被标记为覆盖。结合你给出的代码、测试类以及PHPUnit 6.1.3版本，咱们来一步步理清楚问题和解决办法。

先分析可能的核心原因 #

最可能的问题出在类的自动加载或PHPUnit的覆盖率配置上：

• 如果ClassHelper类的命名空间和文件路径不匹配PSR规范，或者没有通过Composer正确自动加载，PHPUnit的覆盖率工具就无法把测试中调用的静态方法关联到对应的类文件上，导致报告显示行覆盖率但不标记类方法覆盖。
• 另外，你最初的测试只覆盖了setPropertyValue和hasPropertyValue两个方法，如果ClassHelper还有其他方法（比如getPropertyValue）未被测试，类方法覆盖率自然不全，但你说的是“无任何函数或方法被覆盖”，所以自动加载/配置的问题概率更高。

修正你的异常测试代码（达到100%覆盖的关键） #

你更新的测试示例里有个小错误：$this->expectException(ClassHelper::getPropertyValue($class, 'property3'));的用法不对，expectException需要传入异常类名，而不是直接调用会抛出异常的方法。正确的写法应该是先声明预期异常，再执行触发异常的代码：

/**
 * @throws \Jad\Exceptions\JadException
 * @expectedException \Jad\Exceptions\JadException
 * @expectedExceptionMessage Property [property3] not found in class [Jad\Tests\TestClass]
 */
public function testGetPropertyValue() {
    $class = new TestClass();
    ClassHelper::setPropertyValue($class, 'property1', 'test');
    
    // 验证正常取值逻辑
    $this->assertEquals('test', ClassHelper::getPropertyValue($class, 'property1'));
    $this->assertEquals('prop2', ClassHelper::getPropertyValue($class, 'property2'));
    
    // 正确的异常断言方式（PHPUnit 6.x同时支持注解和API）
    $this->expectException(\Jad\Exceptions\JadException::class);
    // 触发异常的调用放在断言之后
    ClassHelper::getPropertyValue($class, 'property3');
}

解决覆盖率报告不显示类方法覆盖的步骤 #

1. 检查自动加载配置：
   确保ClassHelper的命名空间和文件路径符合PSR-4规范，然后执行composer dump-autoload更新自动加载映射，保证测试时能正确加载到这个类。

2. 确认PHPUnit的覆盖率过滤配置：
   在你的phpunit.xml配置文件中，添加或检查filter节点，指定需要统计覆盖率的源代码目录，比如：

   <filter>
       <whitelist processUncoveredFilesFromWhitelist="true">
           <directory suffix=".php">./src</directory>
           <!-- 确保ClassHelper所在的目录被包含进来 -->
       </whitelist>
   </filter>
   

3. 清理缓存并重新生成报告：
   删除之前生成的coverage-html目录，避免缓存干扰，然后重新执行命令：

   phpunit --coverage-html ./coverage-html
   

做完这些步骤后，覆盖率报告应该就能正确显示ClassHelper类的方法覆盖情况，配合修正后的测试代码，就能达到你想要的100%覆盖率了。

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