必须检查入口文件是否包含require DIR . '/../vendor/autoload.php';，漏掉或路径错误会导致所有类报Class not found；第三方SDK需在composer.json中用psr-4或files显式配置autoload并执行composer dump-autoload -o生效。
确认入口文件是否已加载 vendor/autoload.php
ThinkPHP 6+ 完全依赖 Composer 自动加载器，不是“支持”，而是“必须”。public/index.php 开头必须有这一行：
require __DIR__ . '/../vendor/autoload.php';漏掉或路径写错（比如少一个
..），哪怕 composer require 成功，所有类也都会报 Class not found。检查时直接在浏览器访问入口，然后在命令行跑 php public/index.php 看是否报错——后者能绕过 Web 服务器缓存，更准。
composer.json 中的 autoload 配置怎么写才生效
第三方 SDK 若没走 composer require 安装（比如手动丢进 extend/），就必须显式告诉 Composer 哪里找类。关键看三类写法：
-
psr-4：适用于有规范命名空间的 SDK，例如 SDK 源码在extend/wechat/src/，且类文件都以namespace WeChat;开头，则加："autoload": { "psr-4": { "WeChat\": "extend/wechat/src/" } } -
files：适用于无命名空间、或用require方式加载的旧 SDK（如部分支付宝 AOP SDK），直接列 PHP 文件路径："autoload": { "files": ["extend/alipay/aop/AopClient.php"] } - 别用
classmap扫extend/目录——它不递归解析命名空间，容易漏类，且每次增删文件都要重跑dump-autoload。
改完 composer.json 后，必须执行：
composer dump-autoload -o
-o 参数不能省，否则优化后的静态映射不会生成，TP 启动时加载慢还可能漏类。
为什么 extend/ 目录里的类总找不到
extend/ 是 ThinkPHP 的约定存放地，不是自动加载源。TP 不会主动扫描它，Composer 也不会——除非你在 composer.json 里明确声明路径映射。常见错误包括：
立即学习“PHP免费学习笔记（深入）”；
- 把 SDK 整个文件夹拖进
extend/wechat/，但没配psr-4，也没运行dump-autoload - 类文件里写了
namespace wechat;（小写），但composer.json写的是"WeChat\": "extend/wechat/src/"（大小写不一致，Windows 下可能侥幸通过，Linux 下必挂） - 在控制器里写
require_once './extend/wechat/WxPayApi.php'—— 这样虽能临时跑通，但 IDE 无法跳转、类型提示失效、单元测试难写，而且后续 Composer 更新可能覆盖你手动 require 的逻辑
TP 自带 Loader 和 Composer autoload 是什么关系
两者并存，但职责不同：Composer 的 autoload.php 负责全局类加载（vendor/ 和你配置的 psr-4/files）；TP 的 thinkLoader 主要处理 app/ 和核心类，它默认不理会 extend/。所以不要指望调用 Loader::addNamespace() 能替代 Composer 配置——除非你在 public/index.php 中框架初始化前就调用它，但这属于绕过标准流程，维护成本高，且和 Composer 的 autoload_static.php 映射冲突风险大。
最稳的路径只有一条：让 SDK 进 Composer 的体系。要么 composer require 正规包，要么手动配 autoload + dump-autoload -o。其他方式看似快，实际埋坑更多。
