必须在本地或CI中用与Lambda一致的PHP版本和架构执行composer install --no-dev --optimize-autoloader，再打包vendor部署；推荐使用AWS官方Docker镜像构建以确保环境一致。
在 AWS Lambda 或 Serverless Framework 环境中，composer install 不能直接在 Lambda 运行时执行（无写入权限、无 PHP CLI 环境、无网络），必须在构建阶段完成依赖打包。
本地构建 + vendor 打包是最可靠的方式
Serverless Framework 和 AWS SAM 都不支持运行时安装 Composer 包。你必须在本地（或 CI 环境）用与 Lambda 相同的 PHP 版本和架构（x86_64 或 arm64）执行 composer install --no-dev --optimize-autoloader，再将 vendor/ 和代码一起 zip 部署。
- 确保本地 PHP 版本与 Lambda 运行时一致（如
php8.2）；可用php -v核对 - 务必加
--no-dev：Lambda 不需要phpunit、psysh等开发依赖，否则可能超 250MB 解压限制 - 加
--optimize-autoloader生成vendor/autoload.php的静态映射，提升冷启动性能 - 避免在
composer.json中使用platform配置伪造环境——它可能导致 autoloader 生成错误路径
使用 Docker 构建可避免“本地环境不一致”问题
本地 PHP 版本或扩展缺失（如 zip、mbstring）会导致 autoload_static.php 生成异常，Lambda 启动时报 Class not found。用官方 AWS Lambda PHP 镜像构建能完全对齐。
docker run --rm -v $(pwd):/var/task public.ecr.aws/sam/build-php8.2 \ /bin/sh -c "cd /var/task && composer install --no-dev --optimize-autoloader"
- 镜像地址随运行时更新：
public.ecr.aws/sam/build-php8.1、public.ecr.aws/sam/build-php8.3 - 该镜像已预装
zip、curl、git和必要扩展，无需额外配置 - 不要在容器内执行
composer update——会污染composer.lock，应只做install
Serverless Framework 中的打包路径必须显式声明
serverless.yml 默认只打包当前目录下非 node_modules 的文件，vendor/ 若在项目根目录外（如被 composer install -d ../shared-vendor 指定），会被忽略。
- 用
package/include显式包含：package: include: - 'vendor/**' - 若用
vendor/在子目录（如src/vendor），需确认composer install -d src后路径正确，并在include中写src/vendor/** - 禁用自动打包（
package: individually: true）后，必须为每个函数单独指定package/include，否则vendor/不会进入 ZIP - 别依赖
functions.*.package.artifact指向已有 ZIP——它绕过include规则，vendor 可能缺失
最易被忽略的是 autoloader 路径硬编码问题：某些包（如 monolog/monolog）在生成优化类映射时，会把绝对路径写进 vendor/composer/autoload_static.php。Docker 构建时若挂载路径不一致（如 /var/task vs /home/project），Lambda 解压后 require 会失败。解决方法只有两个：用标准挂载路径（如上面示例），或改用 composer install --classmap-authoritative（更严格，但兼容性略低）。
