Node.js连接Google Spreadsheet失败：TypeError: GoogleSpreadsheet is not a constructor

这个错误的核心原因是你使用的google-spreadsheet包版本和代码写法不匹配——新版本的库导出方式发生了变化，导致你拿到的不是构造函数。

问题分析 #

旧版本（v3及以下）的google-spreadsheet默认导出GoogleSpreadsheet构造函数，所以const GoogleSpreadsheet = require('google-spreadsheet')是有效的。但v4及以上的版本重构了API，改成了命名导出，直接require得到的是一个包含多个导出项的对象，而非构造函数，因此会抛出not a constructor的错误。

解决方案 #

方案1：升级代码适配v4+版本（推荐） #

新版本的库原生支持async/await，不需要手动用promisify包装方法，代码更简洁：

const { GoogleSpreadsheet } = require('google-spreadsheet');
const creds = require('./client_secret.json');

async function accessSpreadsheet() {
  const doc = new GoogleSpreadsheet('1HrQBQU-3DtMywH_qZASB8xiIj8Vb6AlI3k2LWDameE8');
  // 验证服务账号
  await doc.useServiceAccountAuth(creds);
  // 加载文档信息（替代旧版的getInfo）
  await doc.loadInfo();
  // 获取第一个工作表（替代旧版的info.worksheets[0]）
  const sheet = doc.sheetsByIndex[0];
  console.log(`Title: ${sheet.title}`);
}

// 别忘了添加错误捕获，避免UnhandledPromiseRejectionWarning
accessSpreadsheet().catch(err => console.error('访问表格出错:', err));

方案2：降级到v3版本（保持原有代码结构） #

如果你不想修改代码，可以安装旧版本的包：

npm install google-spreadsheet@3 --save

安装完成后，你原来的代码就能正常运行了，但旧版本不再维护，长期来看推荐使用方案1。

额外提醒 #

• 确认你的client_secret.json权限正确：服务账号需要拥有目标表格的编辑/查看权限（可以通过表格的共享功能添加服务账号邮箱）。
• 新版本的API有更多简化的方法，比如doc.sheetsByTitle['工作表名称']可以直接通过标题获取工作表，比索引更直观。

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