thinkphp报“类找不到”90%是自动加载未配对，非文件缺失；需严格确保命名空间、物理路径、composer autoload配置、入口加载顺序四者完全一致，新增类或修改后必须执行composer dump-autoload -o刷新映射。
ThinkPHP 报“类找不到”，90%不是文件丢了，而是自动加载没配对。核心就一点：框架不会主动扫描所有 PHP 文件，它靠命名空间、目录路径和 autoload 配置来定位类。配错一个环节，哪怕文件真实存在，也会报 Class not found。
确认入口是否先加载了 Composer 自动加载
ThinkPHP 6+ 完全依赖 vendor/autoload.php 启动。入口文件（如 public/index.php）必须在初始化框架前引入它：
- ✅ 正确写法：
require __DIR__ . '/../vendor/autoload.php'; - ❌ 错误写法：漏掉这行、或把它放在
think\initializer\Bootstrap::start()之后 - 如果用的是 TP5.x，也要确保
composer install已执行，且vendor/autoload.php可读
检查第三方 SDK 的存放位置和加载方式
不同版本处理方式差异大，不能混用：
-
TP6+ 推荐方式：SDK 必须通过
composer require vendor/name安装，或手动在composer.json的"autoload": {"psr-4": {...}}中声明路径映射，再运行composer dump-autoload -o -
不走 Composer 的 SDK（比如直接丢进
extend/或vendor/外部目录）：Composer 默认不扫描它们，必须显式注册——要么改composer.json，要么在app/common.php中用think\Loader::addNamespace()（注意：TP6.3+ 已移除该方法，需改用容器绑定） -
TP3.2/5.x 兼容方案：可放
Library/Vendor/下，用Vendor('Zend.Filter.Dir')加载，但要求文件后缀是.php，且实例化时加反斜杠：new \Dir();
核对命名空间与物理路径是否严格一致
PSR-4 是硬性规则，不是建议：
- 若类定义为
namespace org\wechat;，文件就必须放在org/wechat/WeChatPay.php（注意大小写） - Linux 服务器区分大小写：
WechatPay.php≠WeChatPay.php，哪怕 IDE 不报错，运行时也会失败 - 类名和文件名要完全对应：类
WeChatPay→ 文件名必须是WeChatPay.php，不能是wechatpay.php或WeChatPay.class.php
排查缓存和配置干扰
有些问题看似随机，其实是缓存或配置残留导致的：
- 修改过
composer.json或新增类目录后，必须运行composer dump-autoload，否则映射不会更新 - 线上环境用了
--optimize-autoloader，本地开发改完记得同步生成优化后的映射 - 清空
runtime/cache/和runtime/container/有时能暴露真实错误（比如旧缓存掩盖了命名空间变更） - 检查
.env或config/app.php是否有路径相关配置被意外覆盖，例如EXTEND_PATH指向错误目录
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
