使用Apollo Studio发布GraphQL查询后无法在Explorer访问的问题

以下是针对「Schema已发布但Explorer无法查询新增字段」问题的排查和解决步骤：

1. 核对Schema发布的目标环境 #

• 检查你的rover发布命令，确认是否指向了Explorer当前正在使用的环境（比如prod、staging）。举个例子，如果执行的是rover graph publish my-graph@staging --schema ./schema.graphql，但Explorer选的是prod环境，自然看不到新增字段。
• 到Apollo Studio的「Schema」页面切换环境，确认getApolloQuery确实存在于你当前用的环境Schema里。

2. 验证Schema定义的正确性 #

• 确认新增查询是定义在type Query类型下，语法没有问题，正确示例如下：

  type Query {
    getApolloQuery: Shipment!
  }
  
  type Shipment {
    _id: ID!
    shipmentNumber: String!
  }
  

• 用rover graph check命令校验Schema合法性，避免语法错误或冲突：

  rover graph check my-graph@prod --schema ./schema.graphql
  

3. 重置Explorer的Schema缓存 #

• 先刷新Explorer页面，如果还是不行，手动重置缓存：点击Explorer右上角的设置图标，选择「Reset Schema Cache」，之后再尝试执行查询。
• 确认Explorer顶部显示的Schema版本，和「Schema」页面里的最新版本号一致。

4. 检查服务器/网关的Schema同步 #

• 如果用了Apollo Gateway这类网关，检查网关是否拉取到了最新Schema，部分网关需要重启或手动触发更新才能生效。
• 绕过Explorer，直接用curl或Postman向服务器发请求，验证字段是否可用：

  curl -X POST -H "Content-Type: application/json" -d '{"query": "{ getApolloQuery { _id shipmentNumber } }"}' https://your-graphql-endpoint.com
  

  要是直接请求能成功，问题就在Explorer的配置或缓存；要是也失败，说明服务器没部署最新的Schema。

5. 排查权限配置 #

• 确认Apollo Studio使用的API Key有访问新字段的权限，部分权限规则会限制对新增字段的访问。
• 到「Access Control」页面，检查当前API Key的权限是否包含查询getApolloQuery的权限。

正确查询示例 #

query GetApolloQuery {
  getApolloQuery {
    _id
    shipmentNumber
  }
}

预期返回结果 #

{
  "data": {
    "getApolloQuery": {
      "_id": "6641e71ec83611860bf04ace",
      "shipmentNumber": "TGLO-30062"
    }
  }
}

内容的提问来源于stack exchange，提问作者Niraj C S