Symfony中PHPUnit覆盖率报告缺失主因是Xdebug未启用或phpunit.xml缺配置；assertContains验证存在性，assertContainsOnly验证元素类型；WebTestCase中expectException需配合disableExceptionThrowing；覆盖率常忽略Twig、YAML等非PHP文件。
Symfony 项目里跑 phpunit 看不到覆盖率报告？不是 Xdebug 没开，就是 phpunit.xml 里漏了 <coverage></coverage> 配置 —— 这俩问题占了 90% 的失败原因。
覆盖率报告不生成：Xdebug + phpunit.xml 必须同时到位
很多开发者只装了 phpunit，却忘了 Xdebug 是覆盖率数据采集的底层依赖。PHP 8.2+ 默认不带 Xdebug，必须手动启用：
- 确认
php -m | grep xdebug有输出；没有就装：pecl install xdebug，并在php.ini加zend_extension=xdebug.so -
phpunit.xml中必须显式声明覆盖率配置，光靠命令行参数--coverage-html不生效（尤其在 Symfony 6.4+ 中） - 常见错误配置：
<directory>src/</directory>写成<directory>./src/</directory>—— 路径开头的.会导致白屏无报告
正确最小配置片段：
<coverage>
<include>
<directory suffix=".php">src/</directory>
</include>
<report>
<html outputDirectory="coverage"/>
</report>
</coverage>
assertContains 和 assertContainsOnly 区别在哪
这两个断言常被混用，但语义完全不同，错用会导致测试通过却掩盖逻辑缺陷：
立即学习“PHP免费学习笔记（深入）”；
-
assertContains('foo', $array)：只要$array里有一个元素是'foo'就过，不管其他元素是什么 -
assertContainsOnly('string', $array)：要求$array所有元素类型都是string，和值无关 - 真正想验证“数组只包含指定几个值”？得组合用：
assertCount(3, $array)+assertContains('a', $array)+assertContains('b', $array)+assertContains('c', $array)
比如验证 Doctrine 查询返回的标签名列表：$this->assertCount(2, $tags);$this->assertContains('php', $tags);$this->assertContains('symfony', $tags);
Symfony 功能测试中 expectException 不起作用
在继承 WebTestCase 或 KernelTestCase 的测试里，直接写 $this->expectException() 通常无效 —— 因为 HTTP 请求被内核拦截并转成响应，异常被吞掉了。
- 正确做法：用
$client->request()后检查响应状态码或内容，例如：$this->assertSame(400, $client->getResponse()->getStatusCode()) - 如果非要测控制器抛出的异常（比如开发期调试），得禁用异常转换：
$client->disableExceptionThrowing()，再调$this->expectException() - 注意
expectExceptionMessage()对中文消息要小心编码，建议用正则：$this->expectExceptionMessageMatches('/用户名不能为空/')
覆盖率数值虚高：忽略 Twig 模板和配置文件
Symfony 项目里，src/ 下的 PHP 类容易覆盖，但真正容易出 bug 的地方常在模板、路由、验证约束这些非 PHP 文件上 —— 它们默认不计入覆盖率统计。
-
phpunit --coverage-html只扫.php后缀，.yaml、.xml、.twig全都不算 - 想测 Twig 逻辑？得写功能测试触发渲染，再用
assertSelectorTextContains()验证输出，但这段 HTML 渲染逻辑本身不会提升 PHP 行覆盖率 - 路由定义是否完整？靠
RouterTest手动遍历$router->getRouteCollection()，但这类测试写起来费劲，多数团队干脆放弃
所以看到 85% 的覆盖率数字时，先问一句：这个数字里有没有包含 src/Controller/ 以外的任何东西？如果没有，它只反映了一半真相。
