autoload冲突本质是规则覆盖或路径推导错位，表现为类找不到、重复定义、环境差异崩溃；需检查vendor/autoload.php引入唯一性、PSR-4/classmap映射真实性及路径准确性。
autoload冲突不是配置“多了”，而是规则之间互相覆盖或路径推导错位，最常见表现是类找不到、重复定义、或开发环境能跑生产环境崩。
检查 vendor/autoload.php 是否被正确且唯一引入
很多“冲突”其实压根没走到 Composer 加载逻辑里，只是入口文件漏了、路径错了、或重复 require 了两次。
- 入口文件（如
public/index.php）第一行必须是require __DIR__ . '/../vendor/autoload.php';，不能是../vendor/autoload.php（少__DIR__）、也不能是./vendor/autoload.php（路径错层） - 确认该文件真实存在：
php -r "var_dump(file_exists(__DIR__ . '/../vendor/autoload.php'));" - 绝不能在控制器、中间件、配置文件里补这行——加载时机已过，无效
- 如果项目用了多个 autoloader（比如手动
require 'some/old/loader.php'），会和 Composer 的vendor/autoload.php冲突，删掉手动引入
验证 autoload_psr4.php 和 autoload_classmap.php 中的映射是否真实有效
这两个文件是 Composer 自动加载的最终执行依据，不是缓存，是真相。别猜，直接打开看。
- 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如"App\"），确认它映射到的路径是绝对路径，且指向你预期的目录（如$baseDir . '/src/'） - 打开
vendor/composer/autoload_classmap.php，搜你调用的具体类名（如"App\Controllers\HomeController"），看对应路径是否存在、拼写是否完全一致（注意大小写、斜杠方向、有无空格） - 如果 PSR-4 映射对得上但类还是找不到，大概率是路径推导失败：比如配置了
"MyApp\": "app/"，但类MyAppHttpControllersHomeController实际放在app/MyApp/Http/Controllers/HomeController.php—— 多了一层MyApp/，PSR-4 会截掉前缀后去拼Http/Controllers/HomeController.php，结果去找app/Http/Controllers/HomeController.php，自然失败
区分 PSR-4 与 classmap 的行为差异，避免混用导致“两头不靠”
PSR-4 是命名空间驱动，classmap 是文件路径驱动；两者可共存，但同一类名不能同时出现在两种规则中。
- PSR-4 要求：命名空间前缀（如
"App\"）必须和 PHP 文件里的namespace声明**严格一致**，包括末尾反斜杠；路径值（如"src/"）必须是相对于composer.json的真实相对路径，且**必须带尾部斜杠** - classmap 适合无命名空间的老代码或工具函数文件，但别把
tests/或examples/加进去——会被无差别扫入，徒增映射体积 - 常见误操作：在 PSR-4 下配了
"MyLib\": "lib/"，又在 classmap 里加了"lib/Utils.php"。这时 PSR-4 优先生效，但Utils.php如果没声明namespace MyLib;，就根本进不了加载流程；而 classmap 又被 PSR-4 覆盖掉，导致文件“两头不靠”
path 仓库或 vendor 共用引发的 autoload 失效
这类问题隐蔽性强，现象是“包存在但类找不到”，本质是 autoload 规则没注入主项目映射表。
- path 仓库的 autoload 配置只在
composer install或composer update vendor/name时被解析并写入vendor/composer/autoload_*.php；改完其composer.json后，只运行composer dump-autoload是无效的 - 多个 ThinkPHP 项目共用
vendor目录会导致autoload.php里硬编码的__DIR__指向错误路径，自动加载器彻底失效；必须清除COMPOSER_VENDOR_DIR环境变量，并逐个项目独立执行composer install和composer dump-autoload -o - 若用
repositories + path方式声明仓库，确保"options": {"symlink": true}已启用（尤其 Windows），否则某些文件变动可能被忽略
最易被忽略的一点：开发期别急着加 -o。它生成的 autoload_classmap.php 会跳过运行时路径拼接逻辑，直接查哈希表——路径配错了也能“碰巧跑通”，换台机器或清缓存就崩。日常调试先用无参数的 composer dump-autoload，确认路径拼接走通；上线前再补 -o。
