排查客户端设备的问题 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

排查客户端设备的问题

使用本节中的故障排除信息和解决方案来帮助解决 Greengrass 客户端设备和客户端设备组件的问题。

Greengrass 发现问题

以下信息可排除采用 Greengrass 问题。当客户端设备使用Greengrass s s以确定他们可以连接的 Greengrass 核心设备。

Greengrass 发现问题 (HTTP API)

以下信息可排除采用 Greengrass 问题。你可能会看到这些错误使用 cURL 测试发现 API.

curl: (52) Empty reply from server

您可能会看到此错误Amazon IoT请求中的证书。

检查客户端设备是否附加了证书,以及该证书是否处于活动状态。有关更多信息,请参阅 。将事物或策略附加到客户端证书激活或停用客户端证书中的Amazon IoT Core开发人员指南.

HTTP 403: {"message":null,"traceId":"a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"}

如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

HTTP 404: {"errorMessage":"The thing provided for discovery was not found"}

您可能会看到此错误:您可能会看到此错误:

  • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

  • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

  • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

Greengrass 发现问题 (Amazon IoT Device SDKpython 的 v2)

使用以下信息排除采用 Greengrass 问题Amazon IoT Device SDK适用于Pythy.

awscrt.exceptions.AwsCrtError: AWS_ERROR_HTTP_CONNECTION_CLOSED: The connection has closed or is closing.

您可能会看到此错误Amazon IoT请求中的证书。

检查客户端设备是否附加了证书,以及该证书是否处于活动状态。有关更多信息,请参阅 。将事物或策略附加到客户端证书激活或停用客户端证书中的Amazon IoT Core开发人员指南.

awsiot.greengrass_discovery.DiscoveryException: ('Error during discover call: response_code=403', 403)

如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

awsiot.greengrass_discovery.DiscoveryException: ('Error during discover call: response_code=404', 404)

您可能会看到此错误:您可能会看到此错误:

  • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

  • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

  • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

