You need to enable JavaScript to run this app. Node.js异步回调出现TypeError: callback is not a function问题排查
优惠活动
大模型
产品
解决方案
定价
更多

Node.js异步回调出现TypeError: callback is not a function问题排查

报错原因

触发这个报错的核心是函数命名冲突,被JS的函数声明提升规则直接覆盖,导致传入的回调根本不是预期的函数,完整触发链路:

  • JS在正式执行代码逻辑前,会把所有顶层的函数声明全部提升到当前作用域的最顶部,后定义的同名函数会直接覆盖先定义的同名函数,和代码书写的先后顺序无关。
  • 你的代码里重复定义了两次getRepositories:
    • 第一次写的是仅接收1个user参数的回调处理逻辑:拿到用户对象后提取GitHub用户名,再调用接口查询仓库列表
    • 第二次写的是需要接收username + callback两个参数的异步接口逻辑:模拟请求GitHub API获取仓库列表,拿到结果后执行传入的回调
  • 按照覆盖规则,整个作用域内实际生效的getRepositories是后面那个需要两个入参的异步接口函数。你最初写的getUser(1, getRepositories)传给getUser的回调,根本不是自己写的那个处理用户结果的函数,而是需要两个参数的异步接口函数。
  • 等getUser的2秒延时任务执行完,把用户对象作为参数传给这个回调的时候,这个异步接口函数只收到了1个入参,它定义中需要的第二个参数callback是完全未传入的undefined状态;等它自己的2秒延时到点要执行回调的时候,自然就抛出了callback is not a function的错误。
  • 同样的重名问题也存在于getCommits函数上:前面的回调处理逻辑和后面的异步接口函数同名,就算仓库接口的问题修好,走到获取提交记录的步骤还会报一模一样的错。
  • 额外还有一个隐藏的未定义变量bug:原来的回调处理逻辑里写的getCommits(repo, displayCommits)中的repo是游离的未定义变量,就算命名冲突问题全部解决,这里也会触发ReferenceError。
修复方案

把承担回调处理职责的函数,和真正的异步API函数改成完全不同的命名,从根源上避免命名覆盖,同时补全未定义的变量引用,修正后的可正常运行的代码如下:

console.log('before');

// 回调处理函数单独命名,不与异步API函数重名
function handleUserResult(user) {
  // 从用户对象中提取GitHub用户名,发起仓库查询请求
  getRepositories(user.gitHubUsername, handleRepoResult);
}

function handleRepoResult(repos) {
  // 修正未定义的repo变量,取第一个仓库查询提交记录
  getCommits(repos[0], displayCommits);
}

function displayCommits(commits) {
  console.log(commits);
}

// 初始调用,将用户结果处理函数作为回调传给getUser
getUser(1, handleUserResult);

console.log('after');

// 以下为实际的异步模拟接口函数,逻辑保持不变
function getUser(id, callback) {
  setTimeout(() => {
    console.log('reading a user from database...');
    callback({ id: id, gitHubUsername: 'mosh' });
  }, 2000);
}

function getRepositories(username, callback) {
  setTimeout(() => {
    console.log('calling GitHub API...');
    callback(['repo1', 'repo2', 'repo3']);
  }, 2000);
}

function getCommits(repo, callback) {
  setTimeout(() => {
    console.log('calling GitHub API...');
    callback(['commit']);
  }, 2000);
}

修复后程序可正常执行,输出结果:

before
after
reading a user from database...
calling GitHub API...
calling GitHub API...
['commit']

内容的提问来源于stack exchange,提问作者Jaini Shah

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 16:24:03