CloudFormation创建API Gateway时路径参数未绑定问题求助

我之前也踩过类似的坑，别着急，咱们一步步排查可能的原因：

1. 确认路径参数的定义位置是否正确 #

API Gateway的路径参数不是定义在资源层级，而是要在对应方法的Method Request里启用。比如你要给/users/{userId}路径添加参数，得在AWS::ApiGateway::Method资源里声明：

GetUserMethod:
  Type: AWS::ApiGateway::Method
  Properties:
    RestApiId: !Ref MyRestApi
    ResourceId: !Ref UserResource
    HttpMethod: GET
    AuthorizationType: NONE
    RequestParameters:
      method.request.path.userId: true  # 必须设为true来启用这个路径参数

很多人容易误把参数定义在AWS::ApiGateway::Resource里，其实这个资源只负责定义路径结构，参数的启用是在Method里完成的。

2. 检查路径资源的PathPart格式是否正确 #

如果你的参数是users，那对应的资源路径应该是/xxx/{users}，而不是/users。要确保AWS::ApiGateway::Resource的PathPart是带大括号的参数格式：

UserResource:
  Type: AWS::ApiGateway::Resource
  Properties:
    ParentId: !Ref RootResource
    RestApiId: !Ref MyRestApi
    PathPart: "{users}"  # 这里必须用大括号包裹参数名，否则就是普通路径

要是PathPart写的是users，那这就是一个固定资源路径，不是参数，控制台自然不会显示路径参数。

3. 确认API是否已经部署 #

就算你正确定义了参数，CloudFormation创建资源后，必须部署API才能让配置生效。记得在模板里添加AWS::ApiGateway::Deployment资源，并且依赖对应的Method：

ApiDeployment:
  Type: AWS::ApiGateway::Deployment
  Properties:
    RestApiId: !Ref MyRestApi
    StageName: prod
  DependsOn: GetUserMethod  # 确保部署时方法和参数已经创建完成

如果没部署，控制台里看到的还是旧的API状态，自然看不到新添加的参数。

4. 检查CloudFormation栈的执行状态 #

去CloudFormation控制台查看栈的事件日志，确认对应的Method和Resource资源是否成功创建，有没有报错。比如如果Method的ResourceId引用错误，参数就会被加到错误的资源上，你在目标路径里自然看不到。

5. 确认控制台的查看位置是否正确 #

路径参数是在具体方法的请求配置里查看，而不是资源列表。你需要进入对应的API → 目标资源 → 对应的HTTP方法（比如GET） → 「请求」标签页，在「路径参数」区域才能看到已配置的参数，别找错地方啦！

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