App::make()报Class not found是因为容器未注册该类，非框架故障；需确保php think optimize:autoload生效、class_exists()返回true、路径与命名空间严格匹配、依赖接口已显式绑定，且PHP 8.1+下参数必须显式声明类型。
App::make() 报 Class not found 不是框架坏了，是容器根本没注册这个类
类文件存在、命名空间也对，class_exists('app\service\UserService') 却返回 false？别急着查框架源码——90% 是 Composer 自动加载没生效。ThinkPHP 8 不扫描目录，只认 composer autoload 能加载的类。
必须先跑这一步：php think optimize:autoload，再验证：php -r "var_dump(class_exists('app\service\UserService'));"。返回 true 才算过关。否则所有 App::bind()、App::make() 都是空转。
- 路径和命名空间必须一字不差：类
app\service\UserService→ 文件必须是app/service/UserService.php，且首行是namespace app\service;（注意反斜杠、大小写、分号） - 别用别名直接
App::make('user_service')，除非你提前App::bind('user_service', \app\service\UserService::class) - 如果类构造函数依赖
CacheInterface这类接口，而该接口没绑定实现，反射会卡在第一步，直接抛ReflectionException
接口类型提示注入失败，是因为容器不知道接口对应哪个实现
public function __construct(UserRepositoryInterface $repo) 报错，不是 PHP 语法问题，是容器没映射关系。ThinkPHP 8 默认只绑了核心接口（如 think\Cache），自定义接口必须手动声明。
绑定写法要完整限定名，推荐统一放在子应用的 app/admin/provider.php 或 app/api/provider.php 中：
立即学习“PHP免费学习笔记（深入）”；
return [
\app\repository\UserRepositoryInterface::class => \app\repository\DbUserRepository::class,
];
- 绝对不要在
common.php或全局配置里绑定——无确定应用上下文，绑定可能被覆盖或忽略 - 支持闭包绑定，适合运行时决策：
\app\cache\CacheInterface::class => fn($app) => $app->isDebug() ? new FileCache() : new RedisCache() - 接口名和实现类都必须能被
class_exists()认出，否则绑定只是存了个字符串，没实际意义
控制器构造函数不走容器注入，是因为默认没用容器创建实例
写了 __construct(UserService $service) 却始终是 null？这不是注入失败，是压根没触发注入。ThinkPHP 8 默认用 new Index() 实例化控制器，完全绕过容器反射流程。
有三个可行解法，按推荐顺序排列：
- 改用方法参数注入：
public function index(UserService $service)—— 路由层自动解析，无需额外配置，兼容性最好 - 启用容器接管控制器：在
app/provider.php的providers数组中加入控制器全类名，例如app\controller\Index::class - 删掉
__construct()，改用initialize()初始化（它每次请求都会被调用），但别在里面手动app()->make()，否则破坏可测试性
PHP 8.1+ 反射 API 变更影响绑定逻辑
升级到 PHP 8.1 或更高版本后，ReflectionParameter::getType() 在某些场景下可能返回 null（比如参数带默认值但没类型提示），导致容器无法识别依赖类型。这不是 ThinkPHP 的 bug，是 PHP 底层反射行为变化。
关键应对点：
- 所有需要注入的参数，必须显式声明类型，不能省略（如
UserService $service不能写成$service） - 避免在构造函数或方法参数中混用类型提示与默认值，例如
public function __construct(?UserService $service = null)容易让反射失焦 - 使用
singleton()绑定时，务必用闭包包裹实例化逻辑：App::singleton(CacheInterface::class, fn($app) => new RedisCache());，否则new RedisCache()会在注册时立刻执行
最常被忽略的是：绑定和反射都依赖自动加载是否就绪。哪怕只改了一个命名空间，也得重跑 optimize:autoload，否则后续所有环节都在黑盒里失效。
