psr-4映射异常是composer类找不到的头号原因，根源在于composer.json中psr-4配置、文件系统路径与命名空间三者未严格一致：前缀末尾必须为双反斜杠（如"app\": "app/"），路径大小写、反斜杠数量、目录真实存在性、namespace声明及文件位置均需完全匹配，且每次修改后须执行composer dump-autoload -o并清理缓存。
PSR-4映射异常是Composer类找不到的头号原因，不是代码写错了，而是composer.json里那几行配置和文件系统、命名空间之间“对不上号”——哪怕只少一个反斜杠、多一个大小写、路径用错相对位置，都会让自动加载器直接跳过整个目录。
检查psr-4前缀末尾反斜杠是否严格匹配
Composer把"App"当做一个完整前缀字符串来匹配类名，AppHttpController能命中，AppHttpController就完全失效。JSON中必须写成双反斜杠："App\": "app/"（实际值为单反斜杠），不能写成"App": "app/"、"App/": "app/"或"App/": "app/"。
- 运行
php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"，确认输出中App\对应的路径确实是app/ - IDE自动生成命名空间时容易漏掉末尾反斜杠，尤其从文件路径转换过来时，要手动补上
- Windows下大小写不敏感会掩盖问题，上线前务必在Linux环境用
class_exists('AppHttpControllerHomeController')验证
验证namespace声明与文件路径是否完全一致
PSR-4不解析语义，只做机械拼接：它把AppHttpControllerHomeController拆成App + Http/Controller/HomeController.php，然后拼到app/后面。只要任一环节错位，就加载失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 文件
app/Http/Controller/HomeController.php里必须写namespace AppHttpController;，不能是namespace appHttpController;（小写a）或namespace AppHttpController\（多一个反斜杠） - 路径
app/必须是相对于composer.json所在目录的真实存在目录，不能是软链接、不存在路径，也不能写成./app/或../app/ - 子目录名大小写必须和namespace完全一致，
app/http/Controller配AppHttpController在Linux下必然失败
清理autoload缓存并强制重生成映射
改完composer.json后不执行composer dump-autoload -o，或者执行了但没清旧缓存，就会继续走错误映射。更隐蔽的是CI构建机上没跑这步，导致线上环境一直失效。
- 每次修改autoload配置后，**必须执行**
composer dump-autoload -o（-o表示优化，生成静态查找表） - 怀疑残留缓存？直接删掉
vendor/composer/autoload_*.php全部文件，再跑dump-autoload -o，比反复重试更彻底 - 若项目含大量dev依赖，加
--no-dev避免干扰生产环境验证
警惕PSR-4和classmap混用引发的覆盖冲突
常见误操作：在psr-4里配了"MyLib\": "lib/"，又在classmap里加了"lib/Utils.php"。这时如果Utils.php没声明namespace MyLib;，PSR-4规则压根不触发，而classmap又被PSR-4优先级压制，结果就是文件两头不靠。
- PSR-4是命名空间驱动，classmap是路径驱动，两者可共存，但**同一类名不能同时出现在两种规则中**
- 无命名空间的老工具类才适合用classmap；新项目应统一用PSR-4，并确保所有文件都有正确namespace
- 运行
composer dump-autoload -v，观察输出中是否有Scanning lib/ for namespace MyLib\——没有就说明PSR-4根本没注册进去
最常被忽略的点是：你以为改完了composer.json，其实vendor/autoload.php里硬编码的__DIR__还指向旧路径，尤其在多个项目共用vendor或设了COMPOSER_VENDOR_DIR环境变量时，autoload映射会彻底错乱。这种情况下，删vendor、清环境变量、逐项目重装才是唯一解法。
