composer按前缀长度降序匹配psr-4，非配置顺序；前缀过短、反斜杠转义错误、大小写不一致、classmap与psr-4冲突或未更新等均会导致类加载失败且无明确报错。
PSR-4前缀重叠时谁生效
Composer按前缀长度**降序匹配**，不是按配置顺序。比如同时配了 "AppHttpControllers" 和 "App"，当加载 AppHttpControllersUserController 时，会优先命中更长的 "AppHttpControllers" 映射；但若该映射路径不存在（如配成 "AppHttpControllers": "src/controllers/" 却实际没有这个目录），Composer不会 fallback 到 "App"，而是直接失败。
常见踩坑点：
- 误以为“先写先匹配”，其实只看字符串长度，
"A"和"App"同时存在时，"App"总是优先生效 - 配了
"App"和"AppDev"，但AppDev类文件放在src/下——这时"AppDev"映射未覆盖到，而"App"又因命名空间不匹配跳过，结果类找不到 - 用 IDE 自动生成命名空间时多加了一个反斜杠（如
namespace App\Http\Controllers;），导致实际类名变成AppHttpControllersController→App\Http\Controllers\Controller，前缀匹配完全失效
PSR-4和classmap混用时类名冲突
同一个类名出现在 PSR-4 和 classmap 两种规则里，行为未定义。Composer通常以 PSR-4 为准，但 classmap 扫描结果可能被缓存，导致本地能跑、CI 构建失败。
典型错误场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"psr-4": {"App": "src/"}+"classmap": ["src/Utils.php"]，而Utils.php里定义了class AppUtils——PSR-4 要求AppUtils必须在src/Utils.php且 namespace 是App，否则不触发；classmap 会扫到它，但若后续删掉该文件，classmap 不自动更新，autoload_classmap.php 里还留着旧记录 - 把测试工具类（如
TestHelper）放进autoload-dev的 PSR-4，却在生产环境 require 了vendor/autoload.php（没加载 dev 配置），又没在autoload里补 classmap → 类直接消失 - 用
composer dump-autoload -o生成优化版后，再改 classmap 路径却不加-a（强制重扫），新增类永远不会进 autoload_classmap.php
命名空间末尾反斜杠漏写或写错
JSON 中必须写成 "App\"（两个反斜杠），PHP 解析后才是带一个反斜杠的字符串 "App"。漏写或写成 "App"（一个反斜杠）会导致整个 PSR-4 条目被忽略——Composer 认为这是 PSR-0 兼容写法，而现代版本默认不启用 PSR-0。
验证方法很简单：
- 运行
composer dump-autoload后，直接var_dump(include 'vendor/composer/autoload_psr4.php'); - 如果数组里根本没有你的键（如
"App\"），基本就是 JSON 写法错了 - 注意：IDE 自动转义可能把
"App\"显示成"App"，但源码里必须是两个反斜杠
Linux下大小写错位导致“本地正常、线上报错”
Windows 不区分 src/Http/Controllers/ 和 src/http/controllers/，但 Linux 会严格判断。Composer 的 PSR-4 拼接路径时不做大小写归一化，namespace AppHttpControllers; + "App\": "src/" → 拼出 src/Http/Controllers/，如果实际目录是 src/http/controllers/，就彻底失败。
关键细节：
- 类文件名也必须首字母大写：
UserController.php✅，usercontroller.php❌ - Git 默认不追踪文件名大小写变更，
git mv UserController.php usercontroller.php后，Linux 上旧文件残留，新文件无法覆盖 - CI/CD 流水线建议用 Linux 容器执行
composer dump-autoload -v | grep -i 'app\'，确认扫描路径和实际文件系统一致
composer.json，别急着跑应用，先 var_dump(include 'vendor/composer/autoload_psr4.php') 看映射表里有没有你写的那行。
