如何查找我的Apollo Graph Ref？Apollo经典图配置故障求助

问题梳理 #

• 当前收到的报错提示：

  您已指定Apollo密钥但未指定graph ref；使用情况报告已禁用。要启用使用情况报告，请将环境变量APOLLO_GRAPH_REF设置为your-graph-id@your-graph-variant。要禁用此警告，请安装ApolloServerPluginUsageReportingDisabled。

• 核心困惑：之前经典图运行正常，因Apollo文档10月4日更新，找不到适配经典图的配置说明，混淆了错误提示里的@分隔格式和Federation 2文档中密钥的:分隔格式

分步解决 #

1. 明确两个格式的不同用途

   • your-graph-id@your-graph-variant是APOLLO_GRAPH_REF环境变量的格式，用来指定你的图ID和变体（比如my-book-graph@production），和Apollo密钥完全无关
   • Federation 2文档里的:格式是Apollo密钥的格式（比如service:my-service:abc123xyz），这是另一个独立环境变量APOLLO_KEY的内容，别搞混两者

2. 获取经典图的graph ref值

   • 登录Apollo Studio，打开你的经典图项目
   • 在图主页的顶部位置，能直接看到类似[图ID]@[变体名]的标识，比如book-store@dev，这就是你需要的APOLLO_GRAPH_REF值

3. 配置环境变量启用使用报告

   • 在你的服务启动环境中，新增环境变量：

     APOLLO_GRAPH_REF=你的图ID@你的变体名
     

   • 原有APOLLO_KEY的配置保持不变，不需要修改

4. 直接禁用警告（不需要使用报告的情况）

   • 先安装对应插件：

     npm install @apollo/server-plugin-usage-reporting-disabled
     

   • 在ApolloServer初始化代码中添加插件：

     import { ApolloServerPluginUsageReportingDisabled } from '@apollo/server-plugin-usage-reporting-disabled';
     
     const server = new ApolloServer({
       typeDefs,
       resolvers,
       plugins: [ApolloServerPluginUsageReportingDisabled()],
     });
     

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