bind()闭包必须返回实例，否则app()->make()返回null导致调用崩溃；singleton()闭包中依赖未注册服务会抛BindingResolutionException；测试需手动forgetInstance清理单例。
bind() 闭包必须返回实例，否则容器解析失败
调用 $this->app->bind() 时传入闭包，却没写 return，是最隐蔽的“500 不报错但功能失效”原因。Laravel 不会警告你闭包没返回值，而是让 app()->make() 返回 null，后续调用方法直接崩成 Call to a member function xxx() on null。
常见错误写法：
$this->app->bind('logger', function ($app) {
new \Monolog\Logger('api'); // ❌ 忘了 return！
});
正确写法（必须显式 return）：
$this->app->bind('logger', function ($app) { return new \Monolog\Logger('api'); });- 闭包内可安全调用
$app->make(SomeService::class)，但别在闭包里做耗时操作（如读文件、查 DB），否则每次解析都拖慢响应 - 若需复用已有实例，请改用
instance()，而不是靠闭包返回同一个对象——bind()的语义就是“每次新建”
singleton() 闭包里不能依赖未注册的服务
singleton() 闭包首次执行时才构造实例，此时容器可能尚未完成全部绑定，尤其在 boot() 阶段注册 singleton 时极易踩坑：闭包里调用 $app->make(UnregisteredService::class) 会直接抛出 BindingResolutionException。
典型场景：
- 在
AppServiceProvider::boot()中写$this->app->singleton(CacheManager::class, function ($app) { return new RedisCache($app->make('redis')); });→'redis'还没注册，崩 - 解决方案：把
singleton()移到register()方法中，或确保所依赖的服务已在更早阶段绑定（比如'redis'是框架自带服务，应始终可用） - 验证是否生效：
app()->make(CacheManager::class) === app()->make(CacheManager::class)必须为true
闭包绑定后测试不隔离？记得手动清理 singleton 实例
单元测试中反复调用 app()->make() 测试同一个 singleton() 绑定类，容易因状态残留导致测试间污染。比如 Redis 客户端被 mock 后，后续测试仍拿到旧 mock 实例。
解决方式很直接：
- 每个测试用例结束后，加一行
app()->forgetInstance(CacheManager::class) - 别指望 PHPUnit 自动重置容器——Laravel 的测试容器是复用的，
singleton()实例生命周期跨测试用例 -
bind()和instance()不需要这步，它们不缓存实例
闭包参数写错？$fail 不注入就等于没验证
这不是容器绑定专属问题，但常和 Validator::make() 里的闭包绑定混在一起出错：验证规则闭包签名必须严格是 function ($attribute, $value, $fail)。少一个参数，Laravel 不报错，但 $fail 根本不会被注入，调 $fail('msg') 也无效，字段永远“验证通过”。
务必检查：
- 三个参数一个都不能少，顺序不能变
- 别写
function ($value, $fail)—— 缺$attribute，$fail就是null -
$fail是回调函数，不是返回值：$fail('邮箱已被注册')✅，return $fail('...')❌（会返回null，且不触发失败）
复杂校验逻辑别硬塞进闭包，该提成 Rule 类就提，不然调试时连堆栈都找不到源头。
