AWS Amplify CLI 中 Lambda 运行时版本升级问题解析

问题背景

在使用 AWS Amplify CLI 进行项目部署时，开发者可能会遇到 Lambda 函数运行时版本不兼容的问题。具体表现为在执行 amplify push 命令时，系统提示 nodejs12.x 运行时不再支持创建或更新 AWS Lambda 函数。

问题本质

AWS Lambda 服务已逐步淘汰对 Node.js 12.x 运行时的支持，要求使用更新的运行时版本（如 Node.js 18.x）。而 Amplify CLI 自动生成的部分 Lambda 函数（如 UserPoolClientLambda 和 PinpointFunction）仍默认使用旧版运行时，导致部署失败。

受影响资源

1. 认证相关 Lambda：UserPoolClientLambda（由 auth 资源创建）
2. 分析服务 Lambda：PinpointFunction（由 analytics 资源创建）

解决方案

认证资源更新

对于 auth 资源生成的 Lambda 函数：

1. 执行 amplify update auth 命令
2. 在更新流程中重新选择现有配置选项
3. 系统将自动生成使用新版运行时的模板

分析服务更新

对于 analytics 资源生成的 PinpointFunction：

1. 手动编辑 CloudFormation 模板文件：amplify/backend/analytics/<资源名称>/pinpoint-cloudformation-template.json
2. 定位到 PinpointFunction 配置块
3. 将 Runtime 属性从 nodejs12.x 更新为 nodejs18.x

完整更新步骤

1. 确保使用最新版 Amplify CLI（执行 amplify upgrade）
2. 更新 auth 资源配置
3. 手动修改 analytics 资源模板
4. 执行 amplify build 验证更改
5. 执行 amplify push 完成部署

技术建议

1. 定期检查运行时版本：AWS 会定期淘汰旧版运行时，建议定期检查项目配置
2. 版本兼容性测试：升级运行时版本后，应充分测试功能兼容性
3. 基础设施即代码：考虑将 Amplify 配置纳入版本控制，便于追踪变更

经验总结

此问题反映了云服务持续演进带来的兼容性挑战。作为开发者，应当：

1. 关注 AWS 官方公告，特别是服务废弃计划
2. 建立定期升级检查机制
3. 理解 Amplify 生成的底层资源配置
4. 掌握手动修改 CloudFormation 模板的能力

通过正确处理这类问题，可以确保项目持续获得 AWS 服务的完整支持，同时避免因服务废弃导致的部署中断。