必须在构建阶段执行composer install --no-dev --optimize-autoloader --classmap-authoritative，它通过剔除dev依赖、生成扁平classmap、禁用fallback查找，将冷启动从920ms降至310ms；漏掉此步或误用dump-autoload会导致classmap缺失、加载回退慢路径。
composer install --no-dev --optimize-autoloader --classmap-authoritative 必须在构建阶段执行
冷启动慢，90%不是代码逻辑问题，而是 vendor/autoload.php 每次都得重新扫描整个 vendor/ 目录。默认的 PSR-4 自动加载器靠 file_exists() 和 stat() 动态找类，Serverless 每次冷启动都重来一遍——单次耗时轻松破 600ms。
真正起效的是这条命令：composer install --no-dev --optimize-autoloader --classmap-authoritative。它不是“加个参数就行”，而是一整套依赖锁定→扫描→写入 autoload_classmap.php 的完整流程。
-
--no-dev：直接剔除phpunit、phpstan等开发依赖，减小部署包体积（AWS Lambda 解压后限制 250MB） -
--optimize-autoloader：生成扁平classmap数组，跳过文件系统遍历 -
--classmap-authoritative：强制只查classmap，禁用所有 fallback 查找逻辑；查不到就报错，不拖慢启动
常见错误是只跑 composer dump-autoload --optimize —— 它不更新 vendor/composer/installed.json，也不校验 composer.lock，新加的类很可能不在 classmap 里，导致 Class not found 或加载回退到慢路径。
排除无关文件：exclude-from-classmap 和 .gitattributes 双保险
即使用了 classmap，如果 autoload 扫描范围过大，生成的 autoload_classmap.php 文件仍可能达数 MB。PHP 7.4+ + Composer 2.x 下，每次冷启动都要 require 整个文件进内存，但单次请求通常只用到其中不到 5% 的类。
精准收缩 classmap 范围，比压缩体积更重要：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的autoload段显式声明"exclude-from-classmap": ["tests/", "docs/", "examples/"] - 配合
.gitattributes设置export-ignore，确保打包时彻底剔除测试、文档等非运行时文件 - 检查第三方包是否含大量 demo 或 fixture 文件——用
composer show vendor/package-name查看源码路径，必要时 fork 后删减再 require
漏掉这步，--classmap-authoritative 反而会放大问题：classmap 越大，加载越慢，且错误更难定位。
PHP 运行时初始化开销常被低估
很多人以为优化完 autoload 就万事大吉，但冷启动还卡在 PHP 扩展加载和 php.ini 初始化上。Serverless 平台每次冷启动都会重走一遍扩展注册流程，不是“一次配置，永久生效”。
- 禁用无用扩展：
mysqli、pdo_pgsql、gd（尤其带 freetype 支持）等，每个可拖慢 80–150ms 启动 -
opcache.enable=1不够，必须配opcache.preload预热核心脚本（如vendor/autoload.php），否则只缓存 opcode，不加速首次 require - 确认
config.platform.php设为生产环境版本（如"8.2"），避免 Composer 因兼容性检查额外加载适配层
这些配置必须固化在 Dockerfile 或 Bref 的 php-config.ini 中，不能靠运行时 ini_set() 补救——冷启动时 PHP 进程还没起来，ini_set 根本没机会执行。
多函数共享 vendor：Layer 或统一镜像构建
当项目含多个函数（如 API Gateway 的不同路由 handler），重复打包 vendor/ 是典型冗余。同一套依赖被复制 N 份，既浪费存储，又拉长镜像拉取时间（冷启动第一阶段）。
- AWS Lambda 场景：把
vendor/打成 Layer，多个函数引用同一 Layer ID；注意 Layer 有 250MB 解压限制，需提前composer install --no-dev --prefer-dist压缩 - 容器镜像场景（如阿里云 FC、腾讯云 SCF）：用多阶段构建，在 builder 阶段执行
composer install，runtime 阶段只 COPYvendor/和代码，不重复安装 - 务必验证 Layer 或镜像中
autoload_classmap.php是否已按当前composer.lock重建——跨函数复用时，一个函数改了依赖，其他函数若没同步更新 classmap，照样Class not found
最易忽略的点：Layer 或镜像里的 vendor/ 是静态快照，一旦上线就不能动态 composer update。所有变更必须走 CI/CD 重新构建并发布新版本，否则冷启动性能优化等于白做。
