Composer安装Mockery Mock库要点
直接运行 composer require --dev mockery/mockery 就能装好，但装完报 “Class 'Mockery' not found” 是最常踩的坑，问题几乎都不出在安装本身。
为什么 composer require --dev mockery/mockery 装完还找不到类
根本原因不是没下载成功，而是自动加载没生效或测试入口没触发它：
- 没在测试引导文件（如
tests/bootstrap.php）里require_once 'vendor/autoload.php'； - 用
phpunit tests/ExampleTest.php直接跑单个文件时，PHPUnit 默认不加载项目级 bootstrap，得显式加参数：phpunit --bootstrap vendor/autoload.php tests/ExampleTest.php； composer.json的"autoload-dev"段没包含测试目录（比如"tests/": ["tests/"]），导致 Mockery 的命名空间没注册进 Composer 加载器；- PHP 版本低于 7.4 —— Mockery v1.6+ 要求 PHP ≥ 7.4，旧项目需降级安装：
composer require --dev mockery/mockery:^1.5。
PHPUnit 10+ 下 Mockery 报错 “Dynamic class generation is disabled” 怎么办
PHPUnit 10 默认禁用 eval()，而 Mockery 默认靠它动态生成 mock 类。不改配置就会卡住：
- 最快方案：在
phpunit.xml的processIsolation="false"； - 更稳妥方案：改用
Mockery::namedMock('MyClass')替代Mockery::mock(MyClass::class)，它不依赖eval； - 别碰
ini_set('zend.enable_gc', 0)这类绕过限制的 hack，PHP 8.2+ 已彻底移除相关兼容层。
Mockery::close() 忘写或写错位置会怎样
不调 Mockery::close() 不只是内存泄漏，更会导致后续测试失败，且错误现象非常隐蔽：
- 在
setUp()里写Mockery::close()是错的 —— 它会清空上一个测试留下的所有 mock，下一个测试刚起步就发现 mock 状态已毁； - 正确位置是
tearDown()末尾，且必须在parent::tearDown()之后（PHPUnit 9.3+）； - 如果用了
setUpBeforeClass()创建全局 mock，Mockery::close()会把它也干掉，引发 “Undefined index” 类错误； - 常见错误信息：
No matching handler found或Method xxx not allowed on this mock，八成是前一个测试的 mock 残留干扰了当前测试。
话说回来，Mockery 的核心矛盾在于：它强大在动态行为定义能力，代价是必须严格管理生命周期。漏掉 Mockery::close() 或放错位置，比装不上库更难排查——因为代码能跑、断言能过，只在特定测试顺序下才崩。
