Azure IoT 操作的已知问题

本文列出了使用 Azure IoT作时可能会遇到的当前已知问题。 本指南可帮助你识别这些问题，并提供可用的解决方法。

有关常规故障排除指南，请参阅 Azure IoT 操作疑难解答。

MQTT 代理问题

本部分列出了 MQTT 代理的当前已知问题。

MQTT 代理资源在 Azure 门户中不可见

问题 ID：4257

日志签名：N/A

使用 Kubernetes 在群集中创建的 MQTT 中转站资源在 Azure 门户中不可见。 由于使用 Kubernetes 管理 Azure IoT 运营组件的功能目前处于预览阶段，因此结果是预期的，目前还不支持将资源从边缘设备同步到云。

此问题目前没有解决方法。

常规连接器问题

本部分列出了影响所有连接器的当前已知问题。

连接器不会检测对 Azure Key Vault 中的设备凭据的更新

问题 ID：6514

N/A

更新 Azure Key Vault 中存储的设备凭据时，连接器不会收到通知。 因此，连接器将继续使用旧凭据，直到它重新启动。

解决方法：重启连接器以强制它从 Azure Key Vault 检索更新的凭据。

对于 Akri 连接器，注册表终结点唯一支持的身份验证类型是 artifact pull secrets

问题 ID：4570

日志签名：N/A

在连接器模板中指定注册表终结点引用时，有多个支持的身份验证方法。 Akri 连接器仅支持 artifact pull secrets 身份验证。

Akri 连接器不适用于注册表终结点资源

问题 ID：7710

日志签名：

[aio_akri_logs@311 tid="7"] - failed to generate StatefulSet payload for instance rest-connector-template-...
[aio_akri_logs@311 tid="7"] - reconciliation error for Connector resource... 
[aio_akri_logs@311 tid="7"] - reconciliation of Connector resource failed...

如果使用 bicep 创建 RegistryEndpoint 资源并在 ConnectorTemplate 资源中引用它，则当 Akri 运算符尝试协调 ConnectorTemplate 时，会失败，并出现先前显示的错误。

解决方法：不要将 RegistryEndpoint 资源用于 Akri 连接器。 而是在ConnectorTemplate资源中的ContainerRegistry设置里指定注册表信息。

OPC UA 连接器问题

本部分列出了 OPC UA 连接器的当前已知问题。

不能在事件名称中使用特殊字符

问题 ID：1532

日志签名： 2025-10-22T14:51:59.338Z aio-opc-opc.tcp-1-68ff6d4c59-nj2s4 - Updated schema information for Boiler#1Notifier skipped!

如果事件名称包含特殊字符（例如 #， %或 &），则架构生成失败。 避免在事件名称中使用这些字符来防止架构生成问题。

适用于媒体和 ONVIF 的连接器的问题

本部分列出了媒体连接器的当前已知问题，以及 ONVIF 的连接器。

机密同步冲突

问题 ID：0606

日志签名：N/A

使用机密同步时，请确保机密名称全局唯一。 如果存在同名的本地机密，连接器可能无法检索预期机密。

ONVIF 资产事件目标只能在组或资产级别配置

问题 ID：9545

日志签名类似于：

No matching event subscription for topic: "tns1:RuleEngine/CellMotionDetector/Motion"

目前，ONVIF 资产事件的目标仅在事件组或资产级别被识别。 在单个事件级别配置目标会导致日志条目类似于示例，并且不会将事件数据发布到 MQTT 中转站。

解决方法是，在事件组或资产级别而不是单个事件级别配置事件目标。 例如，在事件组级别使用 defaultEventsDestinations ：

eventGroups:
  - dataSource: ""
    events:
    - dataSource: tns1:RuleEngine/CellMotionDetector/Motion
      destinations:
      - configuration:
          qos: Qos1
          retain: Never
          topic: azure-iot-operations/data/motion
          ttl: 5
        target: Mqtt
      name: Motion
    name: Default
    defaultEventsDestinations:
    - configuration:
        qos: Qos1
        retain: Never
        topic: azure-iot-operations/data/motion
        ttl: 5
      target: Mqtt

数据流问题

本部分列出了数据流的当前已知问题。

数据流资源在操作体验 Web UI 中不可见

问题 ID：8724

日志签名：N/A

使用 Kubernetes 在群集中创建的数据流自定义资源在操作体验 Web UI 中不可见。 由于使用 Kubernetes 管理 Azure IoT 运营组件的功能目前处于预览阶段，因此结果是预期的，目前还不支持将资源从边缘设备同步到云。

此问题目前没有解决方法。

数据流配置文件不能超过 70 个数据流

问题 ID：1028

日志签名：

exec /bin/main: argument list too long

如果为单个数据流配置文件创建超过 70 个数据流，则部署失败并出现错误 exec /bin/main: argument list too long。

为解决此问题，可创建多个数据流配置文件，并将数据流分配到这些配置文件中运行。 每个配置文件的数据流不超过 70 个。

数据流图仅支持特定终结点类型

问题 ID：5693

日志签名：N/A

数据流图 (WASM) 目前仅支持 MQTT、Kafka 和 OpenTelemetry (OTel) 数据流终结点。 OpenTelemetry 终结点在数据流图中只能用作目标。 数据流图不支持其他终结点类型，例如 Data Lake、Microsoft Fabric OneLake、Azure 数据资源管理器和本地存储。

若要解决此问题，请使用受支持的终结点类型之一：

• MQTT 终结点，用于与 MQTT 代理进行双向通信
• Kafka 终结点，用于与 Kafka 代理（包括 Azure 事件中心）进行双向通信
• OpenTelemetry 终结点，用于向可观测性平台发送指标和日志（仅用作目标）

有关数据流图的详细信息，请参阅将 WebAssembly (WASM) 与数据流图配合使用。

在链式图场景中不能多次使用相同的图形定义

问题 ID：1352

无法发送配置

通过使用一个数据流图的输出作为另一个数据流图的输入来创建链式图场景。 但是，如果在此方案中多次尝试使用相同的图形定义，则它当前无法按预期工作。 例如，对两者graph-passthrough:1.3.6graph-1使用相同的图形定义（graph-2）时，以下代码将失败。

      {
          nodeType: 'Graph'
          name: 'graph-1'
          graphSettings: {
            registryEndpointRef: dataflowRegistryEndpoint.name
            artifact: 'graph-passthrough:1.3.6'
            configuration: []
            }
      }
      {
          nodeType: 'Graph'
          name: 'graph-2'
          graphSettings: {
            registryEndpointRef: dataflowRegistryEndpoint.name
            artifact: 'graph-passthrough:1.3.6'
            configuration: graphConfiguration
            }
      }
  nodeConnections: [
      {
          from: {name: 'source'}
          to: {name: 'graph-1'}
      }
      {
          from: {name: 'graph-1'}
          to: {name: 'graph-2'}
      }
      {
          from: {name: 'graph-2'}
          to: {name: 'destination'}
      }
  ]

要解决此错误，请根据需要多次将图定义推送到 ACR，并在每次推送时为场景使用不同的名称或标记。 例如，在描述的方案中，需要使用不同的名称或不同的标记（例如 graph-passthrough-one:1.3.6 和 graph-passthrough-two:1.3.6）两次推送图形定义。