Skip to content

异步回调被调用两次

快速摘要

你的函数在成功和错误路径上都调用了回调——调用者收到两次完成信号并重复执行其逻辑。

为什么发生

  • 在 if 和 else 分支中都调用回调却未 return

  • 成功路径已触发回调后,超时分支又触发了一次

  • 缺少守卫标志,导致重试时重新调用原始回调

最小示例

✗ 错误代码
function load(cb) {
  if (Math.random() > 0.5) cb(null, 'data');
  cb(new Error('fail')); // always called!
}
load((err, d) => console.log(err, d)); // logs twice
✓ 修复代码
function load(cb) {
  if (Math.random() > 0.5) return cb(null, 'data');
  cb(new Error('fail'));
}
load((err, d) => console.log(err, d)); // logs once

没有 return 时,成功分支调用 cb 后会继续执行到错误 cb,导致回调被调用两次。加上 return 确保只调用一次。

如何诊断

  • 在回调顶部加日志统计它被调用的次数

  • 检查生产函数中每条路径在调用回调后是否都有 return

  • 用包装器在回调被调用超过一次时抛错

如何修复

  • 每次调用回调后立即 return

  • 用 let called = false 标志守卫,忽略后续调用

  • 重构为每次执行恰好只调用一次回调

如何预防

  • 调用回调后总是立即 return

  • 改用只能结算一次的 Promise,而非原始回调

相关资源

相关术语

相关课程

  • 函数

    学习回调与控制流。

← 返回语言