运行npm run dev时客户端提示Cannot find module react-scripts问题求助

安全阿岳

2026-7-5

问题：启动React客户端时提示找不到react-scripts模块

项目scripts配置

根目录package.json中的scripts配置如下：

"scripts": {
    "server": "json-server --watch db.json --port 5000",
    "client": "npm start --prefix client",
    "client-build": "npm run-script build --prefix client",
    "chat": "nodemon index.js",
    "dev": "concurrently \"npm run server\" \"npm run client\"",
    "build": "concurrently \"npm run server\" \"npm run client-build\" \"npm run client\""
  },

错误信息

执行npm run dev时服务端正常启动，但客户端抛出以下错误：

react-scripts start
[1]
[1] node:internal/modules/cjs/loader:1051
[1]   throw err;
[1]   ^
[1]
[1] Error: Cannot find module 'C:\Users\ehsan\Desktop\PDEI\Taghvim\sogo_react_20231127\client\node_modules\react-scripts\bin\react-scripts.js'
[1]     at Module._resolveFilename (node:internal/modules/cjs/loader:1048:15)
[1]     at Module._load (node:internal/modules/cjs/loader:901:27)
[1]     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:83:12)
[1]     at node:internal/main/run_main_module:23:47 {
[1]   code: 'MODULE_NOT_FOUND',
[1]   requireStack: []
[1] }
[1]
[1] Node.js v20.9.0

已尝试的无效操作

清理npm缓存
删除并重装client目录下的node_modules文件夹
单独安装react-scripts包

解决方案

检查react-scripts版本兼容性
你的Node.js版本是v20.9.0，旧版react-scripts不支持该版本。进入client目录执行以下命令升级到最新稳定版：
```
npm install react-scripts@latest
```

重新安装client依赖
进入client目录，删除锁文件后重新安装依赖：

cd client
del package-lock.json  # macOS/Linux用 rm package-lock.json
npm install

单独测试client启动
在client目录直接执行npm start，确认客户端能单独正常启动后，再回到根目录执行npm run dev。
修正concurrently命令的引号问题（Windows环境）
若Windows下引号转义导致异常，可修改根目录scripts中的dev命令为：
```
"dev": "concurrently 'npm run server' 'npm run client'"
```