错误

出现问题时，我们的错误消息通常采用以下格式，以便更容易定位问题。

[问题类别] 错误类型 - 详情（请求 ID）

• 问题类别描述问题发生的位置。
• 错误类型描述问题的类型。
• 详情提供有关具体问题的更多信息，以及如何修复的建议。
• 请求 ID是我们用于跟踪对 Ahrefs API 发起调用的标识符。

如果您无法自行解决问题，请在联系支持团队时提供以下信息。

• 一张截图，显示出现问题的图表所使用的字段、日期范围、参数和过滤器。
• 另外，如果图表显示错误，请一并提供请求 ID 和错误消息。

问题类别

连接器配置问题

由于数据源配置无效而导致问题。 请使用有效的设置重新连接您的数据源。

图表问题

数据源配置正确，但在创建图表时使用不当导致出现问题。 错误详情会提供更多信息，说明需要在图表属性面板中更改哪些内容。

访问问题

用于授权的 Ahrefs 账号权限不足，无法使用该连接器。 如果您遇到此错误，但已订阅可访问已配置 Ahrefs 项目的受支持套餐，请携带请求 ID 联系我们的支持团队。

Ahrefs API 问题

Ahrefs API 出现异常。 请查看您的 Ahrefs 控制台了解状态更新，或携带请求 ID 联系我们的支持团队。

错误类型

缺少/无效的配置参数

未提供必需的配置参数值，或提供的值不符合预期格式。 可通过重新连接数据源在全局范围内提供有效值，或在报告中通过覆盖参数在本地提供。

请注意，每个 Ahrefs 字段组可能会对有效配置的定义施加额外限制。 因此，即使数据源配置在全局范围内有效，在构建图表时仍可能出现此错误。

无效的字段组合

请求了无效的字段组合。 为便于使用，我们的连接器将来自多个来源的字段归类为 Ahrefs 报告类型，因此并非所有字段都彼此兼容。 每个连接器的字段参考资料会说明哪些字段可以一起请求。

更多信息，请参阅字段分类。

无效的日期范围

请求了无效的日期范围。 这可能是因为我们某些连接器的字段组会以特殊方式处理日期范围。

日期范围参考资料会说明每个字段组如何使用日期范围参数。

更多信息，请参阅日期范围用法。

不支持的过滤器

应用了使用不支持的运算符的过滤器。

目前，我们不支持“Regex contains”过滤器运算符。

未知字段

请求了某个字段（作为维度、指标或过滤条件表达式的一部分），但 Ahrefs API 无法识别其标识符。 这意味着数据源与 Ahrefs API 的状态已不同步。 通常可通过刷新数据源字段解决。 但请注意，这可能会导致使用该数据源的现有报告出现问题。