composer autoload 导致类重复定义是因为 vendor/autoload.php 被多次 require，而其默认无防重入机制，重复注册映射并可能重复加载类文件；解决方法包括使用 require_once、手动定义 composer_autoload 常量、统一 bootstrap 入口、避免在类/配置文件中直接引入、区分 dev/production autoloader、隔离多 composer.json 的 autoloader 以及检查实际已加载文件。
composer autoload 为什么会导致类重复定义？
因为 vendor/autoload.php 被多次 require 或 include，而 Composer 的自动加载器默认不防重入——它每次加载都会注册一遍 PSR-4/PSR-0 映射，但类文件本身可能被反复 require_once 失效（比如用了 require），最终触发 Fatal error: Cannot declare class XXX。
- 常见于框架和插件各自
require 'vendor/autoload.php'，或测试脚本手动引入后又跑 CLI 命令 - 不是 Composer 本身 bug，而是加载时机没对齐：自动加载器可多次注册，但类文件不能重复解析
-
composer dump-autoload --optimize不解决这个问题，它只优化映射表，不控制 require 行为
怎么确保 vendor/autoload.php 只加载一次？
最直接的办法是用 require_once 替代 require，但前提是全局只有你控制入口；如果依赖第三方包也硬写 require，就得靠 Composer 自身机制兜底。
- Composer 生成的
vendor/autoload.php开头有if (defined('COMPOSER_AUTOLOAD')) return;检查 —— 但这个常量**默认不定义**，得你自己加 - 在首次加载前手动定义：
define('COMPOSER_AUTOLOAD', 1); require 'vendor/autoload.php'; - 更稳妥的是统一入口：所有脚本都通过一个 bootstrap 文件加载 autoload，且该文件用
require_once - 不要在类文件、配置文件里直接
require 'vendor/autoload.php'，这类位置容易被多次包含
autoload-dev 和 production autoloader 冲突怎么办？
开发时启用了 autoload-dev（比如 tests/ 下的类映射），上线却忘了删掉或切环境，可能导致测试类在生产被加载，甚至与主代码同名冲突。
- 检查
composer.json中autoload-dev是否误含了生产会加载的路径 - 发布前运行
composer install --no-dev，它会跳过autoload-dev并生成精简版autoload_static.php - 注意：即使用了
--no-dev，如果你的代码里显式require 'tests/Helper.php'，照样会崩 —— 自动加载器不拦手写 require - 用
composer dump-autoload --classmap-authoritative可禁用动态查找，避免意外命中 dev 类，但要求所有类都在 classmap 里
多个 composer.json 共存时 vendor 加载混乱
微服务或插件体系中，主项目和子模块各有一个 composer.json，require 后出现两个 vendor/autoload.php，彼此不知道对方存在。
- 不要让子模块自己
require 'vendor/autoload.php'；改用主项目的 autoloader，通过autoload.files或psr-4把子模块源码纳入主项目加载范围 - 子模块若必须独立运行，就别共享 vendor，用
composer create-project或path仓库方式接入，而非直接require目录 - 检查
vendor/composer/autoload_*.php文件名是否重复（比如两个项目都用了默认命名），可通过composer config autoloader-suffix MySuffix隔离 - 运行
composer show --tree看依赖图谱，确认有没有同一包被不同路径引入两次
真正麻烦的不是 autoload 逻辑本身，而是那些「看起来没加载却偷偷被 include」的配置文件、工厂类、或者 IDE 自动补全带进来的 require。盯住 get_included_files() 输出，比猜快得多。
