如何使用SST部署共享带/v1基础路径RestApi的多栈应用

算力阿峰

2026-7-17

解决SST多栈共享REST API Gateway公共路径冲突问题

问题根源

SST默认一次性部署所有栈，第二个栈中通过restApi.root.resourceForPath("/v1")获取的是CDK临时Token而非真实AWS资源ID，导致importedPaths配置失效，API Gateway尝试重复创建/v1资源触发409冲突错误。

解决方案

1. 修改第一个栈，导出公共路径资源ID

在创建第一个API的栈中，显式获取/v1资源并将其ID作为输出导出，确保第二个栈能拿到真实的资源ID：

export function Api1({ stack }: StackContext) {
  const api = new ApiGatewayV1Api(stack, "first-api", {
    routes: {
      "GET /v1/users": "packages/functions/src/users.handler",
    },
  });

  // 获取已创建的/v1资源
  const v1Resource = api.cdk.restApi.root.getResource("v1");
  // 导出资源ID供其他栈使用
  stack.addOutputs({
    V1ResourceId: v1Resource.resourceId,
  });

  return { api, v1ResourceId: v1Resource.resourceId };
}

2. 修改第二个栈，复用已有公共路径资源

在第二个栈中，直接引用第一个栈导出的v1ResourceId配置importedPaths，避免重复创建路径：

export function Api2({ stack }: StackContext) {
  const { api, v1ResourceId } = use(Api1);

  new ApiGatewayV1Api(stack, "second-api", {
    cdk: {
      restApi: api.cdk.restApi,
      // 告知SST /v1路径已存在，直接复用
      importedPaths: { "/v1": v1ResourceId },
    },
    routes: {
      "GET /v1/todo-list": "packages/functions/src/todo.handler",
    },
  });
}