在API Gateway集成请求中指定动态子域名的问题

API Gateway原生支持动态子域名映射，不需要依赖Lambda就能实现，不过控制台UI的格式限制会导致直接配置报错，你可以通过以下两种方式解决：

方式一：用CLI/CloudFormation绕过UI限制直接配置集成请求 #

控制台UI不允许在集成端点URL中直接使用未定义在资源路径的动态参数，但API Gateway的底层API支持这种配置。你可以用AWS CLI或CloudFormation来设置动态子域名：

示例CLI命令（从请求Host头提取子域名） #

假设你的目标后端格式是{subdomain}.your-service.com，而请求的Host是user1.your-api-domain.com，可以通过拆分Host头获取子域名：

aws apigateway update-integration \
  --rest-api-id 你的API_ID \
  --resource-id 目标资源ID \
  --http-method GET \
  --patch-operations '[
    {
      "op": "replace",
      "path": "/uri",
      "value": "http://$input.params('Host').split('.')[0].your-service.com/{proxy+}"
    }
  ]'

如果是用Stage变量来指定子域名（适合多环境场景），可以这样配置：

aws apigateway update-integration \
  --rest-api-id 你的API_ID \
  --resource-id 目标资源ID \
  --http-method GET \
  --patch-operations '[
    {
      "op": "replace",
      "path": "/uri",
      "value": "http://{stageVariables.subdomain}.your-service.com/{proxy+}"
    }
  ]'

方式二：用映射模板+HTTP代理集成 #

如果不想用CLI，也可以通过映射模板来动态构造目标请求：

1. 先在集成请求中填写一个占位的端点URL（比如default.your-service.com）。
2. 进入「集成请求」→「映射模板」，创建对应Content-Type的模板（比如application/json）。
3. 在模板中提取子域名并构造目标请求，同时设置Host头：

   #set($subdomain = $input.params('Host').split('\.')[0])
   #set($context.requestOverride.header.Host = "$subdomain.your-service.com")
   {
     "requestPath": "$context.resourcePath"
   }
   

   这种方式会覆盖请求的Host头，将请求转发到动态子域名对应的后端。

关于控制台的警告 #

你遇到的「端点包含未在资源路径中定义的参数」只是UI层面的警告，不影响通过CLI/CloudFormation配置后的功能生效。如果必须在控制台操作，也可以先忽略警告保存，再通过CLI调整集成URI。

何时需要Lambda？ #

如果你的动态子域名映射涉及复杂逻辑（比如需要查询数据库匹配子域名与后端服务、做权限校验等），此时用Lambda作为中间转发层会更灵活。但单纯的子域名动态映射，原生API Gateway就足够实现。

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