Composer自动加载失败主因是PSR-4命名空间与文件声明不一致、路径非真实相对路径或未执行composer dump-autoload -o；需检查autoload配置、运行诊断命令、验证物理路径及类声明。
composer dump-autoload 时提示 Class XXX is not autoloaded
这通常不是真正的“冲突”，而是 Composer 检测到某个类在多个 autoload 规则中被声明（比如同时出现在 psr-4 和 classmap），但实际文件未被正确解析或路径未命中。真正要查的是：哪个 autoload 配置项最终“赢了”，以及它指向哪条物理路径。
关键动作不是看报错，而是用 Composer 自带的诊断命令定位加载源头：
- 运行
composer show -p查看当前项目所有已注册的 autoload 配置块（含 vendor） - 对疑似类执行
composer dump-autoload --no-scripts --verbose，注意末尾输出的 “Generating autoload files” 后面列出的实际映射文件，尤其是vendor/composer/autoload_classmap.php和vendor/composer/autoload_psr4.php - 直接打开
vendor/composer/autoload_static.php—— 这是最终生效的静态映射表，搜索类名就能看到它绑定的文件绝对路径
为什么 var_dump(get_declared_classes()) 找不到目标类
因为类还没被加载，get_declared_classes() 只返回已加载的类。Composer autoload 是 lazy 的，触发时机是第一次 new、static:: 或 class_exists($name, true)。
想验证某类是否能被 autoload 成功，最可靠方式是：
- 写一个最小测试脚本，只包含
require 'vendor/autoload.php';+var_dump(class_exists('Your\Class\Name')); - 启用 Composer 的 autoload 调试：在
composer.json中加"config": { "autoloader-suffix": "Debug" }，然后运行composer dump-autoload，再检查生成的vendor/composer/autoload_static.php文件名是否含 Debug 后缀 —— 这能确认配置已生效 - 临时在
vendor/autoload.php开头加echo "Autoload loaded\n";，排除自动加载器根本没被执行的低级错误
PSR-4 映射路径和实际文件路径不一致时怎么查
PSR-4 冲突往往源于命名空间前缀与目录结构不严格对应，例如 "App\": "src/" 但类 App\Http\Controller\Home 实际放在 src/Http/Controllers/Home.php（多了个 s）。这时 Composer 会静默跳过该类，不报错也不加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
排查步骤很直接：
- 用
composer config autoload.psr-4看当前 PSR-4 声明 - 手动拼接：把命名空间中的
\替换为/，去掉前缀，再拼到声明路径后 —— 比如App\Http\Controller\Home对应src/Http/Controller/Home.php - 用
find src -name "Home.php"（Linux/macOS）或dir /s src\Home.php（Windows）确认文件真实位置 - 对比两者差异，修正目录名、文件名或
composer.json中的映射前缀
vendor/composer/autoload_classmap.php 里有类但 still not found
说明这个类被 classmap 扫描进来了，但文件路径是扫描时的快照。如果之后移动了文件、改了内容却没重新 dump，classmap 就会指向一个已不存在的路径。
典型表现是：autoload_classmap.php 里写着 'SomeClass' => $vendorDir . '/foo/bar/SomeClass.php'，但该文件实际已删或重命名。
- 先检查该路径是否存在：
ls -l vendor/foo/bar/SomeClass.php - 若不存在，删掉整个
vendor/composer/目录，再composer install重建 - 若存在但类定义不对（比如命名空间写错），那问题不在 autoload 路径，而在文件本身 —— 此时
php -l vendor/foo/bar/SomeClass.php可快速验证语法和命名空间声明
classmap 的路径一旦生成就不会动态更新，这点和 PSR-4 不同，容易被忽略。
