You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

npx react-native init初始化项目下载模板失败E404报错如何解决

问题根因

初始化失败是多个环境问题叠加导致,核心触发点和连带问题如下:

  • npm版本不兼容:弹出的npm WARN config global --global, --local are deprecated. Use --location=global instead.警告,是因为本地npm 8+版本废弃了旧的全局参数语法,而React Native旧版初始化脚本(含0.65版本内置的init逻辑)仍在调用旧参数,会导致npm子进程执行逻辑异常。
  • npm源或缓存损坏:最终抛出的E404错误是流程中断的直接原因——要么本地npm缓存存在损坏的包索引,要么当前配置的第三方npm镜像源同步延迟,没有拉取到update-browserslist-db@1.0.4版本的包资源,才会返回tgz包404的结果。
  • 依赖冲突为连带问题:提示的react-shallow-renderer与react@18.0.0的peer依赖冲突、部分老旧包停止维护的警告,是因为init脚本默认拉取react-native@latest时匹配的依赖树,和指定的0.65版本模板依赖要求不匹配(RN 0.65原生适配React 17版本),这类警告本身不会直接导致初始化失败,但会在npm执行异常时放大报错概率。
修复步骤

按顺序执行以下操作即可解决问题:

  1. 先修复npm参数兼容问题,执行命令升级npm到最新稳定版,强制使用新的location参数:
npm install -g npm@latest --location=global

执行完成后输入npm -v验证版本,确认版本号≥8.12,再次执行npm全局命令时不会弹出旧参数废弃警告。
2. 重置npm缓存和源配置:
执行npm cache clean --force强制清空本地所有包缓存,如果你当前使用的是第三方镜像源,先切换到官方源执行初始化,避免源同步不及时的问题;如果官方源网络访问不稳定,再更换同步频率高的国内镜像,不要使用更新延迟超过24小时的小型镜像站。
3. 初始化项目时指定匹配的CLI版本,避免自动拉取不兼容的最新依赖:

  • 如果要初始化0.65版本的项目,不要直接用本地全局的react-native命令,直接指定对应版本的CLI执行:
npx react-native@0.65 init BMO --version 0.65.1
  • 如果要初始化最新版项目,先全局安装官方最新版CLI再执行初始化:
npm install -g @react-native-community/cli@latest --location=global
npx react-native init MyApp
  1. 如果以上操作后仍报404错误,直接手动删除本地npm缓存目录C:\Users\Admin\AppData\Local\npm-cache,再重新执行初始化命令即可。

注:初始化过程中出现的source-map-url、urix等老旧包废弃提示属于RN旧版本依赖树的历史遗留问题,不影响项目正常编译运行,项目初始化完成后执行npx browserslist@latest --update-db即可消除browserslist相关提示。

内容的提问来源于stack exchange,提问作者XIEE

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 03:33:22