解决 electron-builder 中 node-module-collector 的调用栈溢出问题

问题背景

在使用 electron-builder 26.0.6 版本时，部分开发者遇到了一个严重问题：当构建 Electron 应用时，node-module-collector 模块会抛出"Maximum call stack size exceeded"错误，导致构建过程失败。这个问题主要出现在项目依赖树中存在循环依赖或特殊依赖结构的情况下。

问题分析

electron-builder 的 node-module-collector 模块负责收集和打包项目依赖的 node_modules。在 26.0.6 版本中，该模块在处理某些特殊依赖结构时会出现无限递归，最终导致调用栈溢出。从开发者反馈来看，以下情况容易触发此问题：

1. 项目依赖中包含 @seald-io/nedb 包
2. 使用 npm-run-all 等工具包
3. 存在 react-native-audio-recorder-player 3.5.4 版本
4. 依赖树中存在自引用（包依赖自身）

解决方案

临时解决方案

对于急需构建的项目，可以采用以下临时解决方案：

1. 降级 electron-builder：回退到 25.1.8 或 26.0.1 版本可以避免此问题
2. 使用 patch-package：应用社区提供的补丁修改 node-module-collector 的递归逻辑
3. 调整依赖结构：将运行时依赖移动到 devDependencies 中（适用于已使用 webpack 等工具打包的项目）

根本解决方案

electron-builder 团队已经识别出问题的根源并提供了修复方案。核心改进包括：

1. 添加 skipCircularDeps 标志来跳过循环依赖处理
2. 优化依赖树遍历逻辑，防止无限递归
3. 更智能地判断何时需要填充依赖树

最佳实践建议

为了避免类似问题并优化 Electron 应用构建，建议开发者：

1. 使用代码打包工具：如 webpack 将代码和依赖打包到单个文件中，这不仅能避免 node_modules 收集问题，还能提升应用性能
2. 合理组织依赖：区分开发依赖和运行时依赖，即使使用打包工具也建议保持清晰的依赖结构
3. 关注构建配置：如果确实不需要打包 node_modules，可以通过 beforeBuild 钩子返回 false 来跳过此步骤
4. 保持依赖更新：及时更新可能存在问题的依赖包版本

技术实现细节

问题的技术根源在于 node-module-collector 在处理空依赖对象时的逻辑缺陷。当遇到以下情况时：

1. 主依赖树显示依赖为空
2. 但 _dependencies 中存在记录
3. 系统尝试从全局依赖映射中填充依赖

这种情况下如果没有适当的终止条件，就会导致无限递归。修复方案通过添加 skipCircularDeps 标志和更严格的判断条件来中断这种递归。

总结

electron-builder 26.x 版本引入的新依赖收集器虽然提升了功能，但也带来了新的边缘情况问题。通过理解问题本质和应用适当解决方案，开发者可以顺利构建 Electron 应用。对于已经使用打包工具的项目，完全跳过 node_modules 收集可能是最简洁高效的解决方案。