ThinkPHP集成第三方SDK报Class not found的Composer自动加载修复-ThinkPHP-PHP中文网

composer autoload 未生效导致 class not found，因 thinkphp 默认仅加载 app/ 和 vendor/ 下符合 psr-4 的类；第三方 sdk 若未通过 composer require 安装或未在 composer.json 中正确配置 autoload（psr-4/files），或未在 tp 初始化前调用 loader::addnamespace()，均会导致类找不到。

thinkphp集成第三方sdk报class not found的composer自动加载修复

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()，也得在框架初始化前调用，否则无效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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 找到包却加载失败。

运行 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，导致修改看似没生效。