GCloud AppEngine Node.js应用首次请求404，后续请求正常求助

从你提供的日志和配置来看，这个问题的核心原因大概率是实例启动后，nginx已经就绪可以接收请求，但你的Node.js GraphQL应用还未完成初始化（比如Schema加载、数据库连接等异步操作），导致首次请求时路由还未注册成功，返回404。

我们可以从以下几个方向排查和解决：

1. 确保应用完全初始化后再监听端口 #

App Engine默认认为只要应用监听了指定端口，就代表服务就绪。但如果你的应用在监听端口后还有异步初始化操作（比如加载GraphQL Schema、连接数据库），此时端口虽然通了，但/graphql路由还没挂载完成，首次请求就会返回404。

解决方法：把所有异步初始化逻辑放在服务器监听之前，比如：

const express = require('express');
const { ApolloServer } = require('apollo-server-express');
const typeDefs = require('./schema');
const resolvers = require('./resolvers');
const connectDB = require('./db');

async function startServer() {
  // 先完成所有异步初始化
  await connectDB(); // 等待数据库连接成功
  const server = new ApolloServer({ typeDefs, resolvers });
  
  const app = express();
  await server.start(); // 等待Apollo Server初始化完成
  server.applyMiddleware({ app });
  
  // 最后启动服务器监听端口
  app.listen(process.env.PORT || 8081, () => {
    console.log(`Go to http://localhost:${process.env.PORT || 8081}/graphql to run queries!`);
  });
}

startServer();

2. 配置自定义健康检查，确保应用就绪后再接收请求 #

App Engine标准环境的默认健康检查会访问根路径/，如果你的应用没有处理这个路径，或者健康检查通过时应用还没准备好，就会出现请求提前路由的情况。

你可以在app.yaml中配置自定义健康检查路径，同时在应用中添加健康检查路由，只有当应用完全就绪时才返回200：

第一步：添加健康检查路由 #

let isAppReady = false;

async function startServer() {
  // ... 初始化逻辑 ...
  
  // 初始化完成后标记应用就绪
  isAppReady = true;
}

app.get('/health', (req, res) => {
  if (isAppReady) {
    res.status(200).send('OK');
  } else {
    res.status(503).send('Service Unavailable');
  }
});

第二步：在app.yaml中配置健康检查 #

runtime: nodejs10
instance_class: F2
service: ...
env_variables: ...

# 配置就绪检查，确保应用完全就绪后再路由请求
readiness_check:
  path: "/health"
  check_interval_sec: 5
  timeout_sec: 4
  failure_threshold: 2
  success_threshold: 2
  app_start_timeout_sec: 30 # 给应用足够的启动时间

3. 检查实例启动流程的时间差 #

从你的日志可以看到：

• nginx在20:46:25.179就绪
• 你的应用在20:46:25左右输出启动日志，但可能实际路由挂载完成还需要一点时间
• 首次POST请求在20:46:25左右返回404，几秒后请求正常

这说明应用启动和nginx就绪之间存在时间差，请求刚好落在了应用还没准备好的窗口。通过上面的健康检查配置，可以让App Engine等待应用真正就绪后再转发请求，避免这个窗口的请求失败。

额外提示 #

• 如果你使用的是Apollo Server，确保调用server.start()后再挂载中间件，这一步是异步的，需要等待完成才能保证路由可用。
• 可以在应用启动时增加日志，记录每个初始化步骤的完成时间，方便排查到底是哪一步耗时导致启动延迟。

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