AWS SAM State Machine定义文件能否使用类似Globals的全局变量配置？

Step Functions 原生 ASL 定义文件没有内置类 SAM Globals 的全局配置复用能力，无法直接在 ASL 内部定义可复用的公共配置块、自动为所有匹配的 State 注入统一配置值。但结合 AWS SAM 的现有生态能力，完全可以实现你需要的“统一维护公共参数、减少重复配置”的目标，有两类可直接落地的实现方案：

方案一：基于现有 SAM 能力的零额外工具实现 #

你已经在使用的 DefinitionSubstitutions 能力，本质是纯字符串级别的占位符替换，并不局限于替换单个字符串值——你可以把整块重复的 JSON 配置定义为替换值，直接在 ASL 中用占位符引用，实现和 Globals 完全一致的维护逻辑：

• 在 SAM 模板的 DefinitionSubstitutions 中，把所有跨 State 重复的配置块（比如 Fargate 网络配置、ECS 集群 ARN、任务定义 ARN）定义为全局替换值
• 在 ASL 定义文件中，把原来重复粘贴的配置块替换为对应的 ${占位符} 标记
• 后续修改公共配置时，只需要修改 SAM 模板中对应的替换值即可，不需要逐个修改 ASL 里的重复块

举个适配你现有代码的改法示例：
修改后的 SAM 模板片段：

AWSTemplateFormatVersion: "2010-09-09"
Transform: AWS::Serverless-2016-10-31

Resources:
  MySAMPOC:
    Type: AWS::Serverless::StateMachine
    Properties:
      DefinitionUri: stateMachine/definition.asl.json
      DefinitionSubstitutions:
        GenerateConfigFunctionArn: !GetAtt GenerateConfigFunction.Arn
        # 公共复用配置定义
        CommonEcsClusterArn: "arn:aws:ecs:region:11111111:cluster/clustername"
        CommonEcsTaskDefArn: "arn:aws:ecs:region:11111111:task-definition/taskdef"
        CommonFargateNetworkConfig: !Sub |
          {
            "AwsvpcConfiguration": {
              "Subnets": ["subnet-00d610225d369486e"],
              "SecurityGroups": ["sg-016650ff9ecd28a9a"],
              "AssignPublicIp": "ENABLED"
            }
          }
  GenerateConfigFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: functions/generate_config
      Handler: app.lambda_handler
      Runtime: python3.8

修改后的 definition.asl.json 片段（去掉所有重复配置块）：

{
    "StartAt": "Generate Config",
    "States": {
        "Generate Config": {
            "Type": "Task",
            "Resource": "${GenerateConfigFunctionArn}",
            "Next": "ETL"
        },
        "ETL": {
            "Type": "Task",
            "Resource": "arn:aws:states:::ecs:runTask.sync",
            "Next": "Well_Calc",
            "Parameters": {
                "LaunchType": "FARGATE",
                "Cluster": "${CommonEcsClusterArn}",
                "TaskDefinition": "${CommonEcsTaskDefArn}",
                "NetworkConfiguration": "${CommonFargateNetworkConfig}",
                "Overrides": {
                    "ContainerOverrides": [
                        {
                            "Name": "Phase-1-start",
                            "Environment": [{"Name": "COMMAND", "Value": "etl"}]
                        }
                    ]
                }
            }
        },
        "Well_Calc": {
            "Type": "Task",
            "Resource": "arn:aws:states:::ecs:runTask.sync",
            "End": true,
            "Parameters": {
                "LaunchType": "FARGATE",
                "Cluster": "${CommonEcsClusterArn}",
                "TaskDefinition": "${CommonEcsTaskDefArn}",
                "NetworkConfiguration": "${CommonFargateNetworkConfig}",
                "Overrides": {
                    "ContainerOverrides": [
                        {
                            "Name": "Phase-1-start",
                            "Environment": [{"Name": "COMMAND", "Value": "calculation"}]
                        }
                    ]
                }
            }
        }
    }
}

注意：DefinitionSubstitutions 是纯文本替换机制，替换值的 JSON 语法必须严格正确，否则会导致最终生成的 ASL 定义语法校验失败。

方案二：构建阶段预处理（适合大规模项目） #

如果 State Machine 规模较大、重复配置块较多，把所有配置块都写在 DefinitionSubstitutions 中会让 SAM 模板变得臃肿，可以在本地构建流程中引入轻量模板渲染工具（比如 Jsonnet、Ytt 或自定义脚本），在 SAM 打包部署之前，先把 ASL 文件中的重复公共配置渲染填充完成，再把最终生成的 ASL 文件传给 SAM 做部署。
这种方式的灵活度更高，还支持配置继承、条件注入等更复杂的复用逻辑，不会侵入现有 SAM 部署流程。

常见误区澄清 #

很多人会误以为 SAM 模板里的 Globals 配置可以自动注入到 ASL 文件内部——实际上 SAM Globals 的作用域仅覆盖 CloudFormation 模板中同类型资源的属性，在模板转换阶段就完成处理，根本不会穿透到 ASL 定义文件内部替换内容，无法直接实现 ASL 内部的配置复用。

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