Windows环境下执行npx create-react-app创建项目报spawn UNKNOWN错误
Windows 10 20H2环境下
create-react-app报spawn UNKNOWN错误的解决方案 问题基本特征
- 适用环境:Windows 10 20H2操作系统、Node.js v14.15.4版本
- 触发操作:在D盘根目录执行
npx create-react-app abc命令创建React项目 - 流程表现:npx完成67个临时依赖的拉取安装后,在执行react、react-dom、react-scripts、cra-template核心依赖安装步骤时异常中断,抛出通用UNKNOWN类型错误,errno值为-4094;流程终止后会自动清理临时生成的package.json文件、D盘下的abc项目目录
- 报错定位:异常触发点为cross-spawn组件拉起子进程的逻辑,位于npx缓存路径下的create-react-app源码中,系统未返回细分的权限、路径类错误提示,仅返回spawn UNKNOWN通用标识
- 问题跟进状态:已同步提交至create-react-app官方GitHub仓库记录
可直接落地的解决操作
- 替换执行逻辑,跳过npx临时拉取流程
全局安装兼容版本的create-react-app,执行命令:
安装完成后直接调用全局命令创建项目,避开npx缓存目录下cross-spawn组件的进程调用权限异常。npm install -g create-react-app@5.0.0 - 调整终端运行权限
右键选择「以管理员身份运行」打开系统终端,切换到D盘目标目录后再执行项目创建命令。Windows 10 20H2版本对非管理员进程的子进程生成、磁盘根目录写入操作存在拦截规则,无明确弹窗提示时仅会返回spawn UNKNOWN通用错误。 - 修正npm脚本执行shell配置
先执行命令查看当前npm配置的脚本shell路径:
若返回值为空或指向无效路径,手动绑定系统自带的cmd执行路径:npm config get script-shell
Node.js v14.15.4在Windows环境下不会自动绑定系统shell路径,配置缺失会直接导致cross-spawn无法拉起npm安装子进程,触发UNKNOWN报错。npm config set script-shell "C:\\Windows\\System32\\cmd.exe" - 清理异常npx缓存
若上述操作后依然报错,手动删除npx生成的异常缓存目录C:\Users\Gilang\AppData\Roaming\npm-cache\_npx\17768,重新执行创建命令即可。
内容的提问来源于stack exchange,提问作者velociraptor11
相关产品推荐
相关产品推荐

