Puppeteer复用Google Sign In Cookie实现已登录访问的问题排查

你写的代码里几个明显的问题直接导致了Cookie功能失效：

• 时序完全错配：点完密码提交按钮之后，只等了1秒就开始抓Cookie，此时Google的登录跳转、人机验证、核心鉴权Cookie下发流程根本没走完，抓到的全是登录流程的临时中间Cookie，完全没有包含维持登录态的核心字段（比如SAPISID、SID这类关键凭证）。
• 写入逻辑被全注释：你写的writeCookies函数里，实际把Cookie内容写进本地文件的两行代码全被注释了，等于跑了半天根本没把Cookie存到磁盘上。
• 调用没加await：writeCookies本身是async异步函数，你调用的时候没加await，函数还没执行完就跑后续逻辑，整个执行时序是乱的。
• 写入路径不合理：把Cookie JSON内容存成后缀为.js的文件，本身虽然不影响内容，但完全不符合文件命名逻辑，后续读取时很容易因为路径、文件类型识别错误读不出内容。
• Cookie注入方式完全错误：
  • 用setExtraHTTPHeaders手动塞Cookie头的方式，只是给单个页面的请求加自定义请求头，浏览器根本不会把这些内容存到自身的Cookie存储里，跨请求、跨页面的时候会被浏览器的Cookie解析逻辑直接覆盖，根本维持不了登录态。
  • 直接把CDP返回的全量Cookie传给page.setCookie，会因为包含大量Chrome内部的冗余字段（比如priority、sameParty、sourceScheme）触发参数校验报错，Puppeteer的setCookie接口只认固定的几个标准Cookie字段。

1. 保存Cookie的正确逻辑 #

const fs = require('fs/promises');
const path = require('path');

async function saveLoginCookies(browser, cookiesSavePath) {
  // 直接从整个浏览器上下文拿全量Cookie，不需要单独创建CDP会话
  const allCookies = await browser.cookies();
  // 过滤掉Puppeteer setCookie接口不兼容的Chrome内部字段
  const cleanedCookies = allCookies.map(cookieItem => {
    const { name, value, domain, path, secure, httpOnly, sameSite, expires } = cookieItem;
    return { name, value, domain, path, secure, httpOnly, sameSite, expires };
  });
  // 实际写入JSON文件
  await fs.writeFile(cookiesSavePath, JSON.stringify(cleanedCookies, null, 2));
  console.log(`成功保存 ${cleanedCookies.length} 条登录Cookie到目标路径`);
}

2. 正确的调用时机 #

点完密码提交按钮之后，必须等页面完全跳转回Gmail域名、网络请求稳定之后再抓Cookie，正确的等待逻辑：

await page.click("#passwordNext > div > button > div.VfPpkd-RLmnJb");
// 等待页面完全跳转到Gmail域名，最长等待60秒（留足人机验证加载时间）
await page.waitForFunction(
  () => location.host.includes('mail.google.com'),
  { timeout: 60000 }
);
// 等页面网络空闲、DOM渲染稳定
await page.waitForNetworkIdle({ idleTime: 2000 });
// 必须加await！把Cookie存到本地json文件
await saveLoginCookies(browser, path.join(__dirname, 'google-login-cookies.json'));

3. 恢复Cookie的正确逻辑 #

async function restoreLoginCookies(browser, cookiesSavePath) {
  // 先检查Cookie文件是否存在
  const fileExists = await fs.access(cookiesSavePath).then(() => true).catch(() => false);
  if (!fileExists) {
    console.log('未找到本地登录Cookie，将执行全新登录流程');
    return false;
  }
  // 读取并解析Cookie
  const rawContent = await fs.readFile(cookiesSavePath, 'utf-8');
  const cookies = JSON.parse(rawContent);
  // 把Cookie注入到整个浏览器上下文，而不是单个页面
  await browser.setCookie(...cookies);
  console.log(`成功加载 ${cookies.length} 条Cookie，跳过登录流程`);
  return true;
}

• Google的核心登录Cookie有效期通常为2年，只要不主动在账号设置里登出所有设备，存下来的Cookie可以长期复用，不需要每次重复登录。
• 恢复Cookie后如果还是被踢回登录页，优先检查存的Cookie包里有没有SAPISID字段，这是Google鉴权最核心的凭证，没有这个字段的Cookie包100%无法维持登录态。
• 如果使用Puppeteer的隐身模式（Incognito），关闭浏览器后Cookie会被自动清空，需要长期复用登录态的场景，要么把Cookie存成JSON文件，要么启动浏览器时配置固定的userDataDir参数。

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