Vite SSR 中 export * 与命名导出冲突问题解析

问题背景

在 Vite 的服务器端渲染(SSR)功能中，存在一个关于模块导出的特殊问题：当模块中同时存在export *和命名导出时，Vite SSR 的导出行为与原生 Node.js 模块系统不一致。

问题重现

假设我们有以下两个模块文件：

dep.js

export const a = "dep-a"
export const b = "dep-b"
export const c = "dep-c"

main.js

export const a = "main-a"
export * from "./dep.js"
export const c = "main-c"

在原生 Node.js 环境下，导入main.js会得到：

{ a: 'main-a', c: 'main-c', b: 'dep-b' }

但在 Vite SSR 环境下，却会得到：

{ a: 'dep-a', b: 'dep-b', c: 'main-c' }

问题分析

这个问题的根源在于 Vite SSR 的运行时导出处理逻辑。Vite SSR 在转换模块时会：

1. 首先处理命名导出（如export const a）
2. 然后处理export *导出
3. 最后处理后续的命名导出

在当前的实现中，export *会无条件地覆盖所有同名导出，而根据 ECMAScript 规范，本地命名导出应该优先于export *的导出。

技术细节

Vite SSR 的模块转换过程会生成类似如下的代码：

const a = 'main-a';
Object.defineProperty(__vite_ssr_exports__, 'a', {
       enumerable: true,
       configurable: true,
       get() { return a; }
});

const __vite_ssr_import_0__ = await __vite_ssr_import__('./dep.js');
__vite_ssr_exportAll__(__vite_ssr_import_0__);

const c = 'main-c';
Object.defineProperty(__vite_ssr_exports__, 'c', {
       enumerable: true,
       configurable: true,
       get() { return c; }
});

关键在于__vite_ssr_exportAll__函数的实现，它目前会覆盖所有导出，而实际上应该跳过已经存在的导出。

解决方案

正确的做法是修改__vite_ssr_exportAll__的实现逻辑，使其在复制导出时检查目标对象是否已经存在同名属性，如果存在则跳过。这样可以确保：

1. 本地命名导出的优先级高于export *导出
2. 后续的命名导出不会被前面的export *覆盖
3. 保持与原生模块系统一致的行为

总结

这个问题虽然看起来是一个边缘情况，但对于依赖精确导出行为的应用程序来说非常重要。Vite SSR 需要严格遵循 ECMAScript 模块规范，确保导出优先级和覆盖行为的正确性。通过修改运行时导出逻辑，可以解决这个不一致性问题，使 Vite SSR 的行为与原生模块系统保持一致。