项目突发的“怪病”：切换 Node 版本后打包报错

你们有没有过原本好好的项目工程。切换了 Node 版本或者改了一些不相关的配置，接下来它就出异常了？虽然也没改什么总觉的是切到大动脉。最近公司一个老项目突然打包失败，输入命令：

pnpm build:test

结果报错。提示找不到 Collector.js.js。

错误日志摘录

Error: Cannot find module 'E:\gwm-voice-op-mgr-fe-发布
ode_modules\.pnpm\vite-plugin-dts@.0_@types+node@.1_less@.3_sass@.6_typescript@.
ode_modules\@microsoft\api-extractor\lib-commonjs\collector\Collector.js.js'
at createEsmNotFoundErr
at finalizeEsmResolution
at resolveExports
at Module._findPath
at Module._resolveFilename
at Function.resolve
at _resolve
at jiti
at E:/gwm-voice-op-mgr-fe-发布/node_modules/.pnpm/vite-plugin-dts@.0_@types+node@.1_less@.3_sass@.6_typescript@./node_modules/vite-plugin-dts/dist/index.cjs::
at evalModule
at jiti
at E:/gwm-voice-op-mgr-fe-发布/internal/vite-config/src/config/package.ts::
at evalModule
at jiti
at E:/gwm-voice-op-mgr-fe-发布/internal/vite-config/src/index.ts::
at evalModule ELIFECYCLE  Command failed with exit code .

项目结构与错误定位

这是一个 monorepo 项目。错误指向的是 pnpm 依赖解析问题，主要表现为 vite-plugin-dts 在尝试加载 @microsoft/api-extractor 的模块时找不到文件。

关键线索

1. workspace 包配置：internal/vite-config 已在 pnpm-workspace.yaml 中声明为 internal/*但实际加载的文件名是 Collector.js.js。
2. 残留缓存：node_modules 中可能还保留旧的建立产物，这些产物仍然引用已被删除或升级的 vite-plugin-dts 依赖。
3. 版本冲突：Error 方法中出现了 typescript@.而真实安装的是两个不同的 TypeScript 版本：
   • typescript@. – 被 vite-plugin-dts 使用。
   • typescript@. – 被 cosmiconfig-typescript-loader 使用。 怎么说呢，
   这是一种典型的 “多个 TypeScript 实例” 导致的解析错误。

再看根本原因，vite-plugin-dts 与 jiti 的兼容性缺陷

"Collector.js" 文件本身是存在的。却被 jiti 错误地解析成了 "Collector.js.js"

• vite-plugin-dts 在内部使用 动态加载 @microsoft/api-extractor。
• Lack of proper handling for Windows 方法分隔符 + pnpm 的严格依赖结构，使得模块解析出现重复后缀。其实，
• This bug is known in vite-plugin-dts 3.1.0** 与 **jiti** 的兼容性中。

方法这方面，升级并统一依赖版本

The bug has been fixed in later releases of @microsoft/api-extractor. Follow se steps:

1. 升级 vite-plugin-dts：

# 在 internal/vite-config/package.json 中
npm i -D vite-plugin-dts@^4.0 # 或者使用 pnpm
# 推荐使用最新的 4.x 系列，它已经修复了 jti 方法处理逻辑

If you cannot立即升级到 4.x，临时方案是锁定 api‑extractor 版本：
{
再看"pnpm"，{
"overrides": {
"@microsoft/api-extractor": "7.36.0"
}
}
}

统一 TypeScript 版本：
{
"devDependencies": {
"typescript": "^5.4.5"
}。"resolutions": {
"**/typescript": "^5.4.5"
}
}

清理缓存并重新安装：
pnpm clean-install # 等价于 rm -rf node_modules && pnpm i
# 或者手动
rm -rf node_modules pnpm-lock.yaml
pnpm i


pnpm run build:test # 应该不再出现 Collector.js.js 错误

A quick sanity check checklist

• 确认所有 workspace 包都指向同一份 TypeScript。
• 检查 pnpm-lock.yaml 中是否仍残留旧版 vite‑plugin‑dts 或 api‑extractor。
• 确保没有手动在代码里硬编码 “*.js” 后缀。
• 在 CI 环境中加入 -frozen-lockfile --strict-peer-dependencies

# 小结：为什么会遇到这种“神秘”错误？

The root cause lies in a subtle incompatibility 娱乐ween two third‑party tools . When project’s Node runtime or workspace layout changes,resolver mis‑adds an extra “`.js`” suffix。leading to a “module not found” crash that looks like a random file typo but is actually a dependency resolution bug.

If你以后再碰到类似 “找不到 X.js.js” 的报错，请先检查是否涉及动态加载工具还有 monorepo 管理工具的版本兼容性。