Composer自动加载未生效，首先确认是否真在使用autoload机制：修改psr-4映射后需执行composer dump-autoload，类文件路径与命名空间必须严格符合PSR-4规则，且需检查autoload_static.php中是否存在对应映射。
Composer自动加载没生效？先确认是否真在用autoload机制
很多问题根本不是 autoload 故障，而是误以为 composer dump-autoload 或修改 autoload 配置会影响已安装的包——它只影响你项目根目录下 vendor/autoload.php 加载时的行为，对 vendor/composer/autoload_*.php 中已生成的映射无 runtime 影响。如果你改了 psr-4 映射却没重新 dump，或者类文件没放在声明路径下，class not found 就是必然结果，不是“加载过程出错”，而是压根没注册进 map。
- 运行
composer show -s查看当前 autoload 配置是否符合预期 - 检查
vendor/composer/autoload_static.php（或autoload_classmap.php）里有没有你期望的类名 → 文件路径映射 - 确认类文件命名和命名空间严格匹配 PSR-4 规则，比如
AppServicesUserService必须对应src/Services/UserService.php，不能是src/services/userservice.php
想看 class 是怎么被 require 进来的？启用 Composer 的 autoload debug 模式
Composer 本身不提供 verbose 日志，但你可以用 PHP 的 spl_autoload_register 钩子 + debug_backtrace() 快速定位谁触发了加载、走的是哪条 autoload path。
// 在 require vendor/autoload.php 后立即插入
spl_autoload_register(function ($class) {
echo "[AUTOLOAD] Trying to load: {$class}
";
$trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
if (isset($trace[1]['file'])) {
echo " called from {$trace[1]['file']} ({$trace[1]['line']})
";
}
}, true, true);
注意：这个钩子必须在 vendor/autoload.php 被 require 之后注册，否则会覆盖 Composer 自己的 loader；第二个 true 参数表示 prepend，确保它最先执行。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要在生产环境长期开启，有明显性能开销
- 如果输出中没看到你的类名，说明根本没走到 autoload 阶段——可能是命名空间写错、use 语句漏了、或被其他 autoloader（如 Zend Framework 的旧 loader）提前拦截了
- Composer 默认使用
ClassLoader::findFile()查路径，它的逻辑在vendor/composer/ClassLoader.php里，可直接断点调试
dump-autoload 生成的文件为什么和预期不一致？重点看 autoload_psr4.php 和 autoload_static.php
Composer v2+ 默认启用静态加载（autoload_static.php），它把所有 PSR-4 映射编译成静态数组，比动态遍历快得多，但也更难调试——你改了 composer.json 却忘了 composer dump-autoload --optimize，那新规则就不会进 static map。
-
autoload_psr4.php是原始映射（key 是 namespace + ，value 是路径数组），适合快速验证配置是否被读取 -
autoload_static.php是优化后结构，包含$prefixLengthsPsr4和$prefixDirsPsr4，如果 namespace 带多级子目录（如MyVendor\Api\V2\），要确认$prefixLengthsPsr4里有没有对应前缀长度 - 运行
composer dump-autoload -o -v看详细输出，它会告诉你跳过了哪些空目录、合并了几个相同前缀
require 一个类却报错说文件不存在？检查 ClassLoader::findFile() 的实际行为
最终决定“哪个文件该被 include”的是 ClassLoader::findFile() 方法，它按顺序查：PSR-4 → PSR-0 → classmap → files。常见陷阱是多个 PSR-4 规则产生路径重叠，比如同时写了 "App\": "src/" 和 "App\Controllers\": "app/Controllers/"，后者会被前者优先匹配到 src/Controllers/ 下找文件。
- 在
vendor/composer/ClassLoader.php的findFile()开头加var_dump($class); die;可立刻看到当前查找目标 - 检查返回路径是否真实存在：
file_exists()返回 false 很可能是因为大小写不一致（尤其 macOS/Linux 下敏感） - 如果用了
files类型 autoload，注意它只在每次请求时 require 一次，不会根据类名动态加载，也不支持命名空间
composer.json 后没 dump-autoload，或者以为 vendor/autoload.php 是魔法入口，其实它只是启动了一个基于静态数组的查找器。 
