类找不到的根本原因常是autoload.php未加载或psr-4映射失效：先验证autoload.php存在，再检查composer.json配置（如字段名、json格式、路径写法）、classmap与psr-4优先级冲突、多包同命名空间覆盖及文件名与类名大小写不一致。
autoload.php引入了但类还是找不到，先确认它真被加载了
很多“Class not found”根本不是映射问题，而是vendor/autoload.php压根没跑起来。CLI脚本里漏写require、Web入口用错__DIR__层级、Docker挂载导致__DIR__指向空目录——这些都会让自动加载器静默跳过。
在出错脚本最开头加这行：
file_exists(__DIR__ . '/vendor/autoload.php') || die('autoload.php missing');
如果直接崩掉，说明路径错了；如果没崩但class_exists('AppKernel')返回false，那就要往下查映射是否注册成功。
常见陷阱：
-
public/index.php里写require './vendor/autoload.php'——当前工作目录不一定是项目根目录，路径失效 - Docker中
/app挂载到宿主机非标准路径，vendor/autoload.php里硬编码的__DIR__指向错误目录，整个PSR-4映射数组为空 - 多个入口文件（如
404.php、cli/backup.php）各自require不同autoload器，互相覆盖
dump-autoload -v输出里没扫到你的命名空间，配置大概率废了
运行composer dump-autoload -v，终端会逐行打印扫描动作。如果连Scanning /path/to/project/app/ for namespace App都没出现，说明composer.json里的autoload块根本没被识别。
检查点很具体：
-
composer.json里是不是拼成了"autoloader"而不是"autoload" - JSON格式是否合法：逗号结尾、中文引号、缩进混乱都会让整个autoload段静默失效
- PSR-4前缀末尾缺反斜杠：
"App": "app/"❌，必须是"App\": "app/"✅ - 路径写成
"./app/"或绝对路径"/var/www/project/app/"——Composer只认相对路径
验证方式：删掉vendor/composer/autoload_*.php再跑dump-autoload，避免旧缓存干扰。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
autoload_psr4.php里搜得到类名却仍报错，注意classmap和PSR-4的优先级
打开vendor/composer/autoload_psr4.php，搜索你的类名关键词（比如UserRepository），确认它映射到了正确路径。但如果映射存在却仍Class not found，大概率是classmap劫持了加载流程。
classmap是自动加载的第一道关卡，命中即返回路径，完全跳过PSR-4推导。这意味着：
- 你在
composer.json的classmap里写了"src/Cache.php"，那么new Cache()走classmap；但new AppCache()仍走PSR-4 - 如果某个第三方包把
Helper.php塞进了自己的classmap，而你项目里也有同名文件，PHP会在第二次加载时直接Fatal error: Cannot declare class Helper -
classmap路径必须是相对路径（如"lib/"），不能带./或绝对路径
执行composer dump-autoload -o会生成完整classmap列表，此时PSR-4仅作fallback，行为更确定，也更容易暴露冲突。
两个包都声明了"App\": "src/"，这不是bug是设计使然
Composer不做去重，也不校验前缀宽窄。两个依赖包都在各自composer.json里配了"App\": "src/"，它就会把两者全注册进autoload_psr4.php。后注册的覆盖前注册的——但PHP不允许同名类重复定义，运行时直接Fatal error: Cannot declare class AppHelper。
定位方法很简单：
- 用
composer show -t看依赖树，找有没有多个包同时声明了宽泛前缀（""、"App\"、"MyLib\"） - 检查所有
vendor/*/composer.json里的autoload.psr-4字段 - 运行
composer dump-autoload -v，看输出里是否重复出现同一命名空间（比如两行都含App\ => src/）
解法只有两个：改上游包的命名空间（不现实），或在你项目里用exclude-from-classmap屏蔽冲突文件——注意，这个只对classmap有效，对PSR-4无效；真正管用的是用代理类封装，把冲突文件复制进自己命名空间下并改名。
最易被忽略的一点：PSR-4映射生效的前提是文件路径与类名严格对应，且大小写敏感。Linux上UserService.php里声明class userservice，autoload能生成映射，但运行时一定失败——这种错不会在dump-autoload阶段报，得等真正调用才崩。
