Serverless Step Functions：如何将环境变量转为数字用于CloudFormation

CloudFormation要求TimeoutSeconds必须是数字类型，而环境变量默认是字符串，这里提供两种可行的转换方案：

方案1：用CloudFormation内置函数Fn::ToNumber转换 #

直接在Step Functions定义中使用CloudFormation的Fn::ToNumber函数，将环境变量字符串转为数字，Serverless框架支持在状态机定义中嵌入CloudFormation Intrinsic Functions。

修改后的配置代码：

stepFunctions:
  stateMachines:
    MyStateMachine:
      name: 'MyStateMachine'
      definition:
        Comment: ''
        StartAt: Worker
        States:
          Worker:
            Type: Task
            Resource: arn:aws:states:::ecs:runTask.waitForTaskToken
            InputPath: $
            ResultPath: $
            OutputPath: $
            TimeoutSeconds:
              Fn::ToNumber: ${env:TIMEOUT_SECONDS}
            Parameters:
              # ...              
            Catch:
              - ErrorEquals: ["States.ALL"]
                Next: Failure
            Next: Success

          Failure:
            Type: Fail

          Success:
            Type: Succeed

如果需要设置默认值，可以结合环境变量的默认值语法：

TimeoutSeconds:
  Fn::ToNumber: ${env:TIMEOUT_SECONDS, '300'}

方案2：通过Serverless自定义变量解析 #

如果你的Serverless版本不支持直接使用CloudFormation函数，可通过外部JS文件解析环境变量为数字：

1. 在serverless.yml中定义自定义变量：

custom:
  parsedTimeout: ${file(./parse-timeout.js):getNumber}

stepFunctions:
  stateMachines:
    MyStateMachine:
      name: 'MyStateMachine'
      definition:
        Comment: ''
        StartAt: Worker
        States:
          Worker:
            Type: Task
            Resource: arn:aws:states:::ecs:runTask.waitForTaskToken
            InputPath: $
            ResultPath: $
            OutputPath: $
            TimeoutSeconds: ${self:custom.parsedTimeout}
            Parameters:
              # ...              
            Catch:
              - ErrorEquals: ["States.ALL"]
                Next: Failure
            Next: Success

          Failure:
            Type: Fail

          Success:
            Type: Succeed

2. 在项目根目录创建parse-timeout.js文件：

module.exports.getNumber = () => {
  const timeoutStr = process.env.TIMEOUT_SECONDS || '300';
  const timeoutNum = parseInt(timeoutStr, 10);
  // 可选：验证数字合法性，避免无效值
  if (isNaN(timeoutNum) || timeoutNum <= 0) {
    throw new Error('TIMEOUT_SECONDS must be a positive integer');
  }
  return timeoutNum;
};

注意事项 #

• 确保TIMEOUT_SECONDS环境变量的值是合法的正整数字符串，避免解析错误；
• 方案1需要Serverless Framework v2.x及以上版本支持；
• 方案2的JS文件可以添加额外的参数校验逻辑，提前拦截无效配置。

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