Greengrass 发现问题 (Amazon IoT Device SDK适用于适用于C+

使用以下信息排除采用 Greengrass 问题Amazon IoT Device SDK适用于适用于适用于适用于的.

aws-c-http: AWS_ERROR_HTTP_CONNECTION_CLOSED, The connection has closed or is closing.

您可能会看到此错误Amazon IoT请求中的证书。

检查客户端设备是否附加了证书,以及该证书是否处于活动状态。有关更多信息,请参阅 。将事物或策略附加到客户端证书激活或停用客户端证书中的Amazon IoT Core开发人员指南.

aws-c-common: AWS_ERROR_UNKNOWN, Unknown error. (HTTP 403)

如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

aws-c-common: AWS_ERROR_UNKNOWN, Unknown error. (HTTP 404)

您可能会看到此错误:您可能会看到此错误:

  • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

  • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

  • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

Greengrass 发现问题 (Amazon IoT Device SDKv2 JavaScript)

使用以下信息排除采用 Greengrass 问题Amazon IoT Device SDKv2 JavaScript.

Error: aws-c-http: AWS_ERROR_HTTP_CONNECTION_CLOSED, The connection has closed or is closing.

您可能会看到此错误Amazon IoT请求中的证书。

检查客户端设备是否附加了证书,以及该证书是否处于活动状态。有关更多信息,请参阅 。将事物或策略附加到客户端证书激活或停用客户端证书中的Amazon IoT Core开发人员指南.

Error: Discovery failed (headers: [object Object]) { response_code: 403 }

如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

Error: Discovery failed (headers: [object Object]) { response_code: 404 }

您可能会看到此错误:您可能会看到此错误:

  • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

  • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

  • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

Error: Discovery failed (headers: [object Object])

运行 Greengrass 发现示例时,您可能会看到此错误(没有 HTTP 响应代码)。出现此错误的原因很多。

  • 如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

    检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

  • 您可能会看到此错误:您可能会看到此错误:

    • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

    • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

    • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

    检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

Greengrass 发现问题 (Amazon IoT Device SDK适用于 Java 的 v2)

使用以下信息排除采用 Greengrass 问题Amazon IoT Device SDK适用于Java.

software.amazon.awssdk.crt.CrtRuntimeException: Error Getting Response Status Code from HttpStream. (aws_last_error: AWS_ERROR_HTTP_DATA_NOT_AVAILABLE(2062), This data is not yet available.)

您可能会看到此错误Amazon IoT请求中的证书。

检查客户端设备是否附加了证书,以及该证书是否处于活动状态。有关更多信息,请参阅 。将事物或策略附加到客户端证书激活或停用客户端证书中的Amazon IoT Core开发人员指南.

java.lang.RuntimeException: Error x-amzn-ErrorType(403)

如果客户端设备无权调用,您可能会看到此错误greengrass:Discover本身。

检查客户端设备的证书是否具有允许greengrass:Discover. 您不能使用事物策略变量(iot:Connection.Thing.*) 在Resource部分获取此权限。有关更多信息,请参阅 发现身份验证和授权

java.lang.RuntimeException: Error x-amzn-ErrorType(404)

您可能会看到此错误:您可能会看到此错误:

  • 客户端设备未与任何 Greengrass 核心设备关联或Amazon IoT Greengrass V1组。

  • 没有客户端设备关联的 Greengrass 核心设备或Amazon IoT Greengrass V1组具有 MQTT 代理终端节点。

  • 客户端设备的关联 Greengrass 核心设备均未运行客户端设备身份验证组件.

检查客户端设备是否与要其连接的核心设备相关联。然后,检查核心设备是否运行客户端设备身份验证组件并且至少包含一个MQTT 代理终端节点。有关更多信息,请参阅下列内容:

MQTT 连接问题

使用以下信息排查客户端设备 MQTT 连接问题。当客户端设备尝试通过 MQTT 连接到核心设备时,可能会出现这些问题。

io.moquette.broker.Authorizator: Client does not have read permissions on the topic

当客户端设备尝试订阅其没有权限的 MQTT 主题时,您可能会在 Greengrass 日志中看到此错误。错误消息包含主题。

检查客户端设备身份验证组件'配置包括以下内容:

  • 与客户端设备匹配的设备组。

  • 该设备组的客户端设备授权策略,该策略授予mqtt:subscribe主题的权限。

有关如何部署和配置客户端设备身份验证组件的更多信息,请参阅以下内容:

MQTT 连接问题 (Python)

使用以下信息排除采用 MQTT 客户端设备 MQTT 连接问题Amazon IoT Device SDK适用于Pythy.

AWS_ERROR_MQTT_PROTOCOL_ERROR: Protocol error occurred

您可能会看到此错误客户端设备身份验证组件未定义授予客户端设备连接权限的客户端设备授权策略。

检查客户端设备身份验证组件的配置是否包括以下内容:

  • 与客户端设备匹配的设备组。

  • 该设备组的客户端设备授权策略,该策略授予mqtt:connect客户端设备的权限。

有关如何部署和配置客户端设备身份验证组件的更多信息,请参阅以下内容:

MQTT 连接问题 (C++)

使用以下信息排除采用 MQTT 客户端设备 MQTT 连接问题Amazon IoT Device SDK适用于适用于适用于适用于的.

AWS_ERROR_MQTT_PROTOCOL_ERROR: Protocol error occurred

您可能会看到此错误客户端设备身份验证组件未定义授予客户端设备连接权限的客户端设备授权策略。

检查客户端设备身份验证组件的配置是否包括以下内容:

  • 与客户端设备匹配的设备组。

  • 该设备组的客户端设备授权策略,该策略授予mqtt:connect客户端设备的权限。

有关如何部署和配置客户端设备身份验证组件的更多信息,请参阅以下内容:

MQTT 连接问题 (Java)

使用以下信息排除采用 MQTT 客户端设备 MQTT 连接问题Amazon IoT Device SDK适用于Java.

software.amazon.awssdk.crt.mqtt.MqttException: Protocol error occurred

您可能会看到此错误客户端设备身份验证组件未定义授予客户端设备连接权限的客户端设备授权策略。

检查客户端设备身份验证组件的配置是否包括以下内容:

  • 与客户端设备匹配的设备组。

  • 该设备组的客户端设备授权策略,该策略授予mqtt:connect客户端设备的权限。

有关如何部署和配置客户端设备身份验证组件的更多信息,请参阅以下内容:

MQTT 连接问题 (JavaScript)

使用以下信息排除采用 MQTT 客户端设备 MQTT 连接问题Amazon IoT Device SDKv2 JavaScript.

AWS_ERROR_MQTT_PROTOCOL_ERROR: Protocol error occurred

您可能会看到此错误客户端设备身份验证组件未定义授予客户端设备连接权限的客户端设备授权策略。

检查客户端设备身份验证组件的配置是否包括以下内容:

  • 与客户端设备匹配的设备组。

  • 该设备组的客户端设备授权策略,该策略授予mqtt:connect客户端设备的权限。

有关如何部署和配置客户端设备身份验证组件的更多信息,请参阅以下内容: