Node.js调用Google Sheets API报"GoogleAuth is not a constructor"错误

触发根因 #

• 该报错并非初始化逻辑错误导致，核心原因是googleapis v100+ 大版本调整了模块导出结构，旧文档中通过google.auth嵌套路径访问GoogleAuth构造函数的写法，在新版本中已经无法正常获取到对应类。
• 次常见触发场景：项目node_modules存在旧版本googleapis的残留缓存，重装依赖时未清理旧文件，导致加载的模块导出结构与当前安装版本不匹配。

可直接落地的修复方案 #

方案1：适配新版API写法（无版本降级，长期兼容） #

不需要修改依赖版本，调整导入逻辑直接从内置的认证模块引入GoogleAuth构造器即可，修正后的代码参考：

// 注意：GoogleAuth直接从google-auth-library导入，无需额外安装，googleapis已内置该依赖
const {GoogleAuth} = require('google-auth-library');
const {google} = require('googleapis');

const auth = new GoogleAuth({
    keyFile: 'credentials.json',
    scopes: ['https://www.googleapis.com/auth/spreadsheets']
});

方案2：固定兼容旧写法的依赖版本 #

如果不想修改现有代码逻辑，可以将googleapis降级到支持旧嵌套路径的稳定版本，执行安装命令即可：

npm install googleapis@95.0.0 --save

该版本下new google.auth.GoogleAuth()的写法可正常运行。

排障补充 #

• 调整代码或依赖版本后如果仍出现相同报错，先删除项目目录下的node_modules文件夹与package-lock.json文件，重新执行npm install清理模块缓存，消除旧文件残留带来的加载异常。
• 确认credentials.json的相对路径匹配Node进程的实际工作目录，避免因路径错误衍生其他认证类报错。

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