根本原因是psr-4映射路径未匹配当前项目真实路径，或vendor被跨项目复用导致__dir__错位；需重建vendor、执行composer dump-autoload -o，并核对autoload_psr4.php中命名空间映射是否指向当前项目绝对路径。
升级后 autoload 冲突不是自动加载器坏了，是 PSR-4 映射没对上当前项目路径，或多个项目误共享 vendor 导致 __DIR__ 错位。
为什么 vendor/autoload.php 加载成功但类还是找不到
常见现象：composer install 成功、vendor/autoload.php 能 require，但 new AppHttpControllersHomeController() 报错 Class not found。根本原因是 Composer 生成的 PSR-4 映射路径写死了绝对路径（比如 __DIR__ . '/../app/'），一旦 vendor 被复制、软链接复用，或被 COMPOSER_VENDOR_DIR 全局指定，映射就指向错误目录。
- 执行
php -r "echo require_once 'vendor/autoload.php';"确认文件可加载；若报failed to open stream，说明 vendor 路径本身已损坏 - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如"App\"），检查其值是否为当前项目app/的真实绝对路径 - 若值是
"/var/www/old-project/app/"，而你当前在/var/www/new-project/，说明 vendor 是从别处拷贝来的，必须重建
ThinkPHP 6 多项目共用 vendor 的典型翻车点
TP6 项目极易因手动复用 vendor/ 目录导致 autoload 冲突——它的 autoload.php 里硬编码了 __DIR__，跨项目加载时 PSR-4 映射全部失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 立即检查系统环境变量：运行
echo $COMPOSER_VENDOR_DIR（Linux/macOS）或echo %COMPOSER_VENDOR_DIR%（Windows），若输出非空，必须删除该变量 - 逐项目执行：
rm -rf vendor composer.lock→composer install --no-dev --optimize-autoloader - 验证映射是否生效：在项目根目录下运行
php -r "echo __DIR__ . PHP_EOL;"，再对比vendor/composer/autoload_psr4.php中"App\"对应的路径是否一致
如何安全重建 autoload 映射而不重启服务
即使 vendor 已重建，旧缓存仍可能让 PHP 继续读取过期的 autoload_*.php 文件，尤其在 OPCache 启用时。
- 先清缓存：
composer dump-autoload -o—— 这会强制重写全部 autoload 文件并生成优化类映射 - 若仍不生效，手动删掉
vendor/composer/autoload_*.php（保留installed.json），再跑一次composer dump-autoload -o - OPCache 用户需额外执行：
opcache_reset()或重启 Web 服务器（如sudo systemctl restart php-fpm） - 生产环境建议加
--no-dev参数：避免require-dev中的测试工具污染 autoload 映射
最常被忽略的一点：TP6 和 Laravel 都依赖 vendor/autoload.php 的路径稳定性，但没人检查它是否真的指向当前项目。只要 autoload_psr4.php 里有一行映射错了，整个命名空间就失效——这不是代码问题，是路径快照没更新。重建 vendor + 强制 dump + 核对 __DIR__，三步缺一不可。
