AWS SAM CLI 中 Node.js 22 运行时验证问题解析

问题背景

在使用 AWS SAM CLI 创建新项目时，开发者可能会遇到一个关于 Node.js 22 运行时的验证问题。具体表现为：虽然创建项目时可以选择 Node.js 22 作为运行时环境，但在后续执行 sam validate 命令时，验证会失败并提示 Node.js 22 不是一个有效的运行时选项。

问题本质

这个问题源于 SAM CLI 底层依赖的 cfn-lint 包（CloudFormation Linter）的版本滞后。在较旧版本的 SAM CLI（如 1.131.0）中，cfn-lint 尚未更新以支持 Node.js 22 运行时，导致验证时出现错误。

技术细节

1. 运行时验证机制：SAM CLI 在验证模板时会检查 Runtime 属性的有效性，确保其值在 AWS Lambda 支持的运行时列表中。

2. 版本不匹配：当 SAM CLI 的 sam init 命令提供了 Node.js 22 选项，但 cfn-lint 尚未更新对应的验证规则时，就会出现这种不一致的情况。

3. 错误信息分析：验证失败时显示的错误信息列出了所有支持的运行时，其中确实不包含 nodejs22.x，这证实了验证规则未及时更新的问题。

解决方案

AWS SAM 团队已经通过以下方式解决了这个问题：

1. 更新 cfn-lint 依赖：在 PR #7895 和 #7902 中更新了 cfn-lint 包的版本。

2. 新版发布：从 v1.135.0 版本开始，SAM CLI 已经包含了支持 Node.js 22 运行时的验证规则。

最佳实践建议

1. 保持 SAM CLI 更新：定期检查并更新到最新版本的 SAM CLI，以避免类似兼容性问题。

2. 验证失败排查：当遇到运行时验证失败时，首先检查 SAM CLI 版本是否支持该运行时。

3. 开发环境一致性：确保开发团队使用相同版本的 SAM CLI，避免因版本差异导致的问题。

总结

这个案例展示了基础设施即代码工具链中各组件版本同步的重要性。作为开发者，理解工具链中各组件的依赖关系有助于更快地定位和解决问题。AWS SAM 团队通过及时更新依赖包解决了这个问题，体现了开源社区对用户反馈的快速响应能力。