Composer autoload 未生效导致 Class not found，因 ThinkPHP 默认仅加载 app/ 和 vendor/ 下符合 PSR-4 的类；第三方 SDK 若未通过 composer require 安装或未在 composer.json 中正确配置 autoload（PSR-4/files），或未在 TP 初始化前调用 Loader::addNamespace()，均会导致类找不到。
Composer autoload 未生效导致 Class not found
ThinkPHP 默认只加载 app/ 和 vendor/ 下符合 PSR-4 规范的类，第三方 SDK 如果没走 Composer 正规发布流程（比如直接丢进 extend/ 或手动复制文件），composer dump-autoload 就扫不到它。
常见现象：调用 new WeChatPay() 或 Alipay::getInstance() 时抛出 Class 'WeChatPay' not found，但文件明明存在、路径也对。
- 确认 SDK 是否已通过
composer require xxx/xxx安装；若只是把 SDK 文件夹拖进extend/，Composer 根本不知道它的命名空间和路径映射 - 检查
composer.json的"autoload"段是否包含该 SDK 的 PSR-4 映射，例如："autoload": { "psr-4": { "WeChat\": "extend/wechat/src/" } } - 改完
composer.json后必须运行composer dump-autoload -o（加-o生成优化后的 autoloader） - 如果 SDK 使用了非标准命名空间（如空命名空间或带下划线的类名），需改用
"files"方式加载："autoload": { "files": ["extend/alipay/aop/AopClient.php"] }
ThinkPHP 的自动加载机制绕过 Composer
ThinkPHP 启动时会注册自己的 thinkLoader，它默认只处理 app/、core/、vendor/ 下的类。如果你把 SDK 放在 extend/ 且没配置 Composer autoload，TP 就不会主动去 include 它——哪怕你写了 Loader::addNamespace()，也得在框架初始化前调用，否则无效。
-
extend/目录本身不被 TP 自动扫描，它只是个“约定存放地”，不是自动加载源 - 不要在控制器里写
require_once './extend/wechat/WxPayApi.php'—— 这样虽能跑通，但破坏自动加载逻辑，且无法被 IDE 识别、无类型提示 - 若必须用
extend/，请在public/index.php中 TP 初始化前手动注册：thinkLoader::addNamespace('WeChat', __DIR__ . '/../extend/wechat/src'); - 注意命名空间声明要和目录结构严格一致，比如
extend/wechat/src/Service/PayService.php必须声明为namespace WeChatService;
vendor 中 SDK 类名与命名空间不匹配
有些第三方 SDK 包虽然进了 vendor/，但它的 composer.json 写错了 autoload 配置，或者 PHP 文件里写的 namespace 和实际路径对不上，导致 Composer 找到包却加载失败。
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer show xxx/xxx看它声明的 autoload 类型（PSR-4 / PSR-0 / classmap / files） - 进入
vendor/xxx/xxx/src/，检查任意一个类文件顶部的namespace是否和composer.json里写的前缀一致 - 典型错误示例：SDK 的
composer.json写"WeChat\": "src/"，但实际类文件写的是namespace WxPay;—— 加载器按前缀找，根本不会命中 - 临时修复可改
vendor/下的composer.json，但更稳妥的做法是 fork 该 SDK，在composer.json里修正 autoload，并提交 PR
TP6+ 的容器绑定与类自动解析失效
在 TP6 或 TP7 中，如果你通过 app()->make(WeChatPay::class) 或依赖注入方式使用 SDK，而该类没被容器管理或命名空间未注册，就会报 Class not found，而不是容器找不到绑定——因为自动解析第一步就是靠 Composer autoload 找类定义。
- 不要假设“只要 new 得出来，容器就能 make”；
make()前提是类定义已被加载 - 若 SDK 类需要构造参数（如配置数组），不能只靠自动加载，还得在
app/provider.php中显式绑定：return [ WeChatPay::class => function ($app) { return new WeChatPay($app->config->get('wechat.pay')); } ]; - TP 的容器不负责类文件加载，它只负责实例化；类加载仍由 Composer 或
Loader完成
最常被忽略的一点：改了 composer.json 或手动加了 Loader::addNamespace()，但没清空 runtime/cache/ 下的类映射缓存，TP 会继续用旧的 autoload map，导致修改看似没生效。
