Composer解决tp加载vendor报错_Composer修复tp自动加载失效【指南】-composer-PHP中文网

class not found 错误主因是 composer 自动加载未覆盖目标类，需检查 vendor/autoload.php 引入路径、composer.json 中 psr-4 映射格式（命名空间末尾双反斜杠、路径结尾无斜杠）、执行 composer dump-autoload -o 重建映射，并验证大小写、opcache 及 runtime 缓存。

composer解决tp加载vendor报错_composer修复tp自动加载失效【指南】

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 无法识别、类型提示丢失