WSL2启动Electron时触发SIGTRAP错误求助

问题详情 #

执行yarn start启动Electron应用时，反复出现以下错误：

/home/me/dev/my-electron-app-2/node_modules/electron/dist/electron exited with signal SIGTRAP

环境信息 #

硬件与系统

• AMD Radeon R9 380 Series
• Windows 10 Pro Build 19044.1826
• VcXsrv 1.20.14.0
• WSL2 Ubuntu 18.04 最新版

开发环境

• Node 16.15.0
• Npm 8.5.5

package.json配置

{  
  "name": "myapp",  
  "version": "1.0",  
  "description": "My Desktop App",  
  "main": "main.js",  
  "scripts": {    
    "start": "electron .",  
  },  
  "author": "Me",  
  "license": "Apache-2.0",  
  "dependencies": {    
    "compromise": "^13.11.1",    
    "compromise-numbers": "^1.3.0",    
    "compromise-sentences": "^0.3.0",    
    "electron": "^19.0.8"  
  },  
  "devDependencies": {    
    "electron-packager": "^15.2.0"  
  }
}

已尝试操作 #

• 将Electron从15版本升级至19
• 删除package-lock.json文件
• 确认VcXsrv未被防火墙拦截
• 将WSL从版本1升级至2

解决方法 #

1. 正确配置DISPLAY环境变量 #

WSL2中必须确保DISPLAY变量正确指向VcXsrv：

• 启动VcXsrv时，务必勾选Disable access control选项
• 在WSL终端执行以下命令临时设置（若要永久生效，可将命令添加到~/.bashrc或~/.zshrc文件末尾）：

  export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0
  

• 验证：执行echo $DISPLAY，应输出类似192.168.x.x:0.0的地址

2. 禁用Electron GPU加速 #

AMD显卡在WSL2环境下与Electron GPU加速可能存在兼容性冲突：

• 方式一：修改package.json的start命令

  "scripts": {
    "start": "electron . --disable-gpu"
  }
  

• 方式二：在Electron主进程main.js中添加参数

  const { app } = require('electron');
  app.commandLine.appendSwitch('disable-gpu');
  

• 修改后重新执行yarn start测试

3. 更新WSL2内核与Ubuntu系统 #

Ubuntu 18.04的旧组件可能引发兼容性问题：

# 更新Ubuntu系统
sudo apt update && sudo apt upgrade -y

打开Windows PowerShell执行以下命令更新WSL2内核：

wsl --update

更新完成后执行wsl --shutdown重启WSL，再启动Ubuntu测试

4. 清理缓存并重装依赖 #

残留缓存可能导致异常：

# 清理Electron缓存
rm -rf ~/.cache/electron/
# 删除依赖目录与锁文件
rm -rf node_modules package-lock.json yarn.lock
# 重新安装依赖
yarn install

5. 尝试降级Electron版本 #

部分新版本Electron在WSL2+AMD显卡环境下存在bug，可尝试降级到稳定版：

yarn add electron@18.3.10 --save

执行yarn start测试是否正常启动

内容的提问来源于stack exchange，提问作者A13X