昨天发的 npm 包,却因为 registry 同步问题无法安装使用

用过 HBuilderX 云打包的都知道,云上面的 Android 环境很有限,其实并不能覆盖 uniapp 生态所有的版本,甚至说只能覆盖最新的一两个版本。

如果你需要用到 HBuilderX 安卓云打包,就必须及时跟进 HBuilderX 的版本更新,否则可能会因为编译时和运行时版本不一致而在APP运行时爆出提示,如果这个提示被用户看见,那就有点尴尬。

但有时候我们也不想一直跟进最新的版本,此时只能基于 uniapp 提供的 SDK 自行搭建安卓离线打包环境(这不是本文关注的内容)。

今天是 2023年8月18日,打开 HBuilderX 时提示我更新 3.8.12.20230817 版本,我没有犹豫先进行了更新。

当我打开另一个通过 cli 方式安装 uniapp 开发环境的项目时,则需要通过npx @dcloudio/uvm更新相关编译和运行时环境。因为 cli 方式的项目,它的编译器是跟着项目走的,而不是采用 HBuilderX 内置的编译器。

但是当我执行npx @dcloudio/uvm命令时,报错了。

复制代码
Invalid version: 3.8.12.20230817

于是我先找到@dcloudio/uvm中的version.js相关源码查看,发现它的基本更新步骤是:

  1. 默认情况,优先去分析 HBuilderX 官方的一个版本号相关的 json 文件,拿到最新的版本号。
  1. 然后去 registry fetch 相关包的信息。
  1. 根据自定义的一些规则去匹配版本号,找到相关的 npm 包的具体版本再下载。

分析了基本过程,再考虑问题是:

复制代码
Invalid version: 3.8.12.20230817

那么关键点肯定是没找到这个版本号对应的某些 npm 包的版本。

我首先确定了一下@dcloudio/uvm采用的 registry,默认是 cnpm,也就是国内的 npmmirror。

debug 后发现 npm 找不到其中一个包@dcloudio/vue-cli-plugin-uni的最新版本:

复制代码
No matching version found for @dcloudio/vue-cli-plugin-uni@2.0.2-3081220230817001

于是我到 npm 核实了一下,这个包的2.0.2-3081220230817001版本实际上是存在的。

那么是哪里出了问题呢?我想大概率是 registry 的问题,在国内环境,我们通常会用到 npmmirror,如果镜像站和源站的资源信息不同步,就有可能会出现这个问题。

我们发布 npm 包,都是发布到registry.npmjs.org 。而为了快速下载安装 npm 包,我们又会选择使用registry.npmmirror.com。所以今天遇到的问题是由于两个 registry 不同步导致的。

我们找到 npmmirror 镜像站,发现它提供了一个同步按钮,这真的是太棒了。否则大概率只能焦急地等待镜像站在某个时间点触发同步操作;或者考虑更换 registry,那么 lock 文件也得变,风险太大。

点击这个同步按钮则会从 npmjs 源站进行同步,几分钟后问题就得到了解决。

以上问题,特此记录。

相关推荐
子春一212 分钟前
Flutter 2025 可访问性(Accessibility)工程体系:从合规达标到包容设计,打造人人可用的数字产品
前端·javascript·flutter
白兰地空瓶18 分钟前
别再只会调 API 了!LangChain.js 才是前端 AI 工程化的真正起点
前端·langchain
jlspcsdn1 小时前
20251222项目练习
前端·javascript·html
行走的陀螺仪2 小时前
Sass 详细指南
前端·css·rust·sass
爱吃土豆的马铃薯ㅤㅤㅤㅤㅤㅤㅤㅤㅤ2 小时前
React 怎么区分导入的是组件还是函数,或者是对象
前端·react.js·前端框架
LYFlied2 小时前
【每日算法】LeetCode 136. 只出现一次的数字
前端·算法·leetcode·面试·职场和发展
子春一22 小时前
Flutter 2025 国际化与本地化工程体系:从多语言支持到文化适配,打造真正全球化的应用
前端·flutter
QT 小鲜肉2 小时前
【Linux命令大全】001.文件管理之file命令(实操篇)
linux·运维·前端·网络·chrome·笔记
羽沢313 小时前
ECharts 学习
前端·学习·echarts