必须在构建阶段执行composer install --no-dev --optimize-autoloader --classmap-authoritative,否则冷启动达920ms;仅加--optimize-autoloader或仅运行dump-autoload无效,因前者不剔除dev包导致classmap缺失,后者不更新installed.json且不校验lock文件。

必须在构建阶段执行 composer install --no-dev --optimize-autoloader --classmap-authoritative,否则冷启动会卡在 900ms 级别;只加 --optimize-autoloader 或只跑 composer dump-autoload -o 都不生效。
为什么 composer install --optimize-autoloader 在 Serverless 里必须配 --no-dev
因为 --optimize-autoloader 只对 require 块中声明的包生效,require-dev 里的类默认不进 classmap。但很多 dev 包是隐式运行时依赖:比如 symfony/var-dumper 被日志组件调用,sebastian/environment 被 SDK 底层引用。漏掉 --no-dev 会导致 classmap 缺失,冷启动直接报 Class not found。
实操建议:
- 先跑
composer install --no-dev,再执行composer dump-autoload -a触发一次完整 autoload 检查 - 报错后用
composer depends vendor/package(需 Composer 2.5+)查谁在依赖它 - 确认是真需要,就从
require-dev挪到require,哪怕只是“可选但存在即用”
--classmap-authoritative 不是可选项,是 Serverless 冷启动刚需
默认 PSR-4 自动加载靠 file_exists() 和 stat() 动态扫描整个 vendor/ 目录,Serverless 每次冷启动都重来一遍——单次轻松破 600ms。--classmap-authoritative 强制只走 autoload_classmap.php 查找,彻底禁用 fallback 路径。
但它只在以下条件全部满足时才安全:
- 项目中没有
"files"类型自动加载(比如全局函数文件) - 没用
classmap扫描非标准目录(如插件目录、模板逻辑文件) -
autoload-dev未被错误合并进主 autoload(部署时必须加--no-dev) - 所有类名与文件路径严格符合 PSR-4 规则(大小写、命名空间末尾反斜杠、目录结构一一对应)
漏掉任意一条,就会直接失败,且错误信息不指向真实问题(比如拼写错误),而是静默 Class not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer dump-autoload --optimize 在 Serverless 构建中基本没用
这个命令只重写 autoload 文件,不重装包,也不校验 composer.lock,新加类可能根本不在 classmap 里。而 Serverless 构建必须保证依赖一致性,所以必须用 composer install 触发完整流程:锁定依赖 → 全量扫描 → 写入 vendor/composer/autoload_classmap.php → 强制只走 classmap 查找。
常见错误:
- 只跑
composer dump-autoload --optimize:不更新installed.json,新加类白搭 - 漏掉
--classmap-authoritative:autoload 回退 fallback 路径,慢得更隐蔽 - 误以为
autoload_classmap.php越大越好:PHP 7.4+ 下每次冷启动都要require整个文件进内存,但单次请求通常只用其中不到 5% 的类
怎么让 classmap 真正变小,而不是假装瘦身
光删 tests/、docs/ 目录不够,关键是要从安装源头剔除——zip 解压时就不放进去,不是装完再扫。
实操建议:
- 在
composer.json里加"archive": {"exclude": ["/tests/", "/docs/", "/examples/", "/.github/"]},对每个大包单独配(如monolog/monolog) - 项目根目录加
.gitattributes,写/tests export-ignore等,配合--prefer-dist确保打包时彻底排除 - 检查第三方包是否含 demo 或 fixture:用
composer show vendor/package看源码路径,必要时 fork 后删减再require
真正影响冷启动的,从来不是你写了多少行代码,而是构建时有没有把不该进 vendor/ 的东西,一并塞进 zip 包里。

















