ThinkPHP 中 Composer autoload 不生效的根本原因是其 Loader 机制与 Composer PSR-4 加载存在优先级冲突，TP 优先按自身规则查找类，导致命名空间重叠时跳过 Composer 加载。
Composer autoload 为什么在 ThinkPHP 中不生效
ThinkPHP 默认不会自动加载 Composer 安装的第三方类库，哪怕 vendor/autoload.php 已被引入，也常因命名空间解析失败或自动加载时机不对而报 Class not found 错误。根本原因在于 TP 的 Loader 机制和 Composer 的 PSR-4 自动加载存在优先级冲突——TP 会先尝试用自己的映射规则找类，找不到才 fallback 到 Composer，但若类名与 TP 的目录约定（如 app\library\）发生重叠，就会跳过 Composer 加载。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认已执行
composer install或composer require vendor/package，且vendor/autoload.php在入口文件public/index.php中被正确引入（TP6/TP8 默认已有，TP5.1 需手动加） - 避免在
app/library/下新建与 Composer 包同名的目录（例如装了monolog/monolog，就别再建app/library/Monolog） - TP6+ 推荐用
think\facade\Env或think\Container手动注册自动加载器，而不是依赖默认 fallback
TP5.1 中 require 第三方类库的兼容写法
TP5.1 的 Loader 未原生支持 Composer PSR-4，直接 new 一个 Composer 包里的类，大概率触发 ClassNotFoundException。这不是路径问题，是 Loader 根本没把 vendor/ 加入搜索范围。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在
application/common.php或public/index.php顶部显式引入：require_once __DIR__ . '/../vendor/autoload.php';
- 若类需在控制器中频繁使用，可在控制器构造函数里做一次绑定：
$this->log = new \Monolog\Logger('name');而不是依赖Loader::import() - 禁用 TP5.1 的类映射缓存（
php think clear:route不够，要删runtime/cache/下的*_classmap.php）
TP6+ 使用 facade 封装 Composer 包的注意事项
很多人照搬文档写 use think\facade\Log，就想当然地以为换成 use think\facade\GuzzleHttp 也能用——但 GuzzleHttp 并非 TP 官方 facade，直接 use 会报 Facade class not found。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- TP6 的 facade 是“伪静态代理”，必须先在
config/app.php的facade数组中注册对应门面类，例如：'facade' => [\think\Facade::class => [\think\facade\Log::class, \GuzzleHttp\Pool::class],]
（注意：Pool 不是 facade，这里仅示意结构） - 更稳妥的做法是：不封装 facade，直接在需要处
use GuzzleHttp\Client;，然后$client = new Client(); - 若想统一管理，可自定义一个
app/facade/Guzzle.php，继承think\Facade，并在其getFacadeClass()中返回GuzzleHttp\Client::class，再配置进config/app.php
vendor 目录被误删或权限异常导致 autoload 失败
常见现象是本地开发正常，部署到 Linux 服务器后突然报 require(): Failed opening required 'vendor/autoload.php'，或者提示 Permission denied。这通常不是代码问题，而是部署流程遗漏或用户权限错配。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查
vendor/是否真的存在：TP6+ 默认不提交 vendor 到 Git，CI/CD 流程中必须执行composer install --no-dev - Linux 下确认 web 用户（如 www-data、nginx）对
vendor/有读取权限：chown -R www-data:www-data vendor/
（不要用777） - TP8 开始支持
composer install --optimize-autoloader，上线前务必加上，否则大项目下class_exists()检查可能变慢甚至超时
真正卡住人的，往往不是 composer.json 写错，而是 autoload.php 引入位置太靠后、vendor 权限没同步、或者 TP 版本 loader 行为差异没被意识到。多看一眼 composer dump-autoload -v 的输出，比反复清缓存有用得多。
