AWS API Gateway WebSocket-Lambda postToConnection调用超时问题求助

使用Node.js 18搭配AWS SDK v3，通过ApiGatewayManagementApi向WebSocket客户端发送消息时，Lambda任务总是超时3秒，代码如下：

import {
  ApiGatewayManagementApiClient,
  PostToConnectionCommand,
} from "@aws-sdk/client-apigatewaymanagementapi";

export const handler = async (event) => {
  const domain = event.requestContext.domainName;
  const stage = event.requestContext.stage;
  const connectionId = event.requestContext.connectionId;
  const callbackUrl = `https://${domain}/${stage}`;
  const client = new ApiGatewayManagementApiClient({ endpoint: callbackUrl });

  const requestParams = {
    ConnectionId: connectionId,
    Data: "Hello!",
  };

  const command = new PostToConnectionCommand(requestParams);

  try {
    await client.send(command);
  } catch (error) {
    console.log(error);
  }

  return {
    statusCode: 200,
  };
};

错误信息：

fef17825-58ce-4ca7-8f38-85857f1aef0a Task timed out after 3.01 seconds

以下是几个常见的排查和修复方向：

1. 检查Lambda执行角色权限 #

确保Lambda的IAM执行角色拥有execute-api:ManageConnections权限，策略示例：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "execute-api:ManageConnections",
      "Resource": "arn:aws:execute-api:your-region:your-account-id:your-api-id/*/POST/@connections/*"
    }
  ]
}

替换your-region、your-account-id、your-api-id为实际值，测试阶段可临时用通配符*（生产环境不建议）。

2. 调整Lambda超时时间 #

默认Lambda超时为3秒，PostToConnection请求可能需要更长时间完成。在Lambda控制台的「配置」->「常规配置」中，将超时时间调整至10秒左右后重试。

3. 排查VPC网络配置 #

如果Lambda部署在VPC内：

• 若API Gateway是公网端点，Lambda所在子网需配置NAT网关，确保Lambda能访问公网；
• 若使用私有API Gateway，需配置Interface类型的VPC端点，同时确保安全组允许Lambda与端点通讯。

4. 验证API Gateway端点格式 #

确认callbackUrl是否正确：

• 若使用API Gateway默认域名，格式应为https://{api-id}.execute-api.{region}.amazonaws.com/{stage}；
• 若使用自定义域名，需确保域名已正确映射到API Gateway的stage，且SSL证书有效。

5. 捕获详细错误信息 #

修改catch块，打印更完整的错误内容，帮助定位问题：

catch (error) {
  console.error("Error details:", {
    name: error.name,
    message: error.message,
    stack: error.stack,
    code: error.code
  });
}

如果是连接已断开，会返回GoneException，但超时通常由网络或权限问题导致。

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