单元测试代码覆盖率统计异常：@covers注解未生效问题

问题现象 #

使用@covers注解时，代码覆盖率统计未将被测方法纳入考量——无论仅标注覆盖类、仅标注覆盖方法，还是两者同时标注，都会出现方法覆盖率统计异常的情况。

例如测试UserEditController的edit方法后，覆盖率输出显示该类方法覆盖率为0.00%（0/2），但代码行覆盖率已有44.78%。

测试代码 #

/**
 * @covers \App\Controller\UserEditController
 */
class UserEditWebTest extends WebTestCase
{
    /**
     * @covers ::edit
     */
    public function testEdit():void
    {
        //...
        $this->assertSomething();
    }
}

被测控制器代码 #

namespace App\Controller;

class UserEditController
{
    public function edit() {
        //..
    }

    protected function someOtherFn():void
    {
         //..
    }
}

单元测试覆盖率输出 #

$ utest --coverage-text

Classes: 23.41% (125/534)   
Methods: 32.75% (1091/3331) 
Lines:   31.58% (4799/15198)

App\Controller\Admin\User\UserEditController
  Methods:   0.00% ( 0/ 2)   Lines:  44.78% ( 30/ 67)

已尝试的排查操作 #

• 移除测试方法文档块中的@covers注解
• 在::edit前添加控制器完整命名空间
• 清理测试环境缓存

以上操作均未解决问题。

解决方案 #

1. 无需依赖@covers注解：只要PHPUnit配置正确，被测类、方法及代码行的覆盖率会被自动正确统计，无需手动添加@covers注解。
2. 直观验证覆盖情况：可以在PhpStorm中运行基于Xdebug的覆盖率测试，直接查看哪些代码被实际覆盖。
3. 完善测试用例：当前@covers注解未被正确识别，建议补充测试用例，覆盖edit方法内的各分支场景，进一步提升代码行的覆盖范围。

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