Class not found 错误主因是 Composer 自动加载未覆盖目标类，需检查 vendor/autoload.php 引入路径、composer.json 中 PSR-4 映射格式（命名空间末尾双反斜杠、路径结尾无斜杠）、执行 composer dump-autoload -o 重建映射，并验证大小写、OPcache 及 runtime 缓存。
ThinkPHP 项目中 Class not found 报错，90% 以上不是类写错了，而是 Composer 自动加载根本没覆盖到那个类——哪怕 vendor/autoload.php 已引入、文件真实存在、命名空间看着也对。
vendor/autoload.php 引入了但类还是找不到
这说明自动加载器启动了，但映射表里压根没你的类。常见原因：
-
public/index.php里require路径写错，比如../vendor/autoload.php在 CLI 下执行时相对路径失效，建议改用__DIR__ . '/../vendor/autoload.php'并加file_exists()验证 - 入口文件中
require位置太靠后——必须在任何类实例化、new、静态调用前执行，否则框架初始化阶段就已触发类加载失败 - Web 服务器（如 Nginx）的
root配置导致 PHP 实际工作目录不是项目根目录，__DIR__指向错误位置
composer.json 的 autoload 配置怎么写才生效
PSR-4 映射不是“写了就管用”，格式错一个字符就静默失效：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间必须以双反斜杠结尾：
"app\controller\": "app/controller/"✅，"app\controller": "app/controller/"❌（少一个，类名解析会多截一层） - 路径值是相对于
composer.json所在目录的，且结尾不带斜杠："app/controller/"❌，"app/controller"✅ - 别把
autoload-dev当正式配置用——CI 构建加了--no-dev后，"Tests\": "tests/"这类映射直接被忽略 - 改完必须运行
composer dump-autoload -o，composer install或update不会重刷 autoload 映射（除非vendor被清空）
为什么本地 OK、线上报 Class not found
环境差异常暴露自动加载链的脆弱点：
- Linux 严格区分大小写：文件名
Index.php和命名空间app\controller\Index必须完全一致，index.php或indexController.php在服务器上直接失败 - CI/CD 构建时用了
composer install --no-dev --optimize-autoloader，但没加--classmap-authoritative，导致 classmap 未强制启用，仍 fallback 到 PSR-4 扫描——而扫描路径可能因构建上下文变化而失效 - 线上开了 OPcache，且没配置
opcache.revalidate_freq=0，autoload_classmap.php更新后 PHP 仍在用旧缓存 - 没清
runtime/目录：ThinkPHP 6+ 会把服务绑定、类反射结果缓存进runtime/container/和runtime/cache/，autoload 更新了，缓存却还指着旧类
第三方 SDK 放在 extend/ 怎么让它被加载
ThinkPHP 不扫描 extend/ 目录，它只是个约定存放地，不是自动加载源：
- 首选方案：用
composer require xxx/xxx安装 SDK，让 Composer 管理其 autoload（查 GitHub 是否已发布为 Composer 包） - 若必须手动放
extend/wechat/，就在composer.json中加 PSR-4 映射："WeChat\": "extend/wechat/src/"，然后composer dump-autoload -o - SDK 用非标准命名空间（如空命名空间、下划线类名），改用
"files"方式："files": ["extend/alipay/aop/AopClient.php"] - 绝对不要在控制器里写
require_once './extend/wechat/WxPayApi.php'——破坏依赖注入、IDE 无法识别、类型提示丢失
最易被忽略的一点：composer dump-autoload -v 输出里没出现你的命名空间，就别往下排查了——说明配置根本没被读取，先检查 composer.json 的 JSON 格式是否合法（逗号、引号、缩进），再确认是否在正确目录下执行命令。
