Apollo GraphQL查询在服务器端重复触发的原因排查及解决方案咨询

一、问题归属：大概率是服务器端配置问题 #

因为你的查询在GraphQL Playground中也会自动重新触发，而Playground是直接与服务器交互的，没有前端React的逻辑干扰，所以基本可以排除前端React/useLazyQuery的问题，问题出在服务器端的配置或逻辑上。

二、可能的原因 #

1. 错误的超时配置位置
   你当前把requestTimeout: "1200s"放在了app.listen的origin选项里，这完全无效——Apollo Server的请求超时配置应该在ApolloServer的构造参数中定义，而不是Express的listen方法里。这导致你的超时设置根本没生效，Apollo Server使用了默认的请求超时（通常是30秒）。当你的长耗时任务超过这个默认阈值时，服务器会主动终止请求，而客户端（包括Playground）会自动重试查询，这就造成了“查询重新触发”的现象。

2. 数据库连接与服务器启动顺序错误
   你的代码中，把app.listen放在了mongoose.connect的then回调里，但实际逻辑是：一旦MongoDB连接开始（不是成功）就启动服务器。如果数据库连接延迟，服务器启动后处理请求时可能会遇到数据库连接未就绪的错误，导致查询失败后触发重试。

3. Resolver内部的重复执行逻辑
   检查你的长耗时任务Resolver，是否存在异步操作重复触发、事件监听未正确清理，或者意外的循环逻辑，导致Resolver被多次调用。

三、有效的解决方法 #

1. 修正Apollo Server的超时配置 #

将requestTimeout正确配置到ApolloServer的构造参数中，注意单位是毫秒：

const apollo = new ApolloServer({
  typeDefs,
  resolvers,
  // 设置1200秒的请求超时（1200 * 1000 = 1200000毫秒）
  requestTimeout: 1200000,
});

2. 调整服务器启动与数据库连接的顺序 #

确保先成功连接MongoDB，再启动Apollo Server和Express服务器，避免因数据库未就绪导致的请求失败重试：

const startServer = async () => {
  console.log("[Server] Creating Express Server");
  var dir = "src/graphql/resolvers/audiofiles";
  if (!fs.existsSync(dir)) {
    console.log("[Server] Creating directory ", dir);
    fs.mkdirSync(dir);
  }
  const app = express();
  app.use(cors());

  // 先连接MongoDB，成功后再启动服务器
  console.log("[Server] Connecting to MongoDB");
  try {
    await mongoose.connect("mongodb://localhost:27017/database", { useNewUrlParser: true });
    console.log("[Server] Connected to MongoDB successfully");
  } catch (err) {
    console.error("[Server] Failed to connect to MongoDB", err);
    process.exit(1); // 连接失败直接退出，避免无效启动
  }

  console.log("[Server] Creating ApolloServer");
  const apollo = new ApolloServer({
    typeDefs,
    resolvers,
    requestTimeout: 1200000, // 正确配置超时
  });
  
  // Apollo Server 3+版本需要先调用start()再应用中间件
  await apollo.start();
  apollo.applyMiddleware({ app });

  app.listen({ port: 4000 }, () => 
    console.log(`Server ready at http://localhost:4000${apollo.graphqlPath}`)
  );
};

3. 排查Resolver的重复执行逻辑 #

• 检查你的长耗时任务Resolver，是否存在异步操作（比如Promise）被多次调用的情况；
• 确认是否有事件监听器（如文件变化、数据库触发器）在Resolver执行过程中意外触发了重复执行；
• 在Resolver中添加日志，打印每次执行的时间戳和请求ID，确认是否是同一请求被重复处理，还是新的请求。

4. 验证请求重试来源 #

在GraphQL Playground中，点击右上角的Network标签（Playground内置的网络日志），查看是否有重复的请求记录：

• 如果有重复请求：说明是客户端因服务器超时断开连接而自动重试，此时上述超时配置修正即可解决；
• 如果没有重复请求：说明是服务器端Resolver被多次调用，需要进一步排查服务器的中间件、Apollo插件或Resolver内部逻辑。

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