Rover CLI 错误代码

错误代码参考

Rover 有一些预定义的错误代码，您可能会遇到。您可以通过运行rover explain <CODE>

此页将作为一个索引，列出所有这些代码及其描述，以便快速参考。

代码

E001

此错误发生在从 GraphQL 站点期望 JSON 响应无法反序列化时。

这很可能是由无效的端点或头部引起的，导致服务器返回的不是 JSON（如 HTML 错误页面）。

请再次尝试使用--log trace运行命令，以查看 GraphQL 站点响应的内容。

如果此错误发生在与 Apollo 注册表交互的命令中，请提交问题并让我们知道！

E002

当尝试构建请求的头部时，如果头部名称无效，则会发生此错误。

无效头部名称的示例包括包含空格和名称中的非 ASCII 字符的头部名称。

为了解决问题，请检查您的标题中是否有任何不寻常的字符。

如果此错误发生在没有提供头部的命令中，请提交问题并让我们知道！

E003

此错误发生在尝试为请求构建头部时，某个头的值无效。

为了解决问题，请检查您的标题中是否有任何不寻常的字符。

如果在没有提供头部的命令上出现此错误，请提交一个 issue并告诉我们！

E004

此错误可能出现在多个地方，指示实际执行请求时发生的错误。

此错误通常发生在无法访问服务器或网络连接丢失时。

要调试，请使用 --log trace 标志来显示遇到的特定错误的更详细日志。

E005

此错误是意外行为，可能是由于在图形注册表中犯的编程错误导致的。

此错误在正常情况下不应发生，但如果发生，请提交一个 issue并告知我们。

E006

此错误是意外行为，可能是由于在 graph registry 中犯的编程错误导致的。

此错误在正常情况下不应发生，但如果发生，请提交一个 issue并告知我们。

E007

此错误发生在对一个非联邦图使用 subgraph 命令时。

要么是你尝试运行的操作所在的图不是联邦的，要么指定的变体不是联邦的。请再次确认所指定的 graph@variant 组合是有效的且是联邦的。

E008

此错误发生在为命令指定了无效的 variant。

请仔细检查拼写或在 Apollo Studio中打开图，以验证你要使用的 variant 是否是有效的。

如果您没有提供格式为 graph@variant 的 variant，则使用默认的 variant，即 current。如果未提供 variant 而遇到此错误，则可能表示默认的 current variant 不存在。

E009

此错误在操作联接图和提供的子图名称不存在时发生。

要查找已发布到图的子图列表，请在 Apollo Studio 中打开图，或运行 rover subgraph list <GRAPH_ID>@<VARIANT>。

E010

此错误可能因 graph 查找问题或身份验证失败而发生。

您没有权限的图将始终出于安全原因显示为不可用。使用 rover config whoami 检查您的 API 密钥，并确保您的 graph ID 拼写正确。

如果适用，请与您的 graph 管理员核实，以确保权限和密钥没有更改。

E011

此错误在 GraphQL 端点的响应无法正确解析时发生。

请检查您的端点是否正确，并使用 --log trace 确保来自服务器的响应是预期的 JSON 响应。如果从服务器收到正确的 introspection 响应后仍然遇到此错误，请提交问题并通知我们！

E012

此错误发生在端点返回 400-599 之间的 HTTP 状态时。

这些错误通常与端点使用不当有关。如果您正在运行 introspection 命令或在组合的端点进行抓取，则可能是您误用了标题或指定了错误的 URL。

检查您的 URL、标题，如果需要，使用 --log trace 运行命令再次查看关于请求/响应的详细信息。

E013

此错误在使用 graph registry 未能识别的 API 密钥时发生。您的密钥可能已被禁用、更改或保存不正确。

尝试运行 rover config whoami 来调试API密钥问题。

检查此命令响应中显示的密钥长度，确保它是您预期的。运行 auth 时，有时会不小心粘贴两次密钥。

E014

这种情况发生在API密钥格式不符合预期时。

注册表API密钥采用以下格式之一

user:my-username:secretkey service:graph-id:secretkey

如果您收到此错误，是因为密钥无法根据这些格式正确解析。运行 rover config whoami 确保您的密钥看起来符合预期。

出于安全考虑，密钥中部被掩盖，但您应该能够看到密钥开头的 user 或 serv，以及密钥的最后几个字符和其长度。

