私有方法封装不当导致无法测试：核心逻辑藏于private中且无受控入口时，PHPUnit无法mock、调用或反射访问；应将可验证逻辑抽为protected或独立service，避免测试污染与故障定位困难。
封装不当直接破坏测试可操作性，不是“难测”，而是“根本没法正常测”。
private方法无法被单元测试覆盖
当核心业务逻辑藏在private方法里，又没提供任何受控入口，PHPUnit 就只能干瞪眼。你不能 mock 它、不能调用它、甚至不能用反射临时绕过（那已算测试污染）。更麻烦的是，一旦这个私有方法出错，你只能靠测外层 public 方法间接验证——但失败时根本分不清是接口逻辑错，还是里面某个私有步骤崩了。
- 常见错误：把校验、转换、组装等关键步骤全塞进
private函数，public 方法只剩个空壳调用 - 正确做法：把可独立验证的逻辑抽成
protected方法，或拆到独立 service 类中暴露为public - 注意：别为了“可测”而把所有方法改成
public——重点是让逻辑有明确职责边界和可注入/可替换点
依赖硬编码导致无法 mock 数据库或外部服务
比如在UserService构造函数里直接new MySQLConnection()，那测试时你就没法替换成内存数据库或 mock 连接对象。PHPUnit 的createMock()对new出来的实例完全无效。
- 典型症状：测试必须连真实数据库，跑一次要 2 秒以上，CI 环境还经常因网络或权限失败
- 解法不是“加个 try-catch”，而是把
MySQLConnection换成DatabaseInterface，通过构造函数注入 - 顺带一提：如果类里还用了
global $db或静态方法获取连接，mock 成本会翻倍——这类写法会让setUp()变得极其脆弱
过度隐藏配置参数让集成测试无法适配不同环境
像上传路径、超时时间、重试次数这类参数，如果全写死在private属性里且没 setter 或构造参数，测试就只能接受默认值。结果就是：本地能过，Docker 测试环境因路径不存在报错；压力测试时因超时太短直接断连。
立即学习“PHP免费学习笔记（深入）”；
- 反例：
private $timeout = 3000;，外部完全无法调整 - 可行方案：提供
setTimeout(int $ms)，或在构造时接受配置数组 - 关键点：不是所有 private 属性都要暴露，但凡测试中需要差异化控制的，就得留出口——否则你写的就不是“可测试代码”，而是“可运行代码”
真正卡住测试的，从来不是语法或工具，而是封装时那一句“这个我来管，你别碰”的潜台词。只要内部状态或依赖不可控、不可替换、不可观察，测试就只能在外围打转，越写越虚。
