昨天发的 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 源站进行同步,几分钟后问题就得到了解决。

以上问题,特此记录。

相关推荐
子兮曰2 天前
jev-ultrafast 深度解析:7 秒订机票的浏览器 Agent 是如何炼成的
前端·后端·agent
子兮曰2 天前
Jev 爆发一周:7 秒 Agent 背后的 System One 生态与三场争议
前端·后端·ai编程
前端小万2 天前
写公众号赚了 3000 块后,我做了一款叫 "一键成稿" 的软件
前端·微信小程序
爱勇宝2 天前
ZCode 开源 24 小时:一份没有历史的账本,回答不了"有没有偷代码"
前端·后端·chatglm (智谱)
三十而立洋2 天前
Cookie 详解:从产生到安全,一次讲透
前端·javascript
卡布鲁2 天前
把一个 Vite + Vue3 应用塞进 qiankun (React + Umi3) 主站:十个坑的复盘
前端·javascript·react.js
汉堡大王95272 天前
Jev:不是聊天机器人, 而是一个智能 if 语句
前端·人工智能·后端
梦想很大很大2 天前
从运行事实到回归证据:Workrun 的 Telemetry 与 Evaluation 实践
前端·人工智能·后端
计算机魔术师2 天前
Meta Muse agent 接入 Shopify 的 Shop Pay 实现代理式购物
前端
沙蒿同学2 天前
我用 Go 搭了一条 AI Agent 流水线:从 1 张商品图到一整套淘宝详情页
前端·javascript·后端