serverless 函数实例启动时无写权限、无 php cli、无网络、无 zip 扩展，导致 composer install 静默失败或报 permission denied；依赖必须在 ci 构建阶段用匹配运行时的 docker 镜像执行 composer install --no-dev --optimize-autoloader --classmap-authoritative --prefer-dist，并运行 composer dump-autoload --optimize --classmap-authoritative，确保生成 autoload_static.php，且 require 路径为绝对路径，同时清理 vendor 中冗余文件并校验解压后体积。
为什么不能在函数运行时执行 composer install
Serverless 函数实例启动时没有写权限、没有 PHP CLI、没有网络、也没有 zip 扩展，composer install 会静默失败或直接报 Permission denied。这不是配置问题，而是平台限制——所有依赖必须在 CI 构建阶段完成安装和压缩。
如何让 composer install 在构建阶段真正生效
关键不是“跑完命令”，而是确保生成的 vendor 可加载且体积可控。以下步骤缺一不可：
- 用与目标运行时完全一致的 Docker 镜像（如
bref/php-82-fpm或阿里云 FC 的 PHP 8.2 runtime 镜像）执行安装 - 必须加参数：
composer install --no-dev --optimize-autoloader --classmap-authoritative --prefer-dist - 安装后立即追加：
composer dump-autoload --optimize --classmap-authoritative，否则autoload_static.php不生成，冷启动时类找不到 -
require __DIR__ . '/vendor/autoload.php'路径必须绝对，不能写成require 'vendor/autoload.php'，ZIP 解压后目录结构决定路径可靠性
怎么避免镜像配置失效导致拉取慢
换源 ≠ 提速，90% 的“还是慢”源于配置未真正生效。验证和修复要点：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 华为云镜像正确地址是：
https://mirrors.huaweicloud.com/repository/php/composer/（结尾必须有/，type 必须为composer） - 全局配置命令只有一条：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/（键名错一个字母如repos.packagist就静默失效） - 检查是否被项目级
repositories覆盖：composer config -l | grep repositories；空对象"repositories": {}也会屏蔽全局镜像 - 启用并发下载：
composer config -g parallel-downloads 8（默认仅 3 线程，不开等于白配镜像） - 验证真实请求：
composer show monolog/monolog -vvv 2>&1 | grep -i url，看到内网或镜像域名才算成功
压缩后体积仍超限？清理和校验比打包更重要
ZIP 文件大小不关键，解压后体积才是硬限制（如 AWS Lambda 250MB）。常见冗余来源和清理动作：
- Composer 默认下载的
.dist包含大量.md、tests/、.git/、docs/目录，单个包可贡献 10MB+ - 执行清理命令：
find vendor -name "*.md" -o -name "tests" -o -name ".git" -o -name "docs" | xargs rm -rf - 在
composer.json中声明："exclude-from-classmap": ["tests/", "Tests/", "test/", "Test/"]，否则--classmap-authoritative仍会扫描这些路径 - 用
.gitattributes声明：vendor/** export-ignore，进一步减小 CI 源码体积 - 最后校验：
du -sh vendor看解压后大小，而不是只看 ZIP 文件
真正容易被忽略的是：autoload_static.php 是否存在、require 路径是否基于 ZIP 根目录、以及清理动作是否在 dump-autoload 之后执行——三者任一出错，都会导致函数启动失败，而非超限报错。