E015

此错误发生时，Rover的版本更新检查失败，因为发布版本格式不正确。

如果您遇到此问题，请新建问题，并让我们知道！

E016

此错误在尝试设置配置配置文件时发生，Rover无法创建存储此信息的目录。

这通常是权限问题。如果系统默认配置目录不可访问，您可以使用 APOLLO_CONFIG_HOME 环境变量来选择不同的目录。有关更多信息，请参阅Rover的配置文档。

E017

此错误在尝试设置配置配置文件时发生，Rover无法确定系统的默认配置目录。

您可以使用 APOLLO_CONFIG_HOME 环境变量来告知Rover保存和查找配置信息的位置。有关更多信息，请参阅Rover的配置文档。

E018

当不正确使用 APOLLO_CONFIG_HOME 环境变量时，会发生此错误。

此变量应该引用存储配置信息的目录，但当前值可能指向文件而不是目录。

检查您的APOLLO_CONFIG_HOME变量以及目标位置

E019

此错误发生在尝试清除罗孚（Rover）的全部本地配置，但未找到时发生。

这可能是因为多次运行rover config clear命令，或者更新了您的APOLLO_CONFIG_HOME变量。

请参阅罗孚的配置文档以了解如何管理罗孚的配置。

E020

当尝试运行需要使用配置配置文件或API密钥的命令时，但未找到，会发生此错误。

这可能是您尚未设置配置配置文件或您的APOLLO_KEY已删除。

运行rover config auth来设置新的配置文件或查看配置文档以了解如何设置和使用罗孚。

E021

当尝试使用找不到的配置配置文件时，会发生此错误。

这最可能是运行带--profile选项的命令或保存新配置文件时的输入错误。

运行apollo config list查看所有可用的配置配置文件列表，或运行apollo config auth设置一个新的配置文件。

请参阅配置文档以获取有关如何设置和罗孚的更多信息。

E022

在尝试加载配置配置文件内容时，没有可加载的非敏感内容会触发此错误。

这很可能是配置配置文件已清除。尝试运行rover config auth并设置新的配置文件。

E023

当尝试使用无效UTF-8路径保存或加载配置配置文件时，会发生此错误。

这可能是由于您的APOLLO_CONFIG_HOME环境变量中的无效路径导致的。

检查您的环境变量或使用--log trace以获得更多信息关于罗孚试图使用的路径。

E024

当罗孚尝试加载经过无效TOML修改的配置配置文件时，会触发此错误。

如果您手动修改了配置文件，请务必再次检查格式是否正确。

如果您没有故意修改配置文件，可能需要删除该配置文件并使用以下命令重新创建：rover config delete --profile <名称> 和 rover config auth --profile <名称>。

如果错误仍然存在，请提交一个 Issue 并告诉我们。

E025

当尝试保存配置文件时发生此错误，并且 Rover 无法将其适当地序列化为 TOML。

如果发生此错误，请提交一个 Issue 并告诉我们。

E026

当 Rover 在尝试加载或保存配置文件时遇到问题，将出现此错误。

这可能是由于配置文件名称中的错误拼写或名称不正确所致。

请检查您的命令使用方式，并使用 rover config list 列出可用的配置文件。

如果错误仍然存在，请提交一个 Issue 并告诉我们。

E027

在处理联合 graph 及其 subgraphs 时出现此错误。当由于错误导致图无法组合时，无法构建最终的 supergraph 模式。

要解决此错误，请检查打印的错误并修正 subgraph 模式。

E028

当 Rover 无法连接到 HTTP 端点时发生此错误。

如果您在运行 introspection 时遇到此错误，请确保您输入了正确的端点，您的网络连接稳定，并且您的服务器正在响应用户请求。您可以尝试再次运行带有 --log=debug 的命令。

E029

当您提议一个无法构建的 subgraph 模式时会发生此错误。

出现构建错误可能有多种原因。此错误应包含有关 为什么 推荐的子图模式无法组合。错误代码参考信息可在此处查找。

一些构建错误是正常工作流程的一部分。例如，如果您正在尝试迁移实体或字段，可能需要发布无法组合的子图。

为了解决这个问题，请稍后再试或联系您的 graph 管理员了解升级计费计划的详情。

配置