AWS SAM集成OpenAPI：变量为何无法正常工作？

你遇到的核心问题是OpenAPI配置里引用Lambda函数的变量语法不对，导致API Gateway无法解析到正确的函数ARN——硬编码ARN能正常跑，说明函数本身没问题，就是变量绑定逻辑错了。

常见错误&修复方法 #

1. OpenAPI里的Lambda引用语法错误 #

在SAM项目的OpenAPI（swagger.yaml）里，不能直接写SAM模板里的变量名，得用CloudFormation的Fn::Sub来拼接ARN，或者通过SAM的资源转换来处理变量替换。

举个正确的配置例子：

• template.yaml 里的Lambda定义：

Resources:
  ZorrosFunction: # 这个逻辑ID要和OpenAPI里的引用一致
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./zorros/
      Handler: app.lambda_handler
      Runtime: python3.9

• swagger.yaml 里的API集成配置：

paths:
  /zorros:
    get:
      x-amazon-apigateway-integration:
        uri:
          Fn::Sub: arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${ZorrosFunction.Arn}/invocations
        httpMethod: POST
        type: aws_proxy

2. SAM与OpenAPI的变量关联没做对 #

如果你的OpenAPI是通过SAM模板里的AWS::Serverless::Api引用的，必须确保用AWS::Include转换来让SAM处理变量替换。比如template.yaml里的Api配置：

Resources:
  MyApi:
    Type: AWS::Serverless::Api
    Properties:
      DefinitionBody:
        Fn::Transform:
          Name: AWS::Include
          Parameters:
            Location: ./swagger.yaml
      StageName: Prod

这种情况下，OpenAPI里的${AWS::Region}、${ZorrosFunction.Arn}才会被SAM正确替换成实际值。

3. 别用错误的变量格式 #

不要在OpenAPI里直接写!Ref ZorrosFunction，OpenAPI本身不认SAM的CloudFormation函数，必须用Fn::Sub或者上面的转换方式来处理。

快速验证步骤 #

1. 检查swagger.yaml里x-amazon-apigateway-integration的uri字段，确认是用Fn::Sub包裹，并且引用的是Lambda函数的.Arn属性。
2. 核对SAM模板里的Lambda函数逻辑ID（比如ZorrosFunction）和OpenAPI里的引用完全一致（大小写敏感）。
3. 部署前先跑sam validate检查模板语法，提前揪出变量引用错误。

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