psr-4路径写错导致class_exists()返回false，典型原因包括：路径缺斜杠、用相对/绝对路径、json字段名拼错、命名空间与目录结构不匹配、大小写错误、psr-4与classmap冲突；验证需运行dump-autoload -v并检查autoload_psr4.php。
composer.json里psr-4路径写错的典型表现
类文件明明存在，class_exists('App\Services\UserService')却返回false，composer dump-autoload -v输出里压根不出现App\前缀——这基本是psr-4配置本身没被解析成功。
常见错误包括：
-
"App\": "src"（缺末尾斜杠），某些系统会把src当成文件而非目录，跳过扫描 -
"App\": "./src/"（带./），Composer 不认相对路径写法，直接忽略整条规则 -
"App\": "/var/www/project/src/"（绝对路径），只在本地临时生效，CI/CD 构建时必然失败 - JSON 字段名拼错，比如写成
"psr4"或"psr_4"，Composer 完全无视
PSR-4命名空间与文件路径不匹配的硬性推导逻辑
PSR-4 不是“猜路径”，而是严格字符串截取+拼接。比如配置{"App\": "app/"}，类App\Http\Controllers\HomeController会被推导为：app/Http/Controllers/HomeController.php。
容易踩坑的点：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间声明少了一级，比如文件里写
namespace Http\Controllers;，但配置期望的是App\Http\Controllers - 目录结构多了一层，如实际路径是
app/App/Http/Controllers/HomeController.php，那就会去查app/Http/Controllers/HomeController.php，自然file_exists()失败 - 大小写不一致：Linux 下
app/Services/userservice.php≠app/Services/UserService.php，Windows 可能侥幸通过，部署到服务器就报错
混用psr-4和classmap时的映射覆盖问题
当你同时配置了psr-4和classmap，Composer 默认优先走 PSR-4 规则。如果某类名既在 PSR-4 映射里“查不到”，又在classmap里“没登记”，它就彻底消失。
典型冲突场景：
-
"psr-4": {"MyLib\": "lib/"}+"classmap": ["lib/Utils.php"]，但Utils.php里没有namespace MyLib;→ PSR-4 跳过，classmap 因未启用 fallback 也不生效 - 运行
composer dump-autoload -o后，autoload_classmap.php里有该类，但autoload_psr4.php里也有同名前缀 → Composer 以 PSR-4 为准，classmap 条目被静默忽略 - 想用 classmap 加载无命名空间的老代码，却忘了删掉
psr-4里对同一目录的配置，结果老文件被 PSR-4 扫描机制跳过（因无 namespace）
验证路径是否生效的三个必做动作
别靠猜，直接看 Composer 自己生成的映射文件和实时扫描日志。
- 运行
composer dump-autoload -v，盯住输出末尾有没有类似Adding PSR-4 autoload rule for App\ to src/的行；如果没有，说明配置根本没加载 - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'App\'），确认对应路径值是$baseDir . '/src/'这类拼接形式，而不是空数组或错误路径 - 手动执行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Services\UserService'));"，绕过框架缓存，直击自动加载器行为
composer.json，只要没跑dump-autoload -v看第一行输出，就永远不知道那条规则到底进没进映射表。
