psr-4映射冲突导致“cannot declare class”错误，因多个配置重复声明同一命名空间前缀（如"app": "src/"），php加载同名类时直接终止；需检查autoload引入、composer.json格式、dump-autoload执行及映射路径准确性。
报 Fatal error: Cannot declare class 不是 Composer 没“修好”，而是两个 PSR-4 映射同时声明了同一命名空间前缀（比如都写了 "App": "src/"），PHP 在第二次加载同名类时直接终止——没有重试，不给提示，崩得干脆。
怎么确认是 PSR-4 映射撞车，不是文件没找到
先排除最常见低级错误：入口根本没走 autoload 流程。CLI 脚本里漏掉 require __DIR__ . '/vendor/autoload.php'; 太常见；Web 环境下用 file_exists(__DIR__ . '/vendor/autoload.php') 手动验证路径，$_SERVER['DOCUMENT_ROOT'] 和脚本实际位置经常不一致。如果 vendor/autoload.php 都没被引入，后面所有映射都是空谈。
接着删掉 vendor/composer/autoload_*.php，再跑 composer dump-autoload -v。观察输出里是否扫到了你的命名空间（如 appcontroller）和对应文件；如果完全没出现，说明 composer.json 的 autoload 字段压根没被识别——检查 JSON 格式（逗号漏了、缩进错、键名拼成 auto-load）、psr-4 键值对末尾有没有双反斜杠 。
PSR-4 映射树怎么重建才真正生效
composer dump-autoload 不是“刷新缓存”，它是重写 vendor/composer/autoload_psr4.php 这个映射数组。改了 composer.json 但不执行这步，代码永远找不到新类。
- 开发调试阶段用
composer dump-autoload --no-optimize：禁用 classmap，只靠 PSR-4 实时推导路径，能立刻响应新增文件 - 生产环境部署必须加
-o（composer dump-autoload -o）：生成 classmap 提升性能，但注意它只扫描当前已知类，新增文件不会自动包含 - 如果同时用了
autoload-dev，加-a参数（composer dump-autoload -a）确保测试类也被纳入，否则 PHPUnit 可能报Class not found
执行命令时必须在 composer.json 所在目录，否则读不到配置；路径写错（如 "App": "../src/"）或大小写不一致（src/Http/ vs src/http/）都会导致映射生成失败，且静默跳过。
为什么两个包都声明 "App": "src/" 就会崩
Composer 不校验命名空间冲突，它把所有 PSR-4 规则原样注册进 PHP 的 autoloader 链。一旦你项目和某个依赖包都配了 "App": "src/"，new AppHelper() 第一次可能加载 A 包的 src/Helper.php，第二次尝试加载 B 包同名文件时，PHP 直接报 Fatal error: Cannot declare class AppHelper。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
检查方式很简单：
- 运行
grep -r '"autoload":' vendor/*/composer.json，看哪些包用了宽泛前缀（如"App": "src/"或"": "src/"） - 打开
vendor/composer/autoload_psr4.php，搜索'App\'，确认是否有多条映射指向不同路径 - 你自己项目中，绝不要把多个第三方包的源码目录塞进同一个命名空间下——哪怕只是放一个
Helper.php
临时解法可用 exclude-from-classmap 屏蔽冲突文件，但这对 PSR-4 无效；长期方案是推动包作者收紧前缀，例如从 "App": "src/" 改成 "VendorNamePackage": "src/"。
最容易被忽略的 PSR-4 细节
命名空间键末尾必须是双反斜杠 ，JSON 里写成 "App\": "src/"，PHP 解析后才是 App。漏掉一个，Composer 会把 AppServicesFoo 解析为 srcServicesFoo.php（少了一层目录分隔），而不是 src/Services/Foo.php。
路径值推荐不加尾部斜杠（"src" 而非 "src/"），避免部分 Composer 版本警告；大小写必须严丝合缝——Linux/macOS 下 src/Controller/ 和 src/controller/ 是两个目录，IDE 或 Git 设置可能导致不一致却难以察觉。
最后提醒一句：PSR-4 映射顺序不决定优先级，但前缀长度决定匹配结果。“AppHttp” 会比 “App” 先匹配，所以具体前缀要放在宽泛前缀之前，否则宽泛规则会截胡。
