npm start启动React项目失败，报错提示找不到与项目无关的目录如何解决？

架构老林

2026-10-17

错误根因

该错误是Windows系统 + 旧版本react-scripts组合的已知问题：C:\Users\DawsonSchaffer\Documents\My Music 是Windows默认创建的系统junction软链接，默认没有开放普通用户的读取权限。你使用的react-scripts@3.2.0是2019年发布的旧版本，依赖的webpack开发服务会递归扫描项目上层目录查找配置文件，扫描到这个无权限的软链接时就会抛出ENOENT报错。

解决方案

方案1：升级react-scripts（首选）
该bug在后续react-scripts版本中已经被官方修复，直接执行升级命令即可：
```
npm install react-scripts@latest --save
```
升级完成后重新执行npm start启动项目。
方案2：迁移项目目录
如果你的项目当前存放在C:\Users\DawsonSchaffer\Documents目录下，直接将整个项目文件夹移动到C:\work、C:\projects这类非用户Documents目录下，即可避免webpack扫描到系统软链接。
方案3：添加.env配置临时规避
若暂时不能升级react-scripts，可在项目根目录新建名为.env的文件，添加如下配置：
```
SKIP_PREFLIGHT_CHECK=true
```
配置保存后重新启动项目即可。