Express POST路由handler无客户端请求时重复触发问题求助

核心结论 #

Express本身不存在响应超时自动重调路由handler的内部机制，你遇到的现象是超时配置触发的请求重试导致的。

问题原因 #

最匹配你描述的2-3分钟超时触发二次调用的原因是Node.js 原生HTTP服务器的默认超时限制：Node.js v13.0.0之前版本的http.Server默认超时时间为120秒（2分钟），超时后会主动销毁连接，此时如果你的客户端/请求库配置了自动重试规则，就会自动发起第二次POST请求，触发handler二次执行。

解决办法 #

1. 调整服务端超时配置 #

修改Express启动时的服务器超时参数，匹配你的长任务耗时需求：

// 原有启动代码
const server = app.listen(3000, () => {
  console.log('服务启动在端口3000')
})
// 设置超时时间为10分钟（按需调整，单位为毫秒，设为0代表永不超时）
const TIMEOUT = 10 * 60 * 1000
server.timeout = TIMEOUT
server.headersTimeout = TIMEOUT
server.keepAliveTimeout = TIMEOUT

2. 关闭客户端自动重试 #

检查你前端使用的请求库（axios、fetch等）的配置，关闭自动重试开关，同时将客户端请求的超时时间调整为和服务端匹配的长度。

3. 长耗时任务优化（推荐） #

长时间挂起HTTP请求的方案本身稳定性较差，更合理的处理逻辑是：

• 收到POST请求后立即返回202 Accepted状态码，同时返回唯一任务ID
• 后台用任务队列（如BullMQ、Agenda）异步执行forSomethingReallySlow逻辑
• 前端通过轮询或者WebSocket主动查询任务执行状态，获取最终结果

4. 现有代码修复 #

你当前的CORS配置存在冲突，同时配置了两次CORS规则，且第一次配置不符合规范（origin: '*'和credentials: true不能同时使用），建议统一调整为：

// 保留cors中间件，删除后续手动写的CORS头设置中间件
app.use(cors({
   origin: 'http://localhost:4200',
   credentials: true,
   allowedHeaders: ['Origin', 'X-Requested-With', 'Content-Type', 'Accept', 'Authorization'],
   methods: ['POST', 'GET'],
   optionSuccessStatus: 200
}))

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