执行npm run dev时Vite报默认导出匹配错误求助

执行npm run dev命令时遇到如下错误：

Error: Error during dependency optimization:

X [ERROR] No matching export in "node_modules/@XXX/core/src/multicast.ts?sharedworker" for import "default"

    node_modules/@XXX/core/src/operators/multicast.ts:3:7:
      3 │ import SharedWorker from "../multicast?sharedworker";
        ╵        ~~~~~~~~~~~~


    at failureErrorWithLog (C:\Users\aak\repos\XXX\demo\node_modules\esbuild\lib\main.js:1748:15)
    at C:\Users\aak\repos\XXX\demo\node_modules\esbuild\lib\main.js:1207:25
    at C:\Users\aak\repos\XXX\demo\node_modules\esbuild\lib\main.js:1626:9
    at process.processTicksAndRejections (node:internal/process/task_queues:104:5) {
  errors: [Getter/Setter],
  warnings: [Getter/Setter]
}

Node.js v24.14.1

问题出在导入语句的查询后缀?sharedworker上，但npm run build可正常执行，且SharedWorker在Vite预览环境中能正常工作。

Vite开发模式用esbuild做依赖预优化，而esbuild默认不支持带查询后缀的导入解析；生产构建用rollup，对这类语法支持更好，所以会出现dev报错、build正常的差异。以下是几种修复方式：

• 跳过依赖预优化
  在vite.config.js中配置optimizeDeps.exclude，让Vite不对目标文件/包做预优化，转为运行时处理：

  import { defineConfig } from 'vite'
  
  export default defineConfig({
    optimizeDeps: {
      // 排除单个带查询后缀的文件
      exclude: ['@XXX/core/src/multicast.ts?sharedworker']
      // 如果包内多个文件用了这种语法，直接排除整个包
      // exclude: ['@XXX/core']
    }
  })
  

• 修改导入逻辑（有权限调整依赖包时）
  直接修改@XXX/core包内的导入代码，去掉查询后缀：

  1. 将multicast.ts中针对SharedWorker的逻辑拆分到单独文件（比如multicast.sharedworker.ts）
  2. 把原导入语句改为：

     import SharedWorker from "../multicast.sharedworker";
     

• 配置解析别名
  在vite.config.js中添加别名映射，将带查询后缀的路径指向实际文件：

  import { defineConfig } from 'vite'
  import path from 'path'
  
  export default defineConfig({
    resolve: {
      alias: {
        '@XXX/core/src/multicast?sharedworker': path.resolve(__dirname, 'node_modules/@XXX/core/src/multicast.ts')
      }
    }
  })
  

  注意：如果multicast.ts需要根据查询后缀执行不同逻辑，可能需要额外编写Vite插件来处理条件导出逻辑。

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