Meteor 3导入DDP连接外部服务器时出现Vite预转换错误

我正在尝试让运行在localhost:4000的Meteor应用连接到localhost:3000的另一台Meteor服务器，按照文档执行import { DDP } from 'meteor/ddp-client'后，应用直接崩溃，报错：

[vite] (client) Pre-transform error: Failed to resolve import "../common/namespace.js" from "meteor/ddp-client". Does the file exist?

配置信息 #

vite.config.js:

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import { meteor } from "meteor-vite/plugin";

export default defineConfig({
  plugins: [
    meteor({
      clientEntry: "imports/ui/main.js",
      serverEntry: "server/main.js",
      enableExperimentalFeatures: true,
      stubValidation: {
        ignorePackages: ["meteor/mongo"],
      },
    }),
    vue(),
  ],
  optimizeDeps: {
    exclude: ["vue-meteor-tracker"],
  },
});

package.json相关依赖:

...
"dependencies": {
    "@babel/runtime": "^7.23.5",
    "@tailwindcss/postcss": "^4.1.10",
    "@vueuse/core": "^13.5.0",
    "bcrypt": "^6.0.0",
    "flyonui": "^2.2.0",
    "meteor-node-stubs": "^1.2.7",
    "notyf": "^3.10.0",
    "postcss-load-config": "^6.0.1",
    "tailwindcss": "^4.1.10",
    "tailwindcss-motion": "^1.1.1",
    "vue": "^3.5.17",
    "vue-router": "^4.2.5"
  },
  "meteor": {
    "modern": true,
    "mainModule": {
      "client": "client/entry-meteor.js",
      "server": "server/entry-meteor.js"
    },
    "testModule": "tests/main.js"
  },
  "devDependencies": {
    "@faker-js/faker": "^9.9.0",
    "@iconify-json/tabler": "^1.2.19",
    "@iconify/tailwind4": "^1.0.6",
    "@vitejs/plugin-vue": "^5.2.1",
    "autoprefixer": "^10.4.16",
    "meteor-vite": "^3.2.1",
    "postcss": "^8.5.6",
    "prettier": "^3.5.3",
    "prettier-plugin-tailwindcss": "^0.6.13",
    "vite": "^6.0.11"
  }

使用的Meteor Vite包版本：jorgenvatle:vite@1.5.4

解决方案 #

1. 统一meteor-vite版本
   你项目中meteor-vite@3.2.1和jorgenvatle:vite@1.5.4版本不匹配，这是引发模块解析错误的核心原因。建议：

• 升级jorgenvatle:vite到与meteor-vite@3.2.1对应的3.x系列版本
• 或降级meteor-vite到与jorgenvatle:vite@1.5.4兼容的版本

2. 调整DDP使用方式
   暂时避开ES模块导入，改用Meteor全局对象直接调用：

// 替换import语句，直接创建远程DDP连接
const remoteDDP = Meteor.DDP.connect('http://localhost:3000');

如果必须用ES模块导入，可将meteor/ddp-client加入vite的依赖排除列表：

// vite.config.js
optimizeDeps: {
  exclude: ["vue-meteor-tracker", "meteor/ddp-client"],
},

3. 调整meteor-vite插件配置
   关闭实验性特性，避免潜在的模块解析异常：

meteor({
  clientEntry: "imports/ui/main.js",
  serverEntry: "server/main.js",
  enableExperimentalFeatures: false, // 关闭实验特性
  stubValidation: {
    ignorePackages: ["meteor/mongo"],
  },
}),

4. 清理缓存重启项目
   执行以下命令清除编译缓存，排除旧文件干扰：

meteor reset
rm -rf node_modules/.vite
npm install

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