ThinkPHP 8 引入第三方类库报“Class not found”的根本原因是自动加载链断裂，需确保路径正确、命名空间匹配、注册时机早、映射已刷新，并确认 vendor/autoload.php 已在入口文件中引入。
ThinkPHP 8 引入第三方类库报“Class not found”，本质不是文件没放对，而是自动加载链断了——框架压根没“看见”这个类。解决关键就四件事：路径得对、命名空间得准、注册得早、映射得刷。
确认入口已加载 Composer 自动加载器
TP8 完全依赖 vendor/autoload.php 启动，缺它整个自动加载就失效：
- 打开
public/index.php，第一行必须是：require __DIR__ . '/../vendor/autoload.php'; - 检查路径是否正确（比如项目结构嵌套深了，
../不够就得加成../../） - 如果用 CLI 运行（如
php think xxx），也要确认think文件开头同样引入了 autoload
按来源选对加载方式
第三方类库分三类，不能混用加载逻辑：
-
Composer 包（推荐）：用
composer require vendor/name安装，自动注册命名空间，直接use即可 -
自定义 SDK（有命名空间）：放在
extend/下，例如extend/wechat/WxPayApi.php，对应命名空间namespace wechat;；再在composer.json的"autoload": {"psr-4": {}}中添加："wechat\": "extend/wechat/"，然后执行composer dump-autoload -o -
老式类库（无命名空间、纯函数）：在
composer.json的"autoload": {"files": []}中写死路径，例如："extend/alipay/aop/AopClient.php"，之后可直接new AopClient()（注意不加反斜杠）
绕过自动加载的手动方案（临时调试可用）
不想配 composer.json 或快速验证时，可在控制器或服务类开头手动引入：
立即学习“PHP免费学习笔记（深入）”；
- 用
require_once绝对路径：require_once EXTEND_PATH . 'wechat/WxPayApi.php';
再$pay = new WxPayApi(); - 用 ThinkPHP 命名空间注册（需在框架初始化前调用）：
在public/index.php中 TP 初始化代码之前加：hinkLoader::addNamespace('wechat', EXTEND_PATH . 'wechat');
之后就能use wechatWxPayApi;
快速验证是否真加载成功
别猜，用这三步现场确认：
- 在报错前加：
var_dump(class_exists('wechatWxPayApi'));，输出false就说明没加载进来 - 运行
composer show，看目标包是否列出；如果是手动拖进extend/的，它不会出现 - 执行
php think optimize:autoload（TP8 提供的刷新命令，等效于composer dump-autoload -o）
