类映射冲突主因是psr-4与classmap对同一类名重复覆盖，或多个psr-4前缀路径重叠导致类被映射两次；须删冗余配置、禁用混用、验证autoload_psr4.php中路径为真实绝对路径。
autoload类映射冲突不是“找不到类”，而是“找到两次”或“映射错位”——90% 的 case 是 PSR-4 和 classmap 同时覆盖了同一个类名，或者多个 PSR-4 前缀在目录结构上发生重叠推导。
PSR-4 命名空间前缀重叠导致类被加载两次
当两个 PSR-4 配置的路径存在父子关系，且命名空间前缀又能匹配同一类时，Composer 会把同一个类名映射到两个不同路径。比如：
-
"App\": "src/"→ 类AppHttpControllersHomeController映射到src/Http/Controllers/HomeController.php -
"App\Http\": "app/Http/"→ 同一个类名又可能被映射到app/Http/Controllers/HomeController.php
此时运行 composer dump-autoload -v 会显示两行匹配，而实际加载时行为未定义（PHP 可能报 Fatal error: Cannot declare class）。
解决方法：
- 删掉冗余的 PSR-4 条目，只保留最宽泛、结构最规范的那个（通常是
"App\": "src/"） - 确保所有类文件真实位于
src/下，且 namespace 声明与目录层级严格对应（src/Http/Controllers/HomeController.php必须声明namespace AppHttpControllers;） - 不要用
"App\Http\": "src/Http/"这类“截断式”配置——它违背 PSR-4 推导逻辑，容易漏类或错配
classmap 和 PSR-4 混用引发“两头不靠”
你既在 composer.json 中写了 "psr-4": {"MyLib": "lib/"}，又加了 "classmap": ["lib/Utils.php"]，但 Utils.php 里没写 namespace MyLib;。结果：
→ PSR-4 不认它（无匹配 namespace）
→ classmap 却因优化模式（--classmap-authoritative）被跳过或失效
→ 类彻底消失。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- classmap 是文件路径驱动，不检查 namespace；PSR-4 是 namespace 驱动，不关心文件是否存在
- 两者可共存，但**绝对禁止对同一个类名同时启用两种规则**（如
MyLibUtils既出现在autoload_psr4.php又出现在autoload_classmap.php） - 若要保留
Utils.php这种无命名空间工具文件，只用 classmap，并从 PSR-4 配置中移除"MyLib\": "lib/"
vendor/autoload.php 被多处 require 导致 autoloader 注册重复
尤其在 ThinkPHP 或 CodeIgniter 等框架中，框架自身已引入 vendor/autoload.php，你还手动在 index.php 或控制器里再 require 一次，就会触发 SPL autoloader 多次注册。后果是：
→ 类首次加载正常，第二次加载时报 Cannot redeclare class
→ 或某些包的初始化逻辑执行两次（如数据库连接、事件监听器）
- 检查入口脚本（如
public/index.php）是否已有require __DIR__.'/../vendor/autoload.php'; - 确认框架配置（如 CI3 的
$config['composer_autoload']）是否已开启，避免双重加载 - 用
get_included_files()在关键位置 dump，看vendor/autoload.php是否出现多次
autoload_psr4.php 映射路径错误但 dump-autoload 没报错
composer dump-autoload 成功不代表映射正确。常见静默失败场景：
- PSR-4 路径写成
"src"而非"src/"：Linux/macOS 下可能侥幸通过，Windows 下直接映射为空目录 - 路径含中文或空格，JSON 解析后未转义，导致
autoload_psr4.php里路径字符串损坏 - 用了
./src/或../src/这类相对路径：Composer 不支持，会被忽略，但不报错
验证方式：打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 "App\"），确认其值是形如 array('/var/www/project/src/') 的**绝对路径数组**，且该路径下真实存在对应文件。
真正容易被忽略的是：autoload 映射一旦生成，就和 composer.json 脱钩。改完配置不删 vendor/composer/autoload_*.php 就重跑 dump-autoload，旧映射仍可能残留——尤其当项目有 CI 构建机、Docker 多阶段构建或共享 vendor 目录时，这个问题会跨环境传染。
