Linux部署React前端+Node后端时执行npm start遇spawn xdg-open ENOENT错误

问题原因 #

执行npm start启动React前端时出现Error: spawn xdg-open ENOENT错误，本质是系统缺失xdg-open工具——React默认启动后会调用该工具自动打开浏览器访问本地服务，Linux环境下依赖xdg-open完成这一操作，工具缺失就会触发报错。

解决方案 #

1. 安装xdg-open工具 #

根据你使用的Linux发行版执行对应命令：

• Debian/Ubuntu 系列：

  sudo apt install xdg-utils
  

• RHEL/CentOS/Fedora 系列：

  sudo dnf install xdg-utils
  

• Arch 系列：

  sudo pacman -S xdg-utils
  

2. 禁用自动打开浏览器（适合无桌面的服务器环境） #

如果不需要启动项目后自动打开浏览器，可通过以下方式关闭该行为：

• 临时生效：直接执行

  BROWSER=none npm start
  

• 永久生效：在项目根目录新建或修改.env文件，添加一行：

  BROWSER=none
  

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