执行npm run dev时Vite出现「No matching export」错误求助

这个问题的核心是Vite开发阶段依赖预构建用的esbuild，和生产构建用的Rollup对模块查询后缀（?sharedworker）的处理逻辑不一致——Rollup能正确解析这个带参数的模块导出，但esbuild在预优化时找不到对应的默认导出，导致启动开发服务失败。下面是几个可行的解决思路：

• 改用命名导入替代默认导入
  先检查multicast.ts文件在带有?sharedworker查询时的实际导出方式。如果该模块实际上是通过命名导出暴露SharedWorker，而非默认导出，把导入语句改成：

  import { SharedWorker } from "../multicast?sharedworker";
  

  这是最直接的修复方式，因为错误提示明确说找不到default导出，大概率是导入方式和实际导出不匹配。

• 配置Vite的依赖预构建规则
  在vite.config.js/ts中，通过optimizeDeps.esbuildOptions告诉esbuild如何处理这个带查询后缀的模块：

  export default defineConfig({
    optimizeDeps: {
      esbuildOptions: {
        // 添加插件处理查询后缀
        plugins: [
          {
            name: 'resolve-sharedworker-query',
            setup(build) {
              build.onResolve({ filter: /\?sharedworker$/ }, args => {
                // 移除查询后缀，指向实际的ts文件
                return { path: args.path.replace('?sharedworker', '') };
              });
            }
          }
        ]
      }
    }
  });
  

  这个插件会在esbuild解析模块时，去掉?sharedworker查询参数，让它直接处理原始的multicast.ts文件，从而正确识别导出内容。

• 检查模块的条件导出逻辑
  如果multicast.ts里有根据import.meta.url或查询参数动态调整导出的逻辑（比如仅在带有sharedworker查询时才导出），esbuild在预构建时可能无法正确解析这种动态逻辑，导致默认导出不存在。可以调整代码，确保无论是否带有查询参数，都能稳定导出SharedWorker，或者统一使用命名导出避免歧义。

• 升级Vite和esbuild版本
  部分旧版本的Vite/esbuild存在查询后缀模块解析的兼容性问题，执行以下命令升级到最新稳定版：

  npm update vite esbuild
  

  新版本可能已经修复了这类esbuild预构建时的导出识别bug。

补充说明：为什么npm run build和vite preview正常？因为生产构建阶段Vite使用Rollup作为打包器，Rollup对模块查询参数的处理逻辑和esbuild不同，能够正确解析带?sharedworker的模块导出；而vite preview运行的是生产构建后的产物，自然不会有预构建阶段的问题。

内容的提问来源于stack exchange，提问作者striderhobbit