生产环境必须启用 classmap-authoritative 模式：执行 composer install --no-dev --optimize-autoloader --classmap-authoritative，确保 classmap 覆盖全部运行时类并禁用 fallback，同时清理框架缓存而非 composer 缓存。
生产环境没有“无缓存模式”这回事——Composer 的 autoload 机制天生依赖缓存（classmap、PSR-4 映射表），所谓“无缓存”只是没启用优化，反而更慢、更不可靠。 真正该做的是：关闭动态查找、禁用 fallback、确保 classmap 覆盖全部运行时类，并清理框架层缓存。下面分三步说清怎么做、为什么、以及最容易翻车的地方。
为什么不能用 composer dump-autoload 单独生成 classmap
很多人在部署脚本里写 composer dump-autoload -o，以为这就启用了生产优化。其实 Composer 2.x 默认已跳过完整 classmap 扫描，除非你显式声明了 "classmap" 字段或项目里有兼容性 fallback。这个命令大概率不生成任何新映射，vendor/composer/autoload_classmap.php 还是空的或只有 vendor 包条目。
- 真正生效的是
composer install --no-dev --optimize-autoloader --classmap-authoritative—— 它强制重扫、校验 lock、剔除 dev 依赖、生成权威 classmap - 漏掉
--classmap-authoritative（或简写-a），Composer 仍会在 classmap 查不到时 fallback 到 PSR-4 目录遍历，多一次stat()调用，可能更慢 - 漏掉
--no-dev，dev 依赖的类不会进 classmap，但它们的 autoload-dev 配置残留会导致 fallback 触发，整个权威模式失效
如何验证 classmap 是否真覆盖了所有生产类
别只看命令有没有报错。部署后立刻检查两个地方：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
vendor/composer/autoload_classmap.php，搜索你的主命名空间（比如App\），确认它是一张带绝对路径的数组，而不是空数组，也不是只有vendor/下的条目 - 用
strace -e trace=stat php -r "new AppModelsPost();"看是否还有大量stat("/path/to/src/Models/Post.php")失败调用；没有，说明 fallback 已关闭 - 动态拼类名（如
$class = $prefix . 'Handler'）不会进 classmap，得提前require_once或改用class_alias()；Laravel 路由闭包、Symfony 服务里的匿名类也必须显式声明在 autoload 规则下
部署后必须清理的不是 Composer 缓存，而是框架缓存
即使 classmap 正确生成，Laravel 的 config:cache、view:cache 或 Symfony 的 cache:clear 如果没清，新类照样“加载失败”——这不是 autoload 问题，是缓存层遮蔽了真实状态。
- 不要在
post-install-cmd里跑php artisan config:clear，此时vendor/autoload.php可能还没写入，artisan 会直接报Class 'Illuminate\Foundation\Application' not found - 改用
post-autoload-dump阶段："post-autoload-dump": ["@php artisan config:clear --no-interaction --env=production", "@php artisan view:clear --no-interaction --env=production"] - 如果用了 opcache，还要确认
opcache.preload文件里没写class_exists()或new，否则 FPM 启动失败
最常被忽略的一点：classmap-authoritative 模式下，任何未被扫描进表的类（比如 files 加载的 helper 里又 require 的临时类、测试用 Mock 类、AOP 织入代码）都会直接 Class not found。这些必须从 autoload 配置中剔除，而不是指望它“自动 fallback”。
