Composer autoload 未生效的根本原因是 composer.json 中 autoload 配置错误或未执行 composer dump-autoload；ThinkPHP 依赖 Composer 原生加载机制，不接管类加载逻辑。
Composer autoload 配置没生效，vendor/autoload.php 引入后类仍找不到
根本原因通常是 composer.json 里 "autoload" 段配置有误，或没重新生成自动加载映射。ThinkPHP 本身不接管 Composer 类加载逻辑，它依赖 Composer 原生的 PSR-4 / classmap 机制。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认
composer.json中"autoload"下的"psr-4"映射路径是相对项目根目录的，且结尾带反斜杠（如"app\": "app/"），Windows 下正斜杠也 OK，但不能漏掉末尾/或\ - 改完配置必须运行
composer dump-autoload（开发时可加-o生成优化版），仅composer install或update不会重刷 autoload（除非 vendor 被删） - 检查是否误用了
"autoload-dev"—— 这部分在生产环境默认不加载，composer install --no-dev后AppTestHelper这类类必然报错 - ThinkPHP 的
think命令行工具不会绕过 Composer 自动加载；如果用php think run能跑，但 CLI 直接php index.php报错，大概率是入口文件没引入vendor/autoload.php，或引入位置错了（必须在任何类使用前）
更新 ThinkPHP 主包后，第三方扩展包方法调用失败，提示 Call to undefined method
这不是 Composer 加载问题，而是版本兼容性断裂：ThinkPHP 6.1 升到 6.3 后，think acadeCache 的 remember() 方法被移除，但你装的某个扩展包（比如 topthink/think-queue）仍硬编码调用它。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
composer show topthink/framework确认当前框架版本，再查对应版本的官方 changelog（重点看 “Breaking Changes”） - 执行
composer depends <package-name>（如composer depends topthink/think-queue）看哪些包依赖它，再结合composer outdated判断是否该升级扩展包而非降级框架 - 别盲目删
vendor重装 —— 如果扩展包尚未适配新版 TP，重装只会复现错误；应优先查该扩展包 GitHub 的 issues 或 releases，找带tp6.3兼容标签的版本 - 临时绕过：若扩展包源码可控，可手动 patch 方法调用（例如把
Cache::remember()改成Cache::get()+ 手动判断逻辑），但需加注释说明是权宜之计
composer update 卡住或报 Could not parse version constraint
常见于 composer.json 里写了非法版本号，比如 "topthink/framework": "^6.2.0-beta" —— Composer 不识别 -beta 这种写法，正确应为 "^6.2.0@beta"；或者用了中文逗号、全角字符、换行符污染 JSON。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
composer validate检查composer.json语法，它会准确定位哪一行出错 - 避免手写版本约束，优先用
composer require topthink/framework:^6.3.0让 Composer 自己写进配置，减少格式错误 - 国内用户遇到卡在
Updating dependencies，大概率是 packagist.org 源慢或超时，执行composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该镜像已停更）或改用https://mirrors.aliyun.com/composer/（阿里云最新） - 如果只是想更新某几个包，别用
composer update全量更新 —— 它会重新计算所有依赖树，极易因锁文件冲突失败；改用composer update topthink/framework topthink/think-orm指定包名
ThinkPHP 控制器里 new 一个 Composer 包的类，报 Class 'xxx' not found，但 IDE 不报错
IDE 能跳转不代表运行时能加载 —— 大概率是那个包没在 composer.json 的 "require" 里声明，而是被其他包“间接依赖”进来，结果 composer install --no-dev 时被剪掉了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer show | grep xxx（把 xxx 替换成类名中的命名空间前缀，如overtrue），确认该包是否真在 vendor 里；不在就说明没被正式 require - 不要依赖“别人带进来”，显式执行
composer require overtrue/wechat:~5.0（以微信 SDK 为例），确保它出现在composer.json的"require"下 - 检查类名大小写：PHP 是大小写敏感的，
new WeChatServer()和new WechatServer()是两个类，Composer 自动加载按命名空间和文件路径严格匹配 - 确认该包是否含 autoload 配置：有些老包只提供函数式 API，没定义
"autoload"，此时需手动require_once对应文件，不能指望 Composer
最常被忽略的是：以为 composer update 就万事大吉，其实它只管依赖声明和下载，autoload 映射是否生效、版本是否真兼容、环境是否启用了 dev 包——这些都得一个个对齐，缺一不可。
