如何通过AWS API Gateway将请求取消事件透传至Node.js微服务

根因说明 #

AWS API Gateway 原有REST API类型默认开启请求、响应缓冲，客户端主动取消HTTP请求断开连接时，API Gateway不会主动终止和后端Node.js微服务的已建立连接，因此后端服务的close、aborted事件始终不会触发。

方案1：改用HTTP API类型（优先推荐） #

HTTP API是AWS推出的轻量API网关产品，默认支持客户端连接断开时自动同步终止与后端的集成连接，无需额外特殊配置：

• 只要将HTTP API的集成设置为HTTP代理，指向你的Node.js微服务地址即可
• 前端触发请求取消后，API Gateway会立即断开与后端的TCP连接，Node.js服务的请求关闭事件可以正常被捕获

方案2：保留REST API的调整配置 #

如果因为功能依赖必须使用原有REST API类型，按以下步骤修改配置：

• 进入对应API的集成请求配置页面
• 确认集成类型为HTTP代理，非代理集成默认全缓冲请求，无法转发中途断开事件
• 高级设置中将内容处理策略改为透传（Passthrough）
• 关闭请求缓冲功能，请求缓冲开启时网关会等接收完全量客户端请求才会转发到后端，不会响应中途的断开操作
• 部署API变更后即可生效

Node.js服务代码兼容优化 #

建议同时监听两个事件做兼容，覆盖所有运行环境场景：

// 处理常规请求关闭场景
req.on('close', () => {
  if (req.aborted) {
    console.log('请求已被客户端取消')
    // 此处补充你的业务终止逻辑，例如停止异步任务、取消数据库查询等
  }
})

// 兼容低版本Node.js的请求中断事件
req.on('aborted', () => {
  console.log('请求已被中断')
  // 此处补充你的业务终止逻辑
})

注意：如果你的Node.js微服务前还部署了AWS ALB（应用负载均衡），需要同步关闭ALB的请求缓冲配置，否则断开事件会被ALB拦截，还是无法传递到Node.js服务。

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