使用puppeteer-extra-plugin-stealth的Electron应用macOS公证失败问题咨询
报错根因
macOS的公证扫描机制会递归遍历.app包内的所有文件路径,只要遇到后缀为.app的目录,就会默认将其识别为独立的macOS应用bundle,强制校验其签名格式与结构合法性。而puppeteer-extra-plugin-stealth下的evasions/chrome.app只是用来模拟Chrome浏览器全局chrome.app对象的普通静态资源目录,根本不具备macOS应用的完整结构,自然会触发“bundle format unrecognized”的报错。
可落地方案
- 针对当前你配置
asar: false的场景,不需要针对单个文件夹配置特殊asar规则,直接处理带.app后缀的冲突目录即可:- 利用electron-forge的
afterCopy钩子,在打包完成、公证执行前,将node_modules/puppeteer-extra-plugin-stealth/evasions/chrome.app目录重命名为不带.app后缀的名称(比如chrome_mock_resource) - 同步修改该evasion模块入口文件内所有引用原
chrome.app路径的代码,替换为重命名后的路径。这个目录本身只是存放静态模拟值,没有真实的应用逻辑,重命名完全不会影响stealth插件的反检测功能。
- 利用electron-forge的
- 之前你尝试开启asar打包失效,本质不是asar本身的问题:只要asar开启后,所有node_modules内的文件都会被打包进归档文件,macOS公证流程不会穿透asar包扫描内部路径,本来就可以从根源避开这个误判。之前打包失效大概率是漏配了puppeteer相关的asar解包规则,导致依赖无法正常加载,并不是asar机制本身的问题。
版本溯源说明
puppeteer-extra-plugin-stealth从2.8.0版本开始重构了chrome.app的反检测evasion实现,将原本硬编码在代码里的模拟值拆分到独立的chrome.app目录下存放资源,这就是几个月前旧版本打包正常、新版本触发公证报错的核心差异。旧版本(2.7.x及更早)没有这个独立的同名.app目录,自然不会触发公证误判。
参考配置片段
const path = require("path"); const fs = require("fs"); const config = { packagerConfig: { asar: false, // 打包钩子处理冲突目录 afterCopy: [ (buildPath, electronVersion, platform, arch, callback) => { const evasionDir = path.join( buildPath, "node_modules/puppeteer-extra-plugin-stealth/evasions" ); const originalDir = path.join(evasionDir, "chrome.app"); const renamedDir = path.join(evasionDir, "chrome_mock_resource"); // 重命名目录移除.app后缀 fs.renameSync(originalDir, renamedDir); // 同步修改入口文件的路径引用 const entryContent = fs.readFileSync( path.join(renamedDir, "index.js"), "utf8" ).replaceAll("chrome.app", "chrome_mock_resource"); fs.writeFileSync(path.join(renamedDir, "index.js"), entryContent); callback(); } ] } }
内容的提问来源于stack exchange,提问作者John Smith
相关产品推荐
相关产品推荐

