Electron 22.0.3 Linux环境下会话Cookie持久化问题

问题根源 #

你遇到的重复登录问题，核心是浏览器同源策略的隔离机制：不同域名的BMS系统会被视为独立站点，默认情况下Electron的会话会分别存储它们的Cookie，但当你在单窗口中切换到其他域名后，返回原域名时，若会话未被正确持久化，之前的登录Cookie会丢失，导致需要重新登录。

解决方案 #

以下是两种可靠的实现方式，优先推荐第一种原生会话持久化方案：

1. 使用自定义持久化Session实例 #

Electron允许创建独立的Session对象，并指定存储路径，让会话数据（Cookie、缓存等）持久化到磁盘，直到应用退出。这样不同BMS的会话数据会被分别存储，切换时自动读取。

主进程代码示例

const { app, BrowserWindow, session } = require('electron');
const path = require('path');

let mainWindow;
let bmsSession;

app.whenReady().then(() => {
  // 创建自定义会话，指定存储目录（位于userData下的bms-session文件夹）
  const sessionPath = path.join(app.getPath('userData'), 'bms-session');
  bmsSession = session.fromPath(sessionPath);

  // 可选：适配SameSite属性，解决跨域名Cookie携带问题
  bmsSession.webRequest.onHeadersReceived((details, callback) => {
    callback({
      responseHeaders: {
        ...details.responseHeaders,
        'Set-Cookie': details.responseHeaders['Set-Cookie']?.map(cookie => 
          cookie.replace(/SameSite=(Strict|Lax)/g, 'SameSite=None; Secure')
        ) || []
      }
    });
  });

  // 创建主窗口并绑定自定义会话
  mainWindow = new BrowserWindow({
    webPreferences: {
      session: bmsSession, // 关键：将窗口与自定义会话绑定
      preload: path.join(__dirname, 'preload.js'),
      devTools: false,
      kiosk: true
    }
  });

  // 初始化加载第一个BMS URL
  mainWindow.loadURL('http://your-first-bms-url');
});

// 切换URL时直接使用当前窗口的loadURL，会话会自动复用
function switchToNextUrl(url) {
  mainWindow.loadURL(url);
}

说明

• session.fromPath() 创建的会话会将所有站点的Cookie、缓存数据持久化到指定目录，应用重启后也会保留（若需要仅保留到本次退出，可在app.on('quit')事件中删除该目录）。
• 修改SameSite属性：部分BMS可能设置了SameSite=Strict，导致跨域名切换时Cookie不被携带，通过webRequest拦截修改为SameSite=None; Secure可解决此问题（仅适用于局域网非敏感场景）。

2. 手动管理BMS登录Cookie（备选方案） #

若原生会话方案仍有问题，可手动捕获并存储每个BMS的登录Cookie，切换时重新注入。

Preload脚本代码

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

// 登录成功后，提取当前站点的Cookie并发送到主进程存储
window.saveBmsSession = () => {
  const domain = window.location.hostname;
  const cookies = document.cookie.split(';').map(cookie => {
    const [name, value] = cookie.trim().split('=');
    return { domain, name, value };
  });
  ipcRenderer.send('store-bms-cookies', cookies);
};

// 接收主进程发送的Cookie并注入当前页面
ipcRenderer.on('inject-bms-cookies', (event, cookies) => {
  cookies.forEach(cookie => {
    document.cookie = `${cookie.name}=${cookie.value}; domain=${cookie.domain}; path=/`;
  });
});

主进程代码

const fs = require('fs');
const path = require('path');
const { ipcMain } = require('electron');

const cookieStorePath = path.join(app.getPath('userData'), 'bms-cookies.json');
let storedCookies = {};

// 初始化加载已存储的Cookie
if (fs.existsSync(cookieStorePath)) {
  storedCookies = JSON.parse(fs.readFileSync(cookieStorePath));
}

// 存储Cookie到本地文件
ipcMain.on('store-bms-cookies', (event, cookies) => {
  cookies.forEach(cookie => {
    if (!storedCookies[cookie.domain]) storedCookies[cookie.domain] = [];
    storedCookies[cookie.domain].push(cookie);
  });
  fs.writeFileSync(cookieStorePath, JSON.stringify(storedCookies));
});

// 切换URL前注入对应域名的Cookie
function switchToNextUrl(url) {
  const domain = new URL(url).hostname;
  const cookies = storedCookies[domain] || [];
  mainWindow.webContents.send('inject-bms-cookies', cookies);
  // 延迟加载URL，确保Cookie注入完成
  setTimeout(() => {
    mainWindow.loadURL(url);
  }, 500);
}

注意事项 #

• 确保所有BMS系统的登录Cookie没有设置expires或max-age为极短时间，否则会自动过期。
• 由于你的应用运行在kiosk模式且无敏感数据，上述方案的安全风险在可控范围内。

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