Mockery 报“Target of interface is not instantiable”是因为 mock 接口时未指定实现类或 stub 方法，导致调用时抛出 BadMethodCallException；应使用 makePartial() 或显式 stub 方法。
Mockery 为什么在 PHP 单元测试里常报 Target of interface is not instantiable
这是因为你在用 Mockery::mock() 模拟接口时，没告诉 Mockery 具体要“假装成哪个类”或“实现哪些方法”，而 PHPUnit 或容器又试图去解析这个接口——结果发现它根本没法实例化。
常见于 Laravel 测试中依赖注入接口（比如 UserServiceInterface）却直接 mock 接口本身，没指定 concrete class 或没 stub 必需方法：
- 错误写法：
Mockery::mock(UserServiceInterface::class)—— 默认不生成任何方法实现，调用时就抛BadMethodCallException - 正确做法：显式指定实现方式，例如
Mockery::mock(UserServiceInterface::class)->makePartial()，或更稳妥地Mockery::mock(UserServiceInterface::class, [/* stubs */]) - 如果接口有必需的构造参数（如依赖了
LoggerInterface），记得传进去：Mockery::mock(UserServiceInterface::class)->makePartial()->shouldHaveReceived('log')
怎么让 Mockery 返回不同值应对多次调用
Mockery 默认每次调用都返回相同值，但真实场景中一个方法可能被调用多次、每次行为不同（比如第一次查缓存命中，第二次查 DB 返回新数据）。
用 andReturnValues() 或链式 andReturn() 最直接：
立即学习“PHP免费学习笔记（深入）”；
$mock = Mockery::mock('SomeService');
$mock->shouldReceive('fetch')->andReturn('cached')->andReturn('fresh')->andReturn(null);
// 第一次调用 → 'cached'
// 第二次调用 → 'fresh'
// 第三次调用 → null
注意点：
- 调用次数超过预设值会触发异常，适合验证“是否只调用两次”这类断言
- 避免混用
andReturn()和andReturnUsing()，后者是闭包，优先级更高且覆盖前者 - 如果要复位 mock 行为（比如在同一个 test method 里测多个分支），得重建 mock 实例，Mockery 不支持运行时清空 expect 队列
Laravel 中用 Mockery 替换容器绑定时，swap() 和 instance() 有什么区别
二者都能替换服务，但生命周期和作用范围完全不同：
-
$this->app->instance(ServiceInterface::class, $mock)：只影响当前请求周期内的容器解析，且**不接管已解析过的单例**。如果 Service 已被其他类提前 resolve 过，这次 instance 就无效 -
$this->app->singleton(ServiceInterface::class, function () use ($mock) { return $mock; })更可靠，但要注意别覆盖原 singleton 定义；Laravel 9+ 推荐用bind()+resolving()钩子做条件替换 - 真正安全的做法是：在
setUp()里用Mockery::mock()创建实例，再通过$this->app->bind()显式绑定，并确保测试类使用RefreshDatabase或WithoutMiddleware避免跨测试污染
Mockery 报 No matching handler found for … 怎么快速定位
这不是语法错，而是你 mock 的对象被调用了某个没声明预期行为的方法——Mockery 默认是“严格模式”，所有调用都必须提前 shouldReceive()。
排查顺序：
- 检查错误信息里的完整方法签名（含参数），确认是不是拼错了方法名，比如写了
saveUser()但实际调用的是storeUser() - 看是否漏了参数匹配，例如
shouldReceive('process')->with(123)但实际传入的是new User(123)—— 这时要用withArgs(function ($args) { return $args[0] instanceof User; }) - 临时加一句
->byDefault()->andReturnNull()看是否只是想忽略某些调用；但生产级测试不建议长期这么干，容易掩盖设计问题 - 启用 Mockery 日志：
Mockery::getContainer()->allowMockingNonExistentMethods(true)只用于调试，切勿提交到 CI
最常被忽略的是魔术方法（__call, __get）或 trait 引入的方法——它们不会自动出现在 mock 声明里，必须手动 shouldReceive()。
