“Cannot redeclare class”错误本质是同一类文件被多次加载，而非类未找到；主因是手动require与Composer自动加载机制混用导致路径重叠、重复包含。
为什么Cannot redeclare class不是类没找到，而是加载了两次
类重复定义错误（Fatal error: Cannot declare class XXX）本质是同一个类文件被 require 或 include 了多次，而不是自动加载失效。Composer 的 PSR-4 加载器本身不会重复加载——它只在第一次用到类时 require 一次。问题往往出在混合加载机制上：spl_autoload_register 手动注册、require_once 硬包含、CI/TP 框架的自有加载逻辑，和 Composer 的 autoload.php 同时生效，路径交叉重叠。
- ThinkPHP 项目中手动
include app/library/Payment.php，又通过命名空间use applibraryPayment触发 Composer 加载 → 同一文件被载入两次 - CodeIgniter 开启了
$config['composer_autoload'] = TRUE，但又在autoload.php配置里手动require APPPATH.'third_party/sdk/autoload.php'→ SDK 类被加载两遍 - 自定义
spl_autoload_register回调里用了require而非require_once，且未做文件存在性判断 → 多次触发即多次加载
vendor/autoload.php 和框架自带加载器谁该管什么
原则很明确：让 Composer 管有命名空间的类，框架或手动逻辑只管无命名空间的函数、老代码、配置类等。一旦越界，冲突几乎必然发生。
- Composer 的
vendor/autoload.php是生成文件，**绝不能手动修改**；它只响应composer.json中autoload字段的声明 - ThinkPHP 的
app/library/目录若走 PSR-4，必须在composer.json里配成"app\library\": "app/library/"（注意双反斜杠转义），再运行composer dump-autoload - CodeIgniter 的
application/config/autoload.php只负责$autoload['libraries']这类框架级组件，第三方 SDK 应全部交由 Composer 管理，$config['composer_autoload']设为TRUE即可，别额外 require - 全局 helper 函数（如
helpers.php）应放进composer.json的"files"数组，而非塞进 PSR-4 —— 否则每次类加载都顺带执行一遍函数定义
快速定位哪段代码在重复加载
不用猜，用 PHP 自带机制直接看调用栈。在报错前加一句临时调试代码：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
spl_autoload_register(function($class) {
$file = 'src/' . str_replace('\', '/', $class) . '.php';
if (file_exists($file)) {
echo "Loading $class from $file
";
require $file;
}
});
或者更直接：在疑似重复定义的类文件顶部插入：
if (class_exists('YourClass', false)) {
debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
die();
}
- 观察输出的
require路径是否一致；不一致说明不同加载器指向了同一物理文件 - 检查
vendor/composer/autoload_psr4.php中是否出现重复映射，比如"app\library\"被写了两次，或大小写混用（AppLibraryvsapplibrary） - 运行
composer dump-autoload -v，看终端是否提示 “Skipped … already mapped” —— 这表示配置里有冗余声明
修复后仍报重复定义？重点检查这三处
很多问题看似解决了，但部署后复现，根源常藏在这些容易被忽略的地方：
-
opcache.enable=1且opcache.revalidate_freq=0时，PHP 缓存的是编译后的 opcode，不是文件内容；即使你删了旧文件、重跑了dump-autoload，opcode 里还存着旧类定义。必须执行php -r "opcache_reset();"或重启 PHP-FPM - 多个 ThinkPHP 项目共用一个
vendor目录（通过COMPOSER_VENDOR_DIR环境变量或软链接），会导致vendor/autoload.php里的__DIR__指向错误根目录，PSR-4 映射全乱，不同项目的类可能被交叉加载 - 测试环境开了
autoload-dev，但生产环境跑的是composer install --no-dev，结果tests/下的 Mock 类被 dev autoloader 加载了一次，上线后又因某处require再加载一次
