Electron React Boilerplate 开发 Electron 应用调用底层系统资源库问题

日常开发 Electron 应用的时候,习惯使用脚手架:electron-react-boilerplate 进行开发,今天开发遇到一个问题:

bash 复制代码
A JavaScript error occurred in the main process
Uncaught Exception:
Error: No native build was found for platform=linux arch=x64 runtime=electron abi=116 uv=1 libc=glibc node=18.16.1 electron=26.6.3 webpack=true
    loaded from: /tmp/.mount_sf-offjFWZOf/resources/app.asar/dist

    at g.resolve.g.path (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:433548)
    at g (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:431619)
    at 6237 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:14858)
    at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
    at 6269 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:6100)
    at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
    at 176 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:2:9685)
    at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
    at 9076 (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:535247)
    at n (/tmp/.mount_sf-offjFWZOf/resources/app.asar/dist/main/main.js:14:636823)
Maximum number of clients reached[84362:0530/141312.211021:ERROR:ozone_platform_x11.cc(241)] Missing X server or $DISPLAY
[84362:0530/141312.211053:ERROR:env.cc(255)] The platform failed to initialize.  Exiting.

问题背景

出现这个问题没有任何头绪,在网上也查不到任何信息,但是问题步骤是很容易复现的:

  • 开发环境没问题,正常运行
  • 项目打包没问题,正常打包
  • 打包之后启动应用程序出现上方的报错

并且这个问题也很容易定位,因为回滚到上一个 Commit 版本问题就消失了,因此可以确定是本次引入的,而本次开发过程中代码都是普通的业务代码,并且开发环境是没问题正常启动的,因此唯一确定的变量就是引入了一个新的依赖包 ------ serialport。

解决方案

根据上面的描述,解决方案大致也就清楚了,肯定是这个安装包的问题,但是我的需求就是要使用这个安装包,因此肯定不是包的问题,那么经过查找,发现了这个文档:Electron React Boilerplate Add Dependencies,根据文档描述大致确定了问题:对于 Electron 应用,尤其是需要访问底层系统资源(如串口设备)的库,应该确保它们安装在用于运行时的 package.json 文件中,也就是 ./app/package.json,而不是根目录的 package.json 文件中。

所以,我们只需要把对应的调用系统底层的相关依赖包,安装在 /release/app/package.json 里面就可以了,经过测试确实是这个问题,又浪费我大半天的时间,不过好在问题总算解决了~

相关推荐
前端snow1 小时前
ai agent --- postgreSQL 关系型数据库
前端
星辰徐哥2 小时前
鸿蒙平台 KDevelop 集成开发环境适配实战:基于 Electron 壳方案的跨平台多语言代码编辑器开发
electron·编辑器·harmonyos
卷无止境2 小时前
ECharts:把数据变成故事的可视化利器
前端
Eric_见嘉2 小时前
在职前端 Skill 和 MCP 分享
前端·后端·agent
liangshanbo12152 小时前
面试题:如何优化 Webpack 的打包速度?
前端·webpack·node.js
wengad3 小时前
从 wangEditor 迁到 wangEditor-next
前端·javascript·vue.js
行者-全栈开发4 小时前
【前端/JS框架】CVE-2026-3854:GitHub Enterprise Server X-Stat注入XSS漏洞深度剖析与紧急修复指南
前端·javascript·github
计算机魔术师5 小时前
AMD砸82亿买下李飞飞,这次不卖芯片卖什么?
前端
hzxpaipai5 小时前
杭州企业官网怎么建设?从策划到上线的5步建站方法
运维·服务器·前端·网络
怕浪猫5 小时前
2026年金九银十,我面了22个前端
前端·javascript·面试