解决dumi2.0 涉及的项目,突然无法打包的诡异问题。
背景
2023年12月18日,突然发现dumi 2 相关项目,无论是在本地环境,还是jenkins上,都无法再进行打包操作,但本地serve却不受影响。
问题原因与表现
原以为是阿里内部问题,可能会过段时间就恢复,但过去了几天还是没有反应,其官方也没有通知。所以开始自行检查。
初步原因估计
第一想法:dumi阻塞应该与doc解析有关,围绕这个进行审查。并定位到原因:
dumi的 apiParse 对组件解析时,会去尝试解析引入的三方js库,只要三方库没有按照其规范进行书写,就会被阻塞。
本质原因
dumi在系统后台偷偷升级了校验模式。
serve模式解析未调整:采用异步解析机制,不会阻塞启动。
build模式解析任采用同步解析机制,但进行了如下调整:
- 原方式
apiParse会尝试对文件进行解析,并在本地项目的node_modules/@types 里寻找对应的ts类型文件。
如果寻找不到就跳过此问题。 - 现方式
apiParse会尝试对文件进行解析,并在本地项目的node_modules/@types 里寻找对应的ts类型文件。
如果寻找不到就直接向国外网站unpkg.com进行询问,但此时,阻塞发生了,因为得不到 unpkg.com的反馈。
无法打包,也就无法再发布。
最致命的原因:后台强制执行,你无法越过,也无法降级。
解决方案
对unpkg.com进行源替换,替换至 我司 私有库地址。
将解析机制从 本地查询=》unpkg.com查询(特定vpn方可,普通vpn无用)=》跳过
调整为 本地查询=》私有库查询=》taobao源查询=》跳过
相关源指向已接入项目内部,无需开发本地修改,也无需jenkins上进行源替换。