解决electron-builder升级至v26后模块找不到的问题

electron-builder是一个流行的Electron应用打包工具，近期有开发者反馈在从v25升级到v26版本后，应用中使用的form-data模块及其依赖项delayed-stream在打包后无法正确加载的问题。本文将深入分析该问题的原因及解决方案。

问题现象

当开发者将electron-builder从v25升级到v26后，在Linux平台（Ubuntu 24.04）上运行打包后的应用时，控制台会抛出以下错误：

Error: Cannot find module 'delayed-stream'
Require stack:
- /tmp/.mount_APP Co8bvpMS/resources/app.asar/node_modules/combined-stream/lib/combined_stream.js
- /tmp/.mount_APP Co8bvpMS/resources/app.asar/node_modules/form-data/lib/form_data.js

该错误表明electron-builder在打包过程中未能正确包含form-data模块的依赖项delayed-stream，导致运行时模块加载失败。

问题原因

经过深入分析，发现问题主要出现在以下场景：

1. 当使用NPM_CONFIG_PRODUCTION=false和NODE_ENV=production环境变量组合时
2. 通过npm ci而非npm install安装依赖时
3. 在CI/CD环境（如GitHub Actions）中构建时更容易复现

这是由于electron-builder v26在依赖收集和打包逻辑上的调整，导致在某些特定环境下无法正确识别和打包嵌套依赖。

解决方案

electron-builder团队在v26.0.13版本中修复了此问题。开发者可以通过以下步骤解决问题：

1. 确保项目中electron-builder版本升级到至少v26.0.13
2. 在package.json中明确指定electron-builder版本为"^26.0.13"
3. 重新安装依赖并构建项目

最佳实践建议

为避免类似问题，建议开发者在Electron项目中：

1. 保持electron-builder版本更新到最新稳定版
2. 在CI/CD环境中使用与本地开发一致的环境变量配置
3. 对于关键依赖，考虑在package.json中显式声明其版本
4. 建立完善的构建前测试流程，确保所有依赖都能正确打包

总结

electron-builder作为Electron生态中的重要工具，其版本升级可能会带来一些兼容性问题。通过理解问题本质并及时应用官方修复，开发者可以确保应用打包过程的稳定性。此次v26.0.13的更新解决了特定环境下依赖打包不完整的问题，为开发者提供了更可靠的构建体验。