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 里面就可以了,经过测试确实是这个问题,又浪费我大半天的时间,不过好在问题总算解决了~

相关推荐
随风一样自由6 小时前
【前端独角兽】刚进入前端领域的前端开发用jQuery还是Vue3?
前端·javascript·vue3·jquery
月走乂山6 小时前
Anything Analyzer MCP 401 Unauthorized 故障排查
electron·故障排查·mcp·claude code·anything analyzer
IMPYLH7 小时前
HTML 的 <data> 元素
前端·html
YHHLAI7 小时前
[特殊字符] 面试中的 Promise —— 从入门到精通
前端·javascript·面试
kyriewen9 小时前
我扒了 GPT-5.6 的全部编程跑分——有一项 OpenAI 没敢放出来
前端·gpt·ai编程
前端H10 小时前
微前端 v3 架构升级:从加载隔离到状态协同
前端·架构·状态模式
陆枫Larry11 小时前
小程序包体积优化:用 SVG 图片替换 iconfont,并保留 CSS 控色能力
前端
环境栈笔记12 小时前
多账号浏览器选型检查清单:Profile、权限、Session 和任务日志怎么评估
前端·人工智能·后端·自动化
前端炒粉12 小时前
手写promise
java·前端·javascript
LaughingZhu12 小时前
智能体经典范式构建:ReAct、Plan-and-Solve 与 Reflection
前端·react.js·前端框架