AWS SAM模板中能否通过变量指定Node.js运行时版本？为何配置失败？

可以通过变量指定Node.js运行时版本，你的问题出在变量替换的语法或参数传递环节，以下是具体修正方案：

问题原因 #

你遇到的'nodejsNodeVersion.x' runtime is not supported错误，是因为SAM未正确解析!Sub函数中的变量，直接将未替换的字符串当作了运行时名称，本质是变量替换逻辑未生效。

正确写法及步骤 #

1. 修正模板中的Runtime字段语法 #

确保!Sub表达式用引号包裹，避免YAML解析异常，同时给NodeVersion添加合法值限制：

Parameters:
  Env:
    Type: String
    Description: Select the appropriate environment
    AllowedValues:
      - dev
  NodeVersion:
    Type: String
    Description: Node version to be used (e.g. 20, 18)
    AllowedValues:
      - 18
      - 20
      - 21

......

      SomeFunction:
        Type: AWS::Serverless::Function
        Properties:
          FunctionName: !Sub my-function-${Env}
          CodeUri: src/
          Handler: index.handler
          Runtime: !Sub "nodejs${NodeVersion}.x"

2. 执行sam build时传入参数 #

执行build命令时，必须通过--parameter-overrides明确传入NodeVersion的值：

sam build --parameter-overrides NodeVersion=20

也可以在samconfig.toml中预先配置参数，后续执行sam命令会自动读取：

[default.build.parameters]
parameter_overrides = "NodeVersion=20,Env=dev"

3. 更安全的映射方式（推荐） #

如果需要关联环境与对应Node版本，使用Mappings避免手动传参出错：

Mappings:
  EnvNodeMapping:
    dev:
      NodeVersion: 20
    prod:
      NodeVersion: 18

Parameters:
  Env:
    Type: String
    Description: Select the appropriate environment
    AllowedValues:
      - dev
      - prod

......

      SomeFunction:
        Type: AWS::Serverless::Function
        Properties:
          FunctionName: !Sub my-function-${Env}
          CodeUri: src/
          Handler: index.handler
          Runtime: !Sub "nodejs${EnvNodeMapping.${Env}.NodeVersion}.x"

这种方式下只需传入Env参数，SAM会自动映射到对应Node版本，减少出错概率。

额外注意事项 #

• 确保SAM CLI为最新版本，旧版本可能存在!Sub函数在Runtime字段的解析Bug，可通过sam --version检查并更新。
• Node.js运行时格式必须严格遵循nodejs<version>.x，变量仅需传递版本号数字部分（如20、18）。

内容的提问来源于stack exchange，提问作者spirytus