从Express REST API迁移到GraphQL时Mongoose模型在Resolver中返回超时

问题根因 #

1. 上下文未正确传递Mongoose连接实例
   添加GraphQL订阅后，请求走WebSocket长连接链路，和普通HTTP请求的上下文隔离。如果你的Mongoose连接仅在HTTP请求的上下文里初始化、或者使用了请求作用域的Mongoose实例，WebSocket链路下的Resolver无法拿到有效连接，会一直等待可用连接导致超时。
2. 关联模型未全局注册
   你的完整模型存在跨模型ref关联，若被关联的模型没有在服务启动时全局注册到Mongoose实例，仅在HTTP请求链路下动态加载，WebSocket链路下触发嵌套查询时无法找到对应模型，查询会卡住。
3. Mongoose连接绑定了请求生命周期
   如果把Mongoose连接的建立/销毁绑定在HTTP请求的生命周期上，每次HTTP请求结束就断开连接，而WebSocket是长连接，没有请求结束的触发时机，会导致连接被销毁后后续查询无可用连接。

修复方案 #

• 全局初始化Mongoose连接，不要绑定到任何请求的生命周期，服务启动时仅连接一次：

const mongoose = require('mongoose');
// 服务启动入口处执行一次即可
mongoose.connect(process.env.MONGODB_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true
})
.then(() => console.log('MongoDB连接成功'))
.catch(err => console.error('MongoDB连接失败', err));

• 检查所有模型的注册逻辑，所有用到的模型（包括被ref引用的关联模型）都要在服务启动时通过mongoose.model()完成全局注册，不要动态按需加载。
• 检查GraphQL服务的context构造逻辑，确保HTTP和WebSocket两种链路的请求，都能拿到同一个全局Mongoose实例，不要单独为某类请求初始化连接。
• 可临时给Mongoose查询添加超时参数，快速定位卡住的查询位置：

// 示例：给查询加10秒超时
Owner.find({}).maxTimeMS(10000).exec()

你提到简化模型后功能正常，就是因为简化后去掉了跨模型的ref关联，不需要查询未注册的关联模型，也不需要触发嵌套查询逻辑，所以不会卡住。

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