php单元测试覆盖率低的主因是业务代码中存在new pdo、file_get_contents等硬编码i/o依赖，导致异常分支未执行、mock失效及环境差异跳过分支；应将依赖注入构造函数并避免副作用，改用接口mock，并配合@covers精准标注覆盖范围。
PHP单元测试覆盖率上不去，八成不是 PHPUnit 配置问题，而是业务代码里藏着 new \PDO、file_get_contents、Config::getInstance() 这类硬编码依赖——它们一执行就触发真实 I/O，既拖慢测试，又让异常分支永远进不去，覆盖率统计直接失真。
为什么 new 调用会让覆盖率“漏行”
PHPUnit 统计的是“被执行的源码行”，但 new Database() 这类调用会实际连接数据库、读取配置文件或发起 HTTP 请求。这些副作用会导致：
- 超时或网络失败时，
catch块里的逻辑根本没跑，对应行数不计入覆盖率 - 初始化逻辑（如连接池建立）在构造函数里执行，mock 传进去也拦不住，污染覆盖率数据
- 某些分支因环境差异（如本地没配 Redis）被跳过，报告里显示“未覆盖”，实则是没执行
怎么改构造函数才能让 mock 真正生效
只把依赖改成参数传入还不够，关键在“构造函数里不做任何副作用操作”。否则 $this->initConnection() 这种调用一跑，mock 就白给了。
- 构造函数只做属性赋值：
$this->db = $db;，不调用任何方法 - 把连接、缓存预热等动作移到
init()或首次使用时 lazy 加载 - 接口定义要窄：比如
UserRepositoryInterface只声明find()和save()，别塞一堆无关方法，否则 mock 时得 stub 全部，容易漏覆盖 - 测试中显式传参：
$this->getMockBuilder(UserService::class)->setConstructorArgs([$mockDb, $mockLogger])->getMock()，绕过容器自动解析干扰
@covers 和 php-token-stream 怎么配合用
@covers 不是装饰，是告诉 PHPUnit “这个测试只负责这几行”，避免胶水代码（如 trait 引入、框架基类）拉低核心逻辑的覆盖率数字；php-token-stream 是底层解析器，它让 PHPUnit 能识别注解、跳过生成代码、区分真正该算的业务行。
- 每个测试类顶部加
@covers \App\Service\UserService，方法级可细化到@covers ::handleLogin() -
phpunit.xml中必须启用：processUncoveredFilesFromWhitelist="true"，否则 src/ 下未被测试加载的类直接被忽略 -
<whitelist></whitelist>要包含所有src/下 PHP 文件，且路径写全：<directory suffix=".php">src</directory> - 别在测试里 mock 类名（如
$this->createMock('Database')），而要 mock 接口（$this->createMock(DatabaseInterface::class)）——只有接口能保证契约稳定，mock 行为才可控
真正卡住覆盖率的，从来不是“不会写测试”，而是业务类里那些静默执行的 new、static:: 和全局函数调用。删掉它们，比补一百个 assertTrue 更有效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
