启动React应用报错求助：安装merge-stream后仍遇UNKNOWN读取错误

问题回顾 #

启动React应用时先遇到模块缺失错误：

Error: Cannot find module 'merge-stream'

安装merge-stream后，又出现文件读取异常：

my-app@0.1.0 start
react-scripts start

node:internal/fs/utils:348
throw err;
^

Error: UNKNOWN: unknown error, read
at Object.readSync (node:fs:748:3)
at tryReadSync (node:fs:448:20)
at Object.readFileSync (node:fs:486:19)
at Module._extensions..js (node:internal/modules/cjs/loader:1235:18)
at Module.load (node:internal/modules/cjs/loader:1081:32)
at Module._load (node:internal/modules/cjs/loader:922:12)
at Module.require (node:internal/modules/cjs/loader:1105:19)
at require (node:internal/modules/cjs/helpers:103:18)
at Object. (...\my-app\node_modules\react-scripts\config\webpack.config.js:22:31)
at Module._compile (node:internal/modules/cjs/loader:1218:14) { errno: -4094, syscall: 'read', code: 'UNKNOWN' }

解决方案 #

• 清理并重新安装依赖

  1. 删除项目根目录下的node_modules文件夹：
     Windows系统执行：rmdir /s /q node_modules
     macOS/Linux系统执行：rm -rf node_modules
  2. 删除package-lock.json文件
  3. 重新安装所有依赖：npm install

• 修复文件系统权限与访问问题

  1. 确认当前用户对项目目录有完整的读写权限
  2. Windows用户尝试以管理员身份打开终端，再执行npm start
  3. 检查是否有杀毒软件或系统安全工具锁定了项目文件，暂时关闭后重试

• 重置react-scripts配置
  卸载并重新安装react-scripts，修复可能损坏的配置文件：

  npm uninstall react-scripts
  npm install react-scripts
  

• 检查Node.js版本兼容性
  用node -v查看当前Node.js版本，确保使用LTS版本（如18.x、20.x），版本不兼容时可通过nvm工具切换对应版本

内容的提问来源于stack exchange，提问作者Vít SaiLo Sláma