Electron v14升级至v15后登录后更新查询失败问题求助

核心原因分析 #

Electron v15 基于 Chromium 94，该版本对 Cookie 的 SameSite 属性、第三方 Cookie 规则做了更严格的默认限制，同时 Electron 内部的会话（session）隔离逻辑也有调整，导致弹窗窗口完成登录后生成的 Cookie 无法被主窗口的后续请求获取，最终触发登录重定向。

具体修复步骤 #

1. 调整 Cookie 的 SameSite 属性 #

确保登录接口返回的 Cookie 显式设置符合跨域场景的属性：

• 若登录页与接口为不同域名，设置 SameSite=None; Secure（需配合HTTPS）
• 同域名场景可设置为 SameSite=Lax 或 SameSite=Strict

如果无法修改后端配置，可在 Electron 中通过拦截响应头强制修改：

const { session } = require('electron');

session.defaultSession.webRequest.onHeadersReceived((details, callback) => {
  const setCookieHeaders = details.responseHeaders['Set-Cookie'];
  if (setCookieHeaders) {
    details.responseHeaders['Set-Cookie'] = setCookieHeaders.map(cookie => {
      if (!cookie.includes('SameSite')) {
        return `${cookie}; SameSite=None; Secure`;
      }
      return cookie;
    });
  }
  callback({ cancel: false, responseHeaders: details.responseHeaders });
});

2. 确保弹窗与主窗口共享会话 #

打开登录弹窗时，必须复用主窗口的会话实例，避免创建独立会话导致 Cookie 隔离：

const mainWindow = BrowserWindow.getFocusedWindow();
const loginWindow = new BrowserWindow({
  parent: mainWindow,
  webPreferences: {
    session: mainWindow.webContents.session, // 共享主窗口会话
    nodeIntegration: false,
    contextIsolation: true // 保持开启，遵循Electron安全规范
  }
});

3. 针对性放宽第三方 Cookie 限制（仅必要时） #

若登录页为第三方域名，Chromium 94 默认阻止第三方 Cookie，可通过配置允许：

const loginWindow = new BrowserWindow({
  webPreferences: {
    partition: 'persist:app-main', // 持久化会话，保证重启后Cookie不丢失
    // 替代webSecurity: false的更安全配置
    experimentalFeatures: {
      thirdPartyCookieBlocking: false
    }
  }
});

注意：webSecurity: false 会大幅降低应用安全性，仅在测试场景临时使用，优先通过调整 Cookie 属性解决问题。

4. 验证 Cookie 域名与路径配置 #

确认登录接口返回的 Cookie 的 domain 匹配后续请求的接口域名，path 设置为 / 或对应接口路径，避免 Cookie 被限制在登录页的子路径下。

5. 排查 Cookie 读取权限 #

登录完成后，可通过主窗口会话读取 Cookie 验证是否存储成功：

mainWindow.webContents.session.cookies.get({ url: 'https://your-api-domain.com' })
  .then(cookies => console.log('当前Cookie:', cookies))
  .catch(err => console.error('读取Cookie失败:', err));

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