Composer插件与autoload配置冲突时，插件可能劫持PSR-4映射导致命名空间被跳过或重定向；需检查是否重复声明同一命名空间、确认插件是否自动注册autoload、禁用插件验证映射、清理OPcache并同步校验vendor/autoload.php及autoload_psr4.php内容。
composer.json里插件声明和autoload配置打架了
插件（如composer/installers、phpstan/extension-installer）本身会修改 Composer 的加载逻辑，但如果你在composer.json里同时写了"type": "composer-plugin"又手动配了"autoload"，就容易触发冲突：插件可能劫持了 PSR-4 映射流程，导致你的命名空间被跳过或重定向。
常见现象是：composer dump-autoload -v输出里压根不出现你的命名空间前缀，或者vendor/composer/autoload_psr4.php中映射路径变成空数组或指向插件目录。
- 检查
composer.json是否在require里引入了插件，同时又在autoload段重复声明了同一命名空间（比如插件已自动注册"MyPlugin\": "src/"，你还手写了一遍） - 运行
composer show --plugins确认哪些插件已激活；若插件非必需，先临时注释掉require中的插件行，再composer update - 插件文档通常要求你**删掉**手动 autoload 配置——例如
phpstan/extension-installer会自动把phpstan-extension类型包的src/映射进 PSR-4，你再配一遍反而覆盖它
插件修改了vendor/autoload.php的加载顺序
某些插件（尤其是老版本composer/installers）会在vendor/autoload.php顶部插入自己的require语句，导致你的类文件还没被扫描，插件的 autoloader 就提前返回了。结果就是Class not found，但autoload_psr4.php里明明有你的映射。
验证方式：打开vendor/autoload.php，看是否在require __DIR__ . '/autoload_real.php';之前多出了一段插件注入的代码（常见于if (file_exists($vendorDir . '/myplugin/autoload.php')) { require ... }）。
- 不要手动删这段代码——下次
composer install会重写 - 升级插件到最新版，很多 v2+ 版本已改用 Composer 2.x 的
PluginInterface标准，不再侵入autoload.php - 若必须用旧插件，可加
"minimum-stability": "stable"并锁死插件版本，避免自动升级引入新行为
插件自带的classmap和你的PSR-4路径重叠
像hirak/prestissimo（已归档）或某些私有插件，会在composer.json里声明"classmap": ["src/"]，而你的项目也配了"psr-4": {"App": "src/"}。这时 Composer 会优先走 classmap，但 classmap 扫描时如果遇到无class声明的文件（比如src/helpers.php），就会中断整个映射生成，导致 PSR-4 规则失效。
现象是：composer dump-autoload -v卡在某个 PHP 文件报错，或autoload_classmap.php为空。
- 运行
composer dump-autoload -v --no-plugins绕过所有插件执行一次，看是否能正常生成映射——如果可以，问题就定位到插件 - 检查插件的
composer.json源码（通常在vendor/xxx/plugin-name/composer.json），确认其classmap字段是否包含你项目的目录 - 在你自己的
composer.json中，把"classmap"字段显式设为空数组："classmap": []，防止被插件继承污染
插件启用后OPcache没刷新，autoload行为被缓存
插件安装或更新后，vendor/autoload.php内容变了，但 PHP 的 OPcache 还在用旧的 opcode 缓存，导致自动加载器实际执行的是上一版逻辑——比如旧版插件没禁用 PSR-4 fallback，新版却启用了--classmap-authoritative，但缓存里还是旧规则。
这会导致最诡异的现象：重启 Web 服务无效，composer dump-autoload -o显示成功，但new AppSomeClass()仍报错。
- 部署插件后，必须强制清 OPcache：
php -r "opcache_reset();"（前提是opcache.enable=1） - CLI 环境下测试时，加
-d opcache.enable_cli=0彻底关闭 CLI 的 OPcache，排除干扰 - Apache + mod_php 场景下，仅重启 Apache 不够，得确认
opcache.revalidate_freq=0且执行了opcache_reset()
插件引发的 autoload 冲突最难 debug 的地方在于：它不报错，只让类“静默消失”。每次改完配置，别急着 reload 服务，先盯住vendor/autoload.php时间戳、autoload_psr4.php内容、以及composer dump-autoload -v的实时输出——三者必须同步更新，缺一不可。
