系统更新后运行Next.js项目遇/usr/bin/env: ‘node’: Text file busy错误求助

排查与修复步骤 #

• 检查并终止占用node文件的进程
  系统提示"Text file busy"通常是因为node可执行文件被其他进程锁定，执行命令查看占用进程：

  sudo lsof /usr/bin/node
  

  若输出存在相关进程，使用kill -9 <进程PID>强制终止，之后重新运行yarn dev。

• 降级Node.js版本
  Node.js v22属于较新的大版本，可能与项目依赖、当前Next.js版本存在兼容性冲突。尝试降级到稳定的v20.x版本：

  • 若使用nvm管理版本：

    nvm install 20
    nvm use 20
    

  • 若使用Arch官方包管理：

    sudo pacman -U https://archive.archlinux.org/packages/n/nodejs/nodejs-20.14.0-1-x86_64.pkg.tar.zst
    

    （注：可根据Arch归档仓库的实际可用版本调整下载链接）

• 清理系统文件缓存
  系统更新后可能出现文件系统缓存异常，执行以下命令清理缓存：

  sudo sync && sudo sysctl -w vm.drop_caches=3
  

  清理完成后重启终端，再尝试启动项目。

• 重新安装Node.js及依赖
  若文件损坏导致问题，彻底卸载后重新安装：

  sudo pacman -Rns nodejs npm
  sudo rm -rf ~/.npm ~/.yarn
  sudo pacman -S nodejs npm
  

  重新安装完成后，执行yarn install更新项目依赖，再运行yarn dev。

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