“Class not found”主因是自动加载未生效：未引入vendor/autoload.php、composer.json autoload配置错误、dump-autoload未更新classmap、PHP语法/BOM/临时文件干扰扫描，或OPcache未刷新。
“Class not found”不是 Composer 崩了，而是它压根没看到你的类——或者看到了，但路径、命名空间、文件结构三者对不上。
vendor/autoload.php 根本没被 require 到
很多报错看着像 autoload 失败，实际是入口脚本连自动加载器都没引入。PHP 不会自动找 vendor/autoload.php，你得亲手 require 它。
- 用
file_exists(__DIR__ . '/vendor/autoload.php')手动验证路径是否存在；执行位置不同（CLI 当前目录 vs Web 的DOCUMENT_ROOT），相对路径极易失效 - 别写死
../vendor/autoload.php或../../vendor/autoload.php—— 目录一动就断 - 检查报错堆栈里有没有
vendor/autoload.php相关路径；如果没有，基本可判定是入口缺失require -
php -l vendor/autoload.php看语法是否合法（极少数因权限或 BOM 导致解析失败）
composer.json 的 autoload 配置不合规
Composer 只按 composer.json 里写的路径和命名空间扫描，写错一个字符，类就进不了映射表。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PSR-4 路径末尾必须带反斜杠：
"App\": "src/"✅，"App\": "src"❌（少斜杠会导致拼接出错） - 检查缩进、逗号遗漏、引号不闭合等 JSON 语法错误——
composer dump-autoload -v输出里如果压根没出现你的命名空间，大概率是配置没被识别 - 新增类后仍报错？先确认它所在的目录是否在
autoload或autoload-dev字段中声明过；没声明，dump-autoload再跑十遍也没用 - 开发依赖里的类（如测试工具、命令行命令）需显式加
--dev：composer dump-autoload -o --dev
dump-autoload 没真正刷新 classmap
composer dump-autoload 默认只更新 PSR-4 映射和 autoload_static.php，不会重建 autoload_classmap.php —— 这个文件只在 install 或 update 时生成，除非你加 -a 或项目里明确定义了 "classmap"。
- 想强制重扫所有类并写入 classmap，得用：
composer dump-autoload -o -a - 生产部署请直接用：
composer install --no-dev --optimize-autoloader；dump-autoload -o在多数项目里根本不会生成或更新autoload_classmap.php - 删掉
vendor/composer/autoload_*.php再重跑，避免旧缓存干扰；特别是移动/重命名类文件后，残留映射会导致“类存在却找不到” -
--classmap-authoritative（或-a）开启后，Composer 彻底放弃 fallback 查找——类不在 classmap 里就直接报错，不尝试拼路径；这能暴露漏扫问题，但也意味着每次改类都得重新 dump
文件本身导致扫描中断或映射错误
Composer 扫描 autoload 目录时，会逐个 token_get_all() 解析所有 *.php 文件。一个语法错误、BOM、临时文件（.php.swp、config.example.php），就能让整个 dump 过程卡住或跳过后续路径。
- 运行
composer dump-autoload -vvv，看最后成功解析的是哪个文件；卡点往往就是那个非法 PHP 文件 - 用
find src/ -name "*.php" -exec php -l {} ; 2>/dev/null | grep -v "No syntax errors"批量检测语法 - 在
composer.json中排除干扰项："exclude-from-classmap": ["src/Config/example.php", "src/Helpers/old_*.php"] - 别在 autoload 路径下放纯文本模板、配置示例或无
<?php标签的文件——它们会被当作 PHP 解析，然后失败
最常被忽略的一点：OPcache 缓存了旧的 opcode，哪怕 autoload_classmap.php 已更新，PHP 仍可能用着旧路径。部署后务必 opcache_reset() 或重启 FPM，否则一切 dump 都白做。
