AWS环境下Next.js服务器如何实现IAM授权API Gateway的签名请求？

直接使用AWS官方的AWS SDK for JavaScript v3来实现，它是模块化、现代且维护活跃的工具，能帮你自动处理IAM请求签名，无需手动实现复杂算法。

步骤1：安装依赖 #

安装所需的SDK包：

npm install @aws-sdk/signature-v4 @aws-sdk/util-uri-escape @aws-sdk/util-format-url @aws-sdk/credential-provider-node

步骤2：实现sendSignedRequest函数 #

以下是贴合你需求的完整实现：

import { SignatureV4 } from "@aws-sdk/signature-v4";
import { formatUrl } from "@aws-sdk/util-format-url";
import { uriEscapePath } from "@aws-sdk/util-uri-escape";
import { defaultProvider } from "@aws-sdk/credential-provider-node";
import { HttpRequest } from "@aws-sdk/protocol-http";

export async function sendSignedRequest(request: Request): Promise<Response> {
  // 配置API Gateway所属的AWS区域和服务名称
  const REGION = "你的AWS区域（如us-east-1）";
  const SERVICE = "execute-api";

  // 从传入的Request对象中提取关键信息
  const url = new URL(request.url);
  const method = request.method;
  const headers = new Headers(request.headers);
  let body: string | Uint8Array | undefined;

  // 处理请求体
  if (request.body) {
    body = await request.text();
    // 如果是JSON格式，确保Content-Type正确
    if (!headers.has("Content-Type")) {
      headers.set("Content-Type", "application/json");
    }
  }

  // 构建AWS SDK所需的HttpRequest对象
  const awsRequest = new HttpRequest({
    method,
    hostname: url.hostname,
    path: uriEscapePath(url.pathname + url.search),
    headers: Object.fromEntries(headers.entries()),
    body,
  });

  // 创建签名器实例，自动从AWS环境获取凭证（EC2/ECS/Lambda/Next.js on AWS均支持）
  const signer = new SignatureV4({
    credentials: defaultProvider(),
    region: REGION,
    service: SERVICE,
    uriEscapePath: false, // 已手动处理路径转义，这里设为false
  });

  // 对请求进行签名
  const signedRequest = await signer.sign(awsRequest);

  // 转换为fetch可用的Request对象并发送
  const fetchRequest = new Request(formatUrl(signedRequest), {
    method: signedRequest.method,
    headers: new Headers(signedRequest.headers),
    body: signedRequest.body,
  });

  return fetch(fetchRequest);
}

关键说明 #

• 凭证自动获取：在AWS环境（如EC2、ECS、Lambda，或部署在AWS Amplify/EC2上的Next.js）中，defaultProvider()会自动从实例角色、环境变量等位置获取IAM凭证，无需硬编码。
• 区域配置：替换REGION为你的API Gateway所在的AWS区域。
• 兼容性：该实现基于Node.js环境（Next.js服务器端运行环境），完全适配现代Next.js版本。

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