Google API无数据库存储刷新令牌及续用问题求助

一、首次获取并存储Refresh Token到本地JSON #

要拿到refresh token，必须在授权阶段开启离线模式：

• 调用generateAuthUrl时，必须设置access_type: 'offline'，同时加上prompt: 'consent'（首次授权或需要重新获取refresh token时用，避免只返回access token）
• 用户完成授权后，用拿到的授权码调用getToken(code)，会得到包含refresh token的响应对象
• 用文件系统工具把tokens对象写入本地JSON文件，Node.js示例代码：

const fs = require('fs');
const { google } = require('googleapis');

// 初始化OAuth2客户端
const oauth2Client = new google.auth.OAuth2(
  '你的客户端ID',
  '你的客户端密钥',
  '你的重定向URI'
);

// 生成授权URL
const authUrl = oauth2Client.generateAuthUrl({
  access_type: 'offline', // 开启离线模式才能拿到refresh token
  prompt: 'consent', // 强制用户授权，确保返回refresh token
  scope: ['https://www.googleapis.com/auth/drive'] // 替换为你的API所需权限
});

// 用户授权后拿到code，调用此方法获取并存储tokens
oauth2Client.getToken('用户授权后的code', (err, tokens) => {
  if (err) return console.error('获取access token失败:', err);
  // 将tokens写入本地JSON文件
  fs.writeFileSync('./google-tokens.json', JSON.stringify(tokens));
  console.log('Refresh token已保存到本地文件');
});

二、从本地JSON读取Refresh Token并生成新Access Token #

存好refresh token后，每次调用API前可以用它刷新access token：

const fs = require('fs');
const { google } = require('googleapis');

// 初始化OAuth2客户端
const oauth2Client = new google.auth.OAuth2(
  '你的客户端ID',
  '你的客户端密钥',
  '你的重定向URI'
);

// 读取本地存储的tokens
const savedTokens = JSON.parse(fs.readFileSync('./google-tokens.json'));
// 将refresh token设置到客户端
oauth2Client.setCredentials({
  refresh_token: savedTokens.refresh_token
});

// 刷新获取新的access token
oauth2Client.refreshAccessToken((err, newTokens) => {
  if (err) return console.error('刷新access token失败:', err);
  // 如果返回了新的refresh token（极少数情况会更新），同步更新本地文件
  if (newTokens.refresh_token) {
    savedTokens.refresh_token = newTokens.refresh_token;
    fs.writeFileSync('./google-tokens.json', JSON.stringify(savedTokens));
  }
  // 更新客户端凭证
  oauth2Client.setCredentials(newTokens);
  
  // 示例：调用Google Drive API
  const drive = google.drive({ version: 'v3', auth: oauth2Client });
  drive.files.list({}, (err, res) => {
    if (err) return console.error('API调用出错:', err);
    console.log('文件列表:', res.data.files);
  });
});

三、本地JSON存储常见报错排查 #

如果存储时出现报错，优先检查这几点：

• 文件权限：程序没有目标路径的读写权限，检查运行程序的用户权限，或更换可读写的文件路径
• JSON序列化错误：确保写入时用JSON.stringify()处理tokens对象，不要直接写入原始对象
• 路径不存在：指定的JSON文件所在目录未创建，先手动创建目录再执行写入操作
• 授权码无效：调用getToken时拿到的tokens为空，检查授权码是否过期、客户端信息是否正确

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