autoload冲突源于命名空间映射重复或缓存残留，导致类重复定义、找不到或加载错版本；需清理冗余PSR-4映射、删除旧autoload文件、执行composer dump-autoload -o重建缓存，并排查require-dev依赖及手动引入干扰。
autoload冲突不是自动加载没生效，而是命名空间映射打架或缓存残留导致类被重复定义、找不到、或加载错版本。
检查 psr-4 映射是否重复或越界
升级后（尤其是 Laravel 10+ 或 ThinkPHP 6+）默认启用 PSR-4 自动发现，旧项目若在 composer.json 中显式声明了子目录映射，就会和自动发现机制冲突，造成类找不到或重复加载。
- 删掉所有冗余的
"AppProviders"、"AppConsole"等子路径映射，只保留最顶层："App\": "app/" - 确认自定义命名空间（如
extend\、library\）在autoload和autoload-dev中没有重复声明 - ThinkPHP 项目中，避免
app/library/Payment.php命名空间写成applibraryPayment（少反斜杠），必须是applibraryPayment
清理并重建 autoload 缓存
Composer 的 autoload 文件（vendor/composer/autoload_*.php）可能残留旧映射，尤其跨大版本升级后，不重建就容易报 Class not found 或 Cannot declare class X, because the name is already in use。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先删掉
vendor/composer/autoload_*.php文件（不要删整个vendor/composer/目录） - 运行
composer dump-autoload -o（加-o强制生成优化映射，不加可能跳过重建） - 如果用的是 Laravel，再补一句：
php artisan config:clear && php artisan cache:clear
排查 require-dev 引入的隐性 autoload 冲突
开发依赖里常混着测试工具、代码风格检查器等，它们自带 autoload 规则，可能悄悄覆盖主项目映射，比如 laravel/pint 或 orchestra/testbench 在升级后仍绑定旧版 illuminate/support，间接污染自动加载逻辑。
- 运行
composer show --tree | grep -i "autoload|psr-4"，看是否有非预期包注册了同名命名空间 - 临时注释掉
require-dev下非必需项（特别是带testbench、pint、phpunit的），再跑composer dump-autoload -o验证是否恢复 - 确认没有手动
require或include同名类文件——Composer 和手写 include 混用是 autoload 冲突高发场景
验证 autoload 是否真生效
别只信报错信息，用 Composer 自己的诊断命令验证映射是否被正确注册：
- 执行
composer dump-autoload -v，观察输出里是否列出你关心的命名空间及对应路径 - 运行
composer show -p查看当前已激活的所有 autoload 规则（含 vendor 包的） - 在代码里加一行
var_dump(class_exists('App\Models\User'));，确认结果是true而非false或 fatal error
autoload 冲突最难 debug 的点在于：它不报明确错误，而是让类“时而存在、时而消失”，根源往往藏在 require-dev 或旧缓存里。每次升级后，dump-autoload -o 不是可选项，是必做动作；而 autoload 配置里多写的那一行映射，就是最常被忽略的导火索。
