AWS 自 2026 年 4 月 30 日起，物联网 FleetWise 将不再向新客户开放。现有的 AWS 物联网 FleetWise 客户可以继续使用该服务。[上的《互联移动指南》 AWS提供了有关如何为](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)互联移动解决方案开发和部署模块化服务的指导，这些解决方案可用于实现与 AWS 物联网同等的功能 FleetWise。

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

# 用于解决 AWS 物联网 FleetWise 软件问题的边缘代理
<a name="trouebleshoot-edge-agent"></a>

排查边缘代理软件问题。

**Topics**
+ [问题：边缘代理软件无法启动。](#troubleshooting-issue1)
+ [问题：[错误] [Io TFleetWiseEngine:: connect]: [无法初始化持久性库]](#troubleshooting-issue2)
+ [问题：Edge Agent 软件不收集板载诊断 (OBD) II PIDs 和诊断故障代码 (DTCs)。](#troubleshooting-issue3)
+ [问题：适用于 AWS IoT FleetWise 软件的 Edge Agent 无法从网络收集数据或无法应用数据检查规则。](#troubleshooting-issue5)
+ [问题：[错误] [AwsIotConnectivityModule:: connect]: [连接失败并出现错误] 或 [警告] [AwsIotChannel:: send]: [没有活动的 MQTT 连接。]](#troubleshooting-issue4)

## 问题：边缘代理软件无法启动。
<a name="troubleshooting-issue1"></a>

当边缘代理软件无法启动时，您可能会看到以下错误。
+ 

  ```
  Error from reader: * Line 1, Column 1
  Syntax error: value, object or array expected.
  ```

  **解决方案：**确保 AWS 物联网边缘代理 FleetWise 软件配置文件使用有效的 JSON 格式。例如，请确保逗号使用正确。有关配置文件的更多信息，请执行以下操作下载适用*于 AWS IoT 的 Edge Agent FleetWise 软件开发人员指南*。

  1. <a name="fleetwise-open-console"></a>打开[AWS 物联网 FleetWise 控制台](https://console.aws.amazon.com/iotfleetwise)。

  1. <a name="open-edge-resources"></a>在服务主页的** AWS 物联网入门 FleetWise**部分，选择**探索 Edge Agent**。
+ 

  ```
  [ERROR] [SocketCANBusChannel::connect]: [ SocketCan with name xxx is not accessible]
  [ERROR] [IoTFleetWiseEngine::connect]: [ Failed to Bind Consumers to Producers ]
  ```

  **解决方案：**当边缘代理软件无法与配置文件中定义的网络接口建立套接字通信时，您可能会看到此错误。

  要检查配置中定义的每个网络接口是否可用，请运行以下命令。

  ```
  ip link show
  ```

  要使网络接口联机，请运行以下命令。*network-interface-id*替换为网络接口的 ID。

  ```
  sudo ip link set network-interface-id up
  ```
+ 

  ```
  [ERROR] [AwsIotConnectivityModule::connect]: [Connection failed with error]
  [WARN] [AwsIotChannel::send]: [No alive MQTT Connection.]
  # or 
  [WARN] [AwsIotChannel::send]: [aws-c-common: AWS_ERROR_FILE_INVALID_PATH]
  ```

  **解决方案：**当边缘代理软件无法与 AWS IoT Core建立 MQTT 连接时，您可能会看到此错误。检查以下各项是否配置正确，然后重新启动边缘代理软件。
  + `mqttConnection::endpointUrl`— AWS 账户的物联网设备端点。
  + `mqttConnection::clientID` – 运行边缘代理软件的车辆的 ID。
  + `mqttConnection::certificateFilename` – 车辆证书文件的路径。
  + `mqttConnection::privateKeyFilename` – 车辆私钥文件的路径。
  + 你曾经 AWS IoT Core 调配过车辆。有关更多信息，请参阅 [配置 AWS 物联网 FleetWise 车辆](provision-vehicles.md)。

  有关更多信息，请参阅 [AWS IoT Device SDK for C\$1\$1 常见问题解答](https://github.com/aws/aws-iot-device-sdk-cpp-v2/blob/main/documents/FAQ.md#frequently-asked-questions)。

## 问题：[错误] [Io TFleetWiseEngine:: connect]: [无法初始化持久性库]
<a name="troubleshooting-issue2"></a>

**解决方案：**当边缘代理软件找不到持久性存储时，您可能会看到此错误。检查以下各项是否配置正确，然后重新启动边缘代理软件。

`persistency:persistencyPath` – 用于保存收集方案、解码器清单和数据快照的本地路径。

## 问题：Edge Agent 软件不收集板载诊断 (OBD) II PIDs 和诊断故障代码 (DTCs)。
<a name="troubleshooting-issue3"></a>

**解决方案：**如果 `obdInterface:pidRequestIntervalSeconds` 或 `obdInterface:dtcRequestIntervalSeconds` 配置为 0，您可能会看到此错误。

如果边缘代理软件在自动变速箱车辆中运行，请确保 `obdInterface:hasTransmissionEcu` 配置为 `true`。

如果您的车辆支持扩展控制器局域网（CAN 总线）仲裁 IDs，请确保将其配置`obdInterface:useExtendedIds`为`true`。

## 问题：适用于 AWS IoT FleetWise 软件的 Edge Agent 无法从网络收集数据或无法应用数据检查规则。
<a name="troubleshooting-issue5"></a>

**解决方案：**当违反默认配额时，您可能会看到此错误。


| 资源 | 限额 | 可调整 | 备注 | 
| --- | --- | --- | --- | 
| 信号 ID 的值。 | 信号 ID 必须小于或等于 50,000 | 是 | 边缘代理软件不会从 ID 大于 50,000 的信号中收集数据。建议您在更改此配额之前，先检查信号目录包含多少个信号。 | 
| 每辆车的活跃数据收集方案数量 | 256 | 是 | 建议您在更改此配额之前，先查看已在云端创建了多少个活动以及每个活动包含多少方案。 | 
| 信号历史记录缓冲区的大小。 | 20 MB | 是 | 如果超过此配额，边缘代理软件将停止收集新数据。 | 

## 问题：[错误] [AwsIotConnectivityModule:: connect]: [连接失败并出现错误] 或 [警告] [AwsIotChannel:: send]: [没有活动的 MQTT 连接。]
<a name="troubleshooting-issue4"></a>

**解决方案：**当边缘代理软件未连接到云端时，您可能会看到此错误。默认情况下，Edge Agent 软件 AWS IoT Core 每分钟发送一次 ping 请求并等待三分钟。如果没有响应，边缘代理软件会自动重新建立与云的连接。