使用Node.js v17.1.0触发ERR_INVALID_CALLBACK错误该如何解决？

DevOps 小满

2026-9-26

Node.js v17.1.0 ERR_INVALID_CALLBACK 报错原因及解决方案

throw new ERR_INVALID_CALLBACK(callback) 是Node.js内置的参数校验错误，触发核心逻辑为：调用需要传入回调函数的API时，传入的回调参数为非函数类型，或者未传入必填的回调参数。

常见触发场景及对应解决办法

未给回调式API传入回调参数
Node.js fs、child_process等核心模块的传统回调式API，强制要求最后一个参数为回调函数，省略该参数就会触发报错，例如错误写法fs.readFile('./demo.txt')。
解决办法：
1. 补全回调参数
```
const fs = require('fs')
fs.readFile('./demo.txt', (err, content) => {
  if (err) throw err
  console.log(content.toString())
})
```
1. 改用Promise版本的API，Node.js v17已全量支持核心模块的Promise化导出：
```
const fs = require('fs/promises')
async function getFileContent() {
  const content = await fs.readFile('./demo.txt')
  console.log(content.toString())
}
```
传入的回调参数不是函数类型
调用API时如果把字符串、数字、undefined等非函数类型的值当做回调传入，也会触发该错误，例如错误写法fs.readFile('./demo.txt', 'utf8', {})，最后一个参数为对象不是函数。
解决办法：对照对应API的官方文档，确认参数顺序、类型要求，确保最后传入的回调参数为合法函数，编码、配置类参数放在回调参数之前的位置。
第三方依赖或自定义工具函数的参数校验报错
如果是调用第三方依赖或者自己封装的工具函数触发的报错，说明对应封装逻辑内做了回调合法性校验，需要先确认对应依赖是否兼容Node.js v17版本，再检查调用时传入的参数类型、数量是否符合要求。