ThinkPHP容器依赖反射、数组映射和递归make实现DI；Class not found主因是class_exists()返回false，需严格校验路径/命名空间、刷新autoload；接口必须显式bind，否则静默失败；singleton与make混用会破坏单例；构造函数注入需确保整条依赖链完整绑定。
ThinkPHP 的容器不是黑盒，它靠反射读构造函数 + 数组映射 + 递归 make 实现依赖注入；绑定没生效、Class not found、参数解析失败，基本都卡在这三步上。
为什么 App::make(UserService::class) 报 Class not found？
根本原因不是类不存在，而是容器在反射前就放弃了——class_exists() 返回 false，容器直接跳过加载逻辑。
- 确认文件路径与命名空间严格一致：类声明
namespace app\service;，就必须放在app/service/UserService.php，Linux 下userservice.php≠UserService.php - 执行
php think optimize:autoload刷新 Composer 自动加载映射，别只改代码不刷新 autoload - 加一行调试：
var_dump(class_exists('app\service\UserService'));，返回false就别往下查绑定逻辑了，先修路径和命名空间
接口绑定必须显式写 bind()，否则反射无法推断实现
当构造函数参数是接口（如 UserRepositoryInterface），PHP 反射只能拿到类型名，不知道该 new 哪个具体类。容器不会猜，也不会报错，而是静默失败——最终抛出 Binding not found 或空依赖。
- 在
app/provider.php中添加映射：'app\repository\UserRepositoryInterface' => 'app\repository\DbUserRepository' - 若需运行时决策（如开发环境用 FileCache，生产用 RedisCache），用闭包绑定：
'app\cache\CacheInterface' => function($app) { return $app->isDebug() ? new FileCache() : new RedisCache(); } - 不要只在控制器里 type-hint 接口就以为能自动工作；没 bind，容器连“这个接口对应谁”都不知道
singleton() 和 make() 混用会导致单例失效甚至解析中断
App::singleton() 是注册生命周期策略，App::make() 是按需创建实例。两者语义不同，混用等于告诉容器：“我要单例”，又说“请每次都新建”——容器会优先执行 make 的行为，忽略单例注册，进而重新触发反射和依赖解析。
立即学习“PHP免费学习笔记（深入）”；
- 绑定时统一用
singleton：在app/provider.php中写'app\service\OrderService' => function($app) { return new OrderService($app->make(PaymentGateway::class)); }，并确保它是 singleton 映射项 - 获取时也用
App::singleton('app\service\OrderService')，而非App::make()；或者更稳妥：直接 type-hint 类型，让容器在构造函数注入时自动走 singleton 策略 - 特别注意：
invoke()调用方法时，如果目标方法参数含未绑定接口，也会因make行为触发相同问题
构造函数注入不是“自动发生”，它依赖容器完整走完反射链
你以为写了 public function __construct(UserService $service) 就万事大吉？其实容器要逐层解析：UserService → 其构造函数参数 → 参数类型是否已绑定或可 class_exists → 递归直到叶子节点。任一环断裂，整个链就停在半路。
- 检查 UserService 自身是否也有未绑定的依赖，比如它依赖
Db或CacheInterface，而你只绑了 UserService - 避免循环依赖：A 依赖 B，B 又依赖 A —— 容器会在反射时陷入无限递归或抛出异常，但错误信息往往不直观
- 第三方类（如
Monolog\Logger）无法被自动解析，必须手动绑定或传入实例：$this->app->bind('monolog', function() { return new Logger('app'); });
最常被忽略的点：绑定语句写对了，但没被加载——app/provider.php 的返回数组必须被框架实际读取，服务提供者里的 register() 方法必须真正执行；调试时别只看配置文件，要确认绑定逻辑确实跑到了容器里。
