如何通过请求头实现AWS API Gateway调用指定版本Lambda函数？

没问题，AWS API Gateway完全支持你想要的这种基于请求头的版本控制方案，而且你猜测的${request.headers.version}这类变量确实可以直接用来动态指定要调用的Lambda函数！下面我把具体实现方式和注意事项给你理清楚：

核心实现逻辑 #

API Gateway的集成请求（Integration Request）允许直接引用请求上下文里的变量——包括请求头——来动态拼接Lambda的ARN。这样你不用改URL路径，只要在请求里带version头，就能自动路由到对应版本的Lambda函数。

结合CloudFormation的具体配置 #

1. 先搭好基础的API和/orders路径 #

在CloudFormation模板里，先创建API Gateway实例、/orders资源和对应的GET方法：

AWSTemplateFormatVersion: '2010-09-09'
Resources:
  OrderApi:
    Type: AWS::ApiGateway::RestApi
    Properties:
      Name: OrderService-HeaderVersioned

  OrdersResource:
    Type: AWS::ApiGateway::Resource
    Properties:
      ParentId: !GetAtt OrderApi.RootResourceId
      PathPart: orders
      RestApiId: !Ref OrderApi

  OrdersGetMethod:
    Type: AWS::ApiGateway::Method
    Properties:
      RestApiId: !Ref OrderApi
      ResourceId: !Ref OrdersResource
      HttpMethod: GET
      AuthorizationType: NONE
      # 重点在这里：集成请求的URI动态引用请求头
      Integration:
        Type: AWS_PROXY
        IntegrationHttpMethod: POST
        Uri: !Sub >-
          arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/arn:aws:lambda:${AWS::Region}:${AWS::AccountId}:function:getOrders:${request.headers.version}/invocations
        PassthroughBehavior: WHEN_NO_MATCH

2. 关键：${request.headers.version}变量的用法 #

你提到的${request.headers.version}是API Gateway原生支持的变量，它会自动提取请求中version头的值，直接替换到Lambda的ARN里。比如请求头传version: v1，就会调用getOrders:v1；传v2就调用getOrders:v2，完全符合你的需求。

3. 别忘了配置Lambda调用权限 #

API Gateway需要有调用Lambda的权限，用CloudFormation的AWS::Lambda::Permission来配置：

LambdaInvokePermission:
  Type: AWS::Lambda::Permission
  Properties:
    FunctionName: !Sub "getOrders:*" # 允许调用所有版本的getOrders函数
    Action: lambda:InvokeFunction
    Principal: apigateway.amazonaws.com
    SourceArn: !Sub "arn:aws:execute-api:${AWS::Region}:${AWS::AccountId}:${OrderApi}/*/GET/orders"

实用优化建议 #

• 校验请求头合法性：避免用户传无效版本号导致调用不存在的Lambda，你可以给API Gateway加个请求验证——比如用Lambda授权器（Lambda Authorizer）检查version头的值是否是允许的（比如v1、v2），或者用模型（Model）定义头的有效值。
• 处理无版本头的情况：如果请求没带version头，${request.headers.version}会是空字符串，导致调用失败。你可以用映射模板加个默认值逻辑：

  #set($version = $input.params('version') != "" ? $input.params('version') : "v1")
  {
    "lambdaArn": "arn:aws:lambda:${AWS::Region}:${AWS::AccountId}:function:getOrders:${version}"
  }
  

  不过这个需要把集成模式改成非代理集成，或者用映射模板传递参数，根据你的实际场景调整就行。

其他无需修改URL路径的版本控制方案 #

除了请求头，还有几种替代思路：

• 查询参数路由：和请求头逻辑类似，用${request.querystring.version}获取URL里的?version=v1参数，动态路由到对应Lambda。
• 自定义域名+阶段变量：虽然你提到了阶段变量，但可以结合自定义域名来用——比如把v1.yourdomain.com映射到API的v1阶段，v2.yourdomain.com映射到v2阶段，每个阶段的变量存储对应版本的Lambda ARN。这种方式不用改URL路径，只是基于域名区分版本。

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