Serverless.yml中通过环境变量传递StateMachine ARN时出现引用无效的警告问题

让我们一步步排查并解决你的问题，你的配置里存在几个关键错误：

1. 错误的State Machine资源引用名称 #

Serverless的Step Functions插件在生成CloudFormation资源时，会自动给状态机资源添加StateMachine后缀，并且采用驼峰命名规则。你定义的状态机是updateMetric，对应的CloudFormation资源名称应该是UpdateMetricStateMachine，而不是你写的UpdateMetric——这是你Outputs里Ref失效的核心原因之一。

2. Resources配置结构错误 #

你把Outputs放在了resources数组的一个独立元素里，这会导致${self:resources.Outputs.StateMachine.Value}根本无法定位到这个输出项。self:前缀只能访问配置文件里的静态结构，而数组形式的resources下的子元素无法通过这种层级路径直接访问。

3. Lambda环境变量的引用方式错误 #

self:resources.Outputs...这种写法只适用于访问本地配置里的静态值，但CloudFormation的Outputs是部署后生成的动态值，你需要用CloudFormation栈变量的格式来引用，也就是${cf:栈名称.输出名称}，其中栈名称默认是${self:service}-${self:stage}。

另外，你的配置第一行的name: aws是错误的——Serverless.yml的顶级属性应该是service，用来标识你的服务名称，比如service: metric-updater，这会影响栈名称的生成，必须修正。

修正后的完整配置片段 #

service: metric-updater # 修正：替换错误的name属性为service
runtime: nodejs12.x
stage: ${opt:stage, 'dev'}
region: us-east-1
lambdaHashingVersion: 20201221
versionFunctions: false
environment:
  # 修正：用CloudFormation栈变量引用输出的ARN
  statemachine_arn: ${cf:${self:service}-${self:stage}.StateMachine}
# 状态函数
stepFunctions:
  stateMachines:
    updateMetric:
      name: updateMetric
      definition:
        Comment: "A state machine to update data"
        StartAt: getMetric
        # 你的状态机定义内容...
resources:
  # 引入DynamoDB表资源（假设dynamodb-table.yml包含外层Resources节点）
  Resources: ${file(./resources/dynamodb-table.yml)}
  # 修正：直接在resources下定义Outputs，而非数组元素
  Outputs:
    StateMachine:
      # 修正：指向正确的State Machine资源
      Value: !Ref UpdateMetricStateMachine
      # 可选：添加导出，方便其他栈引用（如果有需要）
      Export:
        Name: ${self:service}-${self:stage}-StateMachineArn

如果你的dynamodb-table.yml是直接的资源对象（没有外层Resources节点），可以改用数组形式引入资源和输出：

resources:
  - ${file(./resources/dynamodb-table.yml)}
  - Outputs:
      StateMachine:
        Value: !Ref UpdateMetricStateMachine
        Export:
          Name: ${self:service}-${self:stage}-StateMachineArn

这种情况下Lambda环境变量的引用方式保持不变，依然使用${cf:${self:service}-${self:stage}.StateMachine}。

最后验证 #

部署你的服务（serverless deploy），部署完成后，你可以在Lambda控制台查看环境变量，确认statemachine_arn已经正确设置为你的State Machine ARN，此时在Lambda代码中就能正常使用这个ARN启动状态机了。

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