App::make()报Class not found或BindingResolutionException，根本原因是容器未显式绑定接口与实现类；必须用全限定名在对应子应用provider.php中执行App::bind()，并运行php think optimize:autoload刷新自动加载。
ThinkPHP 接口注入找不到实现类，不是容器“不支持”，而是它压根没被告知该用哪个类来代替接口——接口不能 new，容器也不会猜。
为什么 App::make(UserRepositoryInterface::class) 直接报错
错误信息通常是 Class not found 或 BindingResolutionException，但真实原因是：容器查遍所有绑定规则，没找到 UserRepositoryInterface 对应的实现类。PHP 本身禁止 new UserRepositoryInterface，而框架又没收到任何映射指令，只能放弃。
- 接口类型提示（如构造函数参数
UserRepositoryInterface $repo）不会触发自动扫描，必须显式绑定 -
App::make()和控制器参数注入走的是同一套解析逻辑，没绑定 = 解析失败 - 即使实现类文件存在、命名空间正确、
class_exists()返回true，没绑定照样失败
绑定必须写全限定名且放在正确位置
ThinkPHP 8 不会读取全局 app/provider.php 的绑定，子应用（如 admin、api）有独立容器上下文，绑定必须落在对应子应用的 app/admin/provider.php 中，否则被忽略。
- 正确写法：
App::bind(\app\contract\UserRepositoryInterface::class, \app\repository\DbUserRepository::class)—— 注意开头的反斜杠和完整命名空间 - 别用字符串别名（如
'user.repo'）直接传给App::make()，除非你提前bind('user.repo', ...) - 不要在
common.php或中间件里调用bind()，时机太晚或作用域不对
实现类本身必须真正 implements 接口
绑定语句写了 ≠ 绑定生效。如果 DbUserRepository 没声明 implements UserRepositoryInterface，或者方法签名（参数类型、返回类型、可空性）不一致，运行时可能不报错，但调用具体方法时会出问题。
立即学习“PHP免费学习笔记（深入）”；
- 检查
DbUserRepository类定义顶部是否含implements UserRepositoryInterface - IDE 补全容易漏掉
implements或拼错接口名，建议手动核对 - 接口中定义了
function find(int $id): ?User，实现类就不能写成function find($id)或返回array
控制器构造函数注入失效？先确认容器是否接管了它
ThinkPHP 8 默认不通过容器实例化控制器——如果你是 new Index() 手动创建的，那构造函数根本没走依赖解析流程，类型提示纯属摆设。
- 确保路由指向的是控制器方法（如
route::get('user', 'index/user/index')），而非手动 new - 验证方式：在控制器构造函数里
var_dump($this->app)，如果是null或报错，说明容器没注入$this->app实例，即未接管 - 若需强制容器接管，可在
app/provider.php中绑定控制器本身：App::bind('app\controller\IndexController', function ($app) { return new IndexController($app->make(UserRepositoryInterface::class)); });
最常被跳过的一步是：改完 provider.php 后没执行 php think optimize:autoload，导致类虽已绑定，但 class_exists() 仍为 false，容器连类都加载不了，更别说解析依赖了。
