Vitest测试GraphQL-Yoga项目时遭遇GraphQLSchema跨模块/领域使用错误

我之前也碰到过一模一样的坑，这种只有在测试环境才冒出来的跨模块实例冲突问题，确实让人摸不着头脑。结合你的情况，我整理了几个亲测有效的解决方向，你可以挨个试试：

1. 强制Vitest使用统一的GraphQL模块实例 #

Vitest基于Vite，它的模块解析逻辑和Node.js原生有所不同，很可能导致同一个GraphQL包被加载了多个副本。你可以在项目根目录新建vitest.config.ts，添加别名配置强制所有graphql导入指向同一个实例：

import { defineConfig } from 'vitest/config';

export default defineConfig({
  resolve: {
    alias: {
      'graphql': require.resolve('graphql'),
    },
  },
  test: {
    environment: 'node', // 确保测试环境是Node.js，避免jsdom带来的模块隔离问题
  },
});

这个配置相当于给Vitest“定死”了graphql的加载路径，不管哪里导入，都用项目根node_modules里的那一个，从根源上避免跨模块实例冲突。

2. 统一GraphQL版本并重新安装依赖 #

虽然你的yarn why显示只有一个graphql版本，但还是可以再做一下版本对齐：

• 把package.json里的resolutions改成和dependencies一致的版本：

  "resolutions": {
    "graphql": "^16.8.1"
  }
  

• 然后彻底清理依赖重新安装：

  rm -rf node_modules yarn.lock
  yarn install
  

有时候Yarn的缓存或者嵌套依赖会偷偷搞小动作，彻底重装能排除这类隐性问题。

3. 检查Vitest与GraphQL-Yoga的版本兼容性 #

你当前用的graphql-yoga@5.15.1和vitest@3.2.4，可能存在一些版本适配问题。可以尝试升级Vitest到最新稳定版：

yarn add vitest@latest -D

或者暂时降级graphql-yoga到5.x的稍旧版本，看看是否能解决冲突。

最后验证 #

修改完配置后，再跑一遍你的测试用例，应该就能摆脱那个烦人的“Cannot use GraphQLSchema from another module or realm”错误了。

内容来源于stack exchange