单仓多包场景的依赖门禁盲区

7 人参与

上次在一个单仓多包的项目里,我照着网上那套锁文件比对脚本接了个门禁,跑了两周都挺安静,安静到我差点以为这块彻底没事了。直到有人问:我们仓库里那个子包新加的依赖,到底是谁选的?我翻了一遍报告,压根没有它。

单仓多包的坑就藏在这儿。我们习惯了把 package-lock.json 当成唯一的真相,可它只记了根目录那棵树。子包自己的 package.json 里多一行、少一行,只要安装后解析结果没有落到你想比对的那些键上,脚本就会安静地给出空结果。原文里那句提醒其实很致命——锁文件内部结构、packages 键的组织方式一旦变化,脚本可能“静默给出空结果”。在单仓里这不是可能,是大概率。

谁选的,得看是哪一行的包

单仓最容易被混为一谈的,是“声明变化”和“解析结果变化”的归属。根目录的 manifest 变了,很好追;某个子包的 manifest 变了,锁文件里往往只表现为一条 workspace 链接或几个提升到根的条目,评审的人扫一眼根 package.json,什么都看不出来。

所以我后来改了个笨办法:把每个子包的 package.json 和根 manifest 一起拉出来,逐个子包做集合比较,新增的直接依赖标上它来自哪个包、哪个版本、resolved 指向哪。传递依赖仍归给父依赖,但我会额外打印“由谁引入”。这一步人工复核最需要,也最省事。

门禁规则别只挂在根上

还有个坑是例外和阻断的粒度。规则写在根,例外却按包名记录,看着没问题,实际上不同子包可能各自用到同名包的不同版本。一个被批准,另一个跟着混过去。分发审批记录时我会把 scope、registry 和引入它的子包一起写进记录,到期日也照填,不然半年后没人说得清当初为什么放过它。

先观察,再动手

现在再让我接这套东西,我大概率不会一上来就阻断。先跑观察模式一两周,把每条新增条目按“直接/传递、来源是否在白名单、integrity 有没有”摊开看,看误报集中在哪种关系上,再决定哪一档该红。真正该立刻断的,还是那几类状态异常:非白名单来源、完整性校验失败、清单和锁文件对不上。

单仓多包的依赖门禁,从来不是少写一条规则,而是没人对“这个包是谁选的”负责。把归属拆到子包这一层,问题才会从“流水线绿了”变成“我知道它为什么绿”。

参与讨论

7 条评论
  • 梦舟客

    子包漏依赖这个太真实了

  • 花猫喵

    锁文件真不能只看根目录

  • 以太漂流

    我们也是靠逐包比较才救回来

  • 逍遥游子

    观察模式跑两周确实稳

  • 夔牛撼地

    例外按包名记容易串版本

  • 人间清醒器

    这个归属拆到子包才靠谱

  • 龙龙飞天

    有没有更轻量的比对脚本?