Electron项目扩展加载方法及Chrome Manifest v3扩展加载失败（含onRemoved、onClicked错误）的解决问询

我来帮你一步步拆解并解决遇到的这些问题，Electron 41基于Chrome 120，对Manifest V3扩展的支持有特定要求，咱们逐个击破：

1. 关于弃用提示（你已经做对了） #

你看到的'session.loadExtension' is deprecated只是一个版本迭代的提示，你代码里用的current_session.extensions.loadExtension()已经是Electron推荐的新写法，完全没问题，这个提示不用理会，只是告知旧API后续会被移除而已。

2. 解决Service Worker注册失败（状态码15） #

错误日志里的Service worker registration failed. Status code: 15大概率是这两个原因：

• 检查Manifest的service_worker路径：确保background.service_worker字段的路径是相对扩展根目录的正确路径，比如你的background.js在扩展根目录下，应该写：

  "background": {
    "service_worker": "background.js"
  }
  

  别写绝对路径或错误的相对路径，否则Electron找不到这个文件。
• 启用ExtensionServiceWorker特性：Electron默认可能没开启V3扩展的Service Worker支持，需要在app启动时添加命令行参数：

  const { app } = require('electron');
  
  app.whenReady().then(() => {
    // 启用扩展Service Worker支持
    app.commandLine.appendSwitch('enable-features', 'ExtensionServiceWorker');
    // 可选：禁用可能干扰的跨域特性
    app.commandLine.appendSwitch('disable-features', 'OutOfBlinkCors');
  });
  

3. 解决Cannot read properties of undefined (reading 'onRemoved')错误 #

这个错误说明你的扩展background.js里尝试访问的某个Chrome API对象是undefined（比如chrome.tabs.onRemoved或chrome.runtime.onRemoved），可以从这几点排查：

• 权限未正确声明：检查manifest.json里是否添加了所需权限，比如用到tabsAPI的话，必须声明：

  "permissions": ["tabs", "storage"] // 根据你的扩展功能添加对应权限
  

• 简化代码定位问题：先把background.js简化成最基础的逻辑测试，比如：

  console.log('Background service worker loaded');
  chrome.runtime.onInstalled.addListener(() => {
    console.log('Extension installed');
  });
  

  确认能正常加载后，再逐步加回原有逻辑，找到触发错误的具体API。
• 测试默认Session：你用了自定义分区的session，先尝试用默认session加载扩展，排除分区配置的影响：

  const { session } = require('electron');
  await session.defaultSession.extensions.loadExtension(extensionPath);
  

4. 额外的关键配置 #

加载Chrome扩展时，对应的BrowserWindow必须满足以下配置，否则会干扰扩展运行：

new BrowserWindow({
  webPreferences: {
    nodeIntegration: false, // 必须禁用Node集成
    contextIsolation: true, // 必须开启上下文隔离
    webSecurity: true // 确保Web安全开启
  }
});

另外，所有session和扩展加载的操作都要放在app.whenReady()之后执行，避免Electron的session系统未初始化完成。

建议你先从一个最小的Manifest V3扩展（仅包含基础service worker和权限）开始测试，确认加载流程没问题后，再导入你原来的扩展逐步排查。

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