Node.js调用Google Sheets API时，持有效刷新令牌首次请求仍返回401“Login Required”错误

这种情况我之前也踩过坑，明明刚通过OAuth流程拿到的刷新令牌，结果调用API直接报401“Login Required”，确实挺让人费解的。咱们一步步拆解可能的问题，逐个排查：

1. 先确认刷新令牌的有效性与匹配性 #

这是最常见的问题：

• 检查Client ID/Secret是否与授权流程一致：你获取刷新令牌时用的OAuth客户端ID/密钥，必须和代码里GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET完全一致。比如别搞混了测试环境和生产环境的客户端凭证，哪怕差一个字符都会导致刷新令牌无效。
• 验证刷新令牌的完整性：从Firestore取出刷新令牌后，先打印出来看看（注意别泄露真实令牌），和你授权流程中拿到的原始令牌是否完全一致——有没有被截断、转义错误，或者存储时字段名写错了？比如如果Firestore里存的字段是refresh_token（下划线），那你代码里let { refreshToken } = credsDoc.data()就会解构出undefined，这时候调用setCredentials等于没传有效令牌。

2. 手动触发令牌刷新，提前排查问题 #

Google的auth库理论上会自动用刷新令牌获取访问令牌，但有时候自动流程会有隐藏问题。你可以在设置凭证后，手动调用getAccessToken()验证刷新令牌是否能正常换取访问令牌：

// 在setCredentials之后添加这段代码
try {
  const { token } = await oauth2Client.getAccessToken();
  console.log("成功获取访问令牌（前20位）:", token.substring(0, 20) + "...");
} catch (tokenError) {
  console.error("刷新令牌换取访问令牌失败:", tokenError);
  throw tokenError;
}

如果这一步就报错，那问题肯定出在刷新令牌或客户端凭证上，不用再往下查API调用了。

3. 确认授权Scope的正确性 #

你创建表格需要的是https://www.googleapis.com/auth/spreadsheets权限，虽然你说授权时已经请求了这个Scope，但还是要再确认：

• 授权流程中请求的Scope列表是否包含这个权限？有没有拼写错误？
• 刷新令牌是用包含该Scope的授权请求获取的吗？如果后续修改了Scope，旧的刷新令牌不会自动获得新权限，需要用户重新授权。

4. 检查Firestore数据的读取逻辑 #

你的代码中userID变量是哪里来的？我看代码里直接用了userID但没定义——如果userID是undefined，那credentialsPath就会是无效路径，取到的credsDoc是空的，refreshToken自然也是undefined，这时候调用API肯定401。这部分变量的定义一定要确保正确。

修正后的代码示例 #

结合上面的排查点，我给你调整了代码，加入了更详细的校验和日志：

import { google } from 'googleapis';
import { OAuth2Client } from 'google-auth-library';
import admin from 'firebase-admin'; // 别忘了引入admin，你代码里用了但没写

const GOOGLE_CLIENT_ID = 'YOUR_CLIENT_ID.apps.googleusercontent.com';
const GOOGLE_CLIENT_SECRET = 'YOUR_CLIENT_SECRET';
const userID = 'TARGET_USER_ID'; // 这里要替换成实际的用户ID！

async function createSheetExample() {
  try {
    console.log("尝试创建表格...");
    const db = admin.firestore();
    const credentialsPath = `/users/${userID}/private/googleAuth`;
    const credsDoc = await db.doc(credentialsPath).get();

    if (!credsDoc.exists) {
      throw new Error("未找到该用户的Google授权凭证");
    }

    const oauth2Client = new OAuth2Client(
      GOOGLE_CLIENT_ID,
      GOOGLE_CLIENT_SECRET
    );
    
    const credsData = credsDoc.data();
    if (!credsData.refreshToken) {
      throw new Error("凭证中未找到刷新令牌");
    }

    oauth2Client.setCredentials({
      refresh_token: credsData.refreshToken, // 这里要确保字段名和Firestore中一致
    });

    // 手动验证刷新令牌
    try {
      const { token } = await oauth2Client.getAccessToken();
      console.log("成功换取访问令牌:", token.substring(0, 20) + "...");
    } catch (tokenError) {
      console.error("刷新令牌无效，无法换取访问令牌:", tokenError);
      throw tokenError;
    }

    const sheets = google.sheets({ version: 'v4', auth: oauth2Client });

    const response = await sheets.spreadsheets.create({
      resource: {
        properties: {
          title: 'Test Sheet'
        }
      }
    });

    console.log('表格创建成功，ID:', response.data.spreadsheetId);
  } catch (error) {
    console.error('创建表格失败:', error);
  }
}

createSheetExample();

最后总结 #

大概率的问题是刷新令牌与当前使用的客户端凭证不匹配，或者Firestore中读取的刷新令牌无效/不完整。先从手动换取访问令牌这一步入手排查，能快速定位问题所在。

内容来源于stack exchange