安装react-dev-utils@11.0.4启动React报path参数错误,react-scripts已最新如何解决?
报错信息:TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined
排查与解决步骤
1. 校验依赖版本兼容性
react-dev-utils是react-scripts的内置依赖,手动单独安装指定版本大概率会和你当前使用的react-scripts版本产生冲突。首先执行以下命令查看本地依赖树中两者的匹配情况:
npm ls react-dev-utils react-scripts
如果输出中存在deduped标记或者版本不一致的冲突提示,说明手动安装的react-dev-utils覆盖了react-scripts内置的版本,这是触发该报错的最常见原因。
2. 移除手动安装的冗余依赖
没有特殊自定义需求的情况下,不要单独安装react-dev-utils,直接删除你手动安装的版本即可:
npm uninstall react-dev-utils
删除后清空缓存重装所有依赖,避免残留文件影响:
# Windows环境可以手动删除node_modules文件夹和package-lock.json文件 rm -rf node_modules package-lock.json npm install
完成后再尝试启动项目,绝大多数场景下该报错会直接消失。
3. 检查自定义webpack配置
如果你的项目使用了craco、react-app-rewired等工具覆写了默认webpack配置,需要检查你编写的配置项中是否存在未赋值的路径变量:
- 排查所有用到
process.env的路径相关配置,确认环境变量在项目启动时被正确赋值 - 检查webpack配置中的
entry、output.path、resolve.alias等字段,确认没有值为undefined的情况
4. 验证Node.js版本兼容性
部分旧版Node.js和新版react-scripts存在兼容性问题,确认你当前使用的Node.js版本符合react-scripts的官方要求:
- react-scripts 5.x 要求Node.js版本 >= 14.0.0
- 执行
node -v查看当前版本,建议切换到长期支持版本(如16.x、18.x)后重试启动
内容的提问来源于stack exchange,提问作者Mayuri Pansuriya
相关产品推荐
相关产品推荐

