AWS Serverless Patterns 项目中 Lambda 运行时版本升级指南

在 AWS Serverless Patterns 项目中，多个示例代码仍在使用已终止支持的 Node.js 运行时版本，这会导致用户在部署时遇到兼容性问题。本文将详细介绍这一技术升级的必要性、影响范围以及解决方案。

背景与问题现状

AWS Lambda 服务会定期更新其支持的 Node.js 运行时版本。目前项目中存在以下过时版本：

1. Node.js 14.x 版本

   • 自 2024 年 1 月 9 日起，AWS 已禁止创建新函数
   • 现有函数仍可运行但不再接收安全更新

2. Node.js 16.x 版本

   • 2024 年 6 月 12 日进入弃用阶段
   • 2025 年 2 月 28 日起将禁止创建新函数

技术影响分析

当用户尝试部署使用这些过时运行时的示例时，会遇到明确的错误提示。错误信息会指出运行时版本不再受支持，并建议使用最新的 Node.js 20.x 版本。

部署失败的具体表现包括：

• CloudFormation 堆栈创建失败
• Lambda 函数资源创建被明确拒绝
• 错误代码为 InvalidRequest

升级解决方案

升级到 Node.js 20.x 运行时是当前推荐的解决方案，该版本于 2023 年 11 月 15 日正式在 AWS Lambda 上可用。升级涉及两个层面的修改：

1. 基础修改

   • 更新 SAM/CloudFormation 模板中的 Runtime 属性
   • 简单示例可能仅需修改版本号即可

2. 深度修改

   • 需要将 AWS SDK for JavaScript 从 v2 升级到 v3
   • 更新相关依赖包的版本
   • 调整因 SDK 版本变更导致的 API 调用方式变化

实施建议

对于项目维护者和贡献者：

• 全面扫描代码库中所有使用 nodejs14.x 和 nodejs16.x 的示例
• 优先处理已被用户报告部署失败的示例
• 建立版本更新检查机制，避免类似问题再次发生

对于终端用户：

• 在使用示例前检查运行时版本配置
• 遇到部署失败时可尝试自行修改运行时版本
• 注意相关依赖包的兼容性问题

总结

保持 Lambda 运行时版本更新是 Serverless 应用维护的重要环节。AWS Serverless Patterns 项目正在逐步更新所有示例，确保它们使用当前支持的 Node.js 20.x 运行时。这一工作不仅解决了即时的部署问题，也为用户提供了符合最佳实践的参考实现。