Electron应用CORS预检请求在HTTP_STREAM_PARSER_READ_HEADERS处挂起问题排查

核心现象 #

• 600台部署机器中少数出现间歇性OPTIONS预检请求挂起，状态卡在HTTP_STREAM_PARSER_READ_HEADERS
• Axios设置5000ms超时，GET请求超时后能正常终止，但OPTIONS请求会在后台持续运行
• 触发无规律：有时连续6次挂起，有时间隔数小时才出现一次
• 累计6个挂起请求后，单域名连接数达上限，后续所有API请求全部阻塞

排查实操步骤 #

1. 抓取环境差异 #

对比异常机器与正常机器的核心参数，锁定环境变量差异：

• Electron版本（不同Chromium内核的网络栈逻辑差异是高频诱因）
• 操作系统版本/补丁包（尤其Windows组策略、防火墙规则的区别）
• 代理配置（企业透明代理、PAC脚本可能拦截OPTIONS请求）
• 杀毒/终端安全工具（部分软件会阻断预检请求的响应包）

2. 测试原生网络模块替代Axios #

Axios的超时逻辑对OPTIONS请求可能存在兼容问题，换用Electron原生net模块验证：

const { net } = require('electron')
const req = net.request({
  method: 'OPTIONS',
  url: '你的API地址',
  headers: {
    'Access-Control-Request-Method': 'GET',
    'Access-Control-Request-Headers': '你的自定义请求头'
  }
})
// 手动设置超时销毁逻辑
req.setTimeout(5000, () => {
  console.log('OPTIONS超时，强制销毁请求')
  req.destroy()
})
req.on('response', (res) => {
  console.log('OPTIONS响应状态:', res.statusCode)
})
req.end()

同时检查Electron的webPreferences配置，确认webSecurity、allowRunningInsecureContent等参数是否影响CORS逻辑。

3. 用Wireshark抓包分析全链路 #

在异常机器上抓包，确认三个关键节点：

• OPTIONS请求是否真的发送到服务器？未发送则排查本地防火墙/代理拦截
• 服务器是否返回响应？未返回则排查服务器端预检请求处理是否阻塞
• 响应返回后Electron是否正常解析？未解析则排查Chromium对响应头、编码的处理异常

4. 给Axios的OPTIONS请求加强制超时拦截 #

Axios全局超时对OPTIONS请求可能不生效，单独添加拦截器强制终止：

axios.interceptors.request.use(config => {
  if (config.method === 'options') {
    const source = axios.CancelToken.source()
    const timeoutId = setTimeout(() => {
      source.cancel('OPTIONS超时强制终止')
    }, 5000)
    config.cancelToken = source.token
    config.timeoutId = timeoutId
  }
  return config
})

axios.interceptors.response.use(res => {
  if (res.config.method === 'options' && res.config.timeoutId) {
    clearTimeout(res.config.timeoutId)
  }
  return res
}, err => {
  if (axios.isCancel(err)) {
    console.log('OPTIONS请求已强制终止')
  }
  return Promise.reject(err)
})

5. 临时缓解方案 #

若暂时无法定位根因，先做兜底处理：

• 修改Electron的连接数限制（应急使用，不推荐长期依赖）：

  const { app } = require('electron')
  app.commandLine.appendSwitch('max-connections-per-server', '10')
  

• 实现请求队列，限制同时发起的请求数，避免快速填满连接池

参考日志 #

初始GET请求日志：

后续OPTIONS请求日志：

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