Azure IoT Edge带UI自定义模块部署后在Set Modules中消失求助

可能原因与修复步骤 #

1. 修复CreateOptions的JSON格式错误 #

你提供的CreateOptions末尾存在多余逗号，这会导致JSON解析异常——虽然模块能正常运行，但可能影响孪生元数据上报至IoT Hub：

• 原JSON的错误部分：

  "NetworkingConfig": {
    "EndpointsConfig": {
      "host": {}
    }
  },
  

}

- 修正后的完整CreateOptions：
```json
{
  "HostConfig": {
    "Binds": [
      "/dev/mem:/dev/mem",
      "/dev/gpiomem:/dev/gpiomem"
    ],
    "Mounts": [
      {
        "Source": "/dev",
        "Target": "/dev",
        "Type": "bind"
      },
      {
        "Source": "/tmp",
        "Target": "/tmp",
        "Type": "bind"
      },
      {
        "Source": "/tmp/.X11-unix",
        "Target": "/tmp/.X11-unix",
        "Type": "bind"
      }
    ],
    "NetworkMode": "host",
    "Privileged": true
  },
  "Env": [
    "DISPLAY=:0"
  ],
  "NetworkingConfig": {
    "EndpointsConfig": {
      "host": {}
    }
  }
}

• 重新部署修正后的模块配置。

2. 检查模块孪生与同步状态 #

在Edge设备上执行以下命令排查：

• 确认模块运行状态：iotedge list，确保目标模块处于running状态
• 查看模块孪生文档：iotedge module twin <你的模块名称>，检查是否存在格式错误或上报异常
• 重启模块强制同步：iotedge restart <你的模块名称>
• 运行健康检查：iotedge check，排查IoT Hub连接或同步相关的错误

3. 验证IoT Hub部署记录 #

在Azure门户进入目标Edge设备页面，查看Deployment history，检查该模块的部署是否有报错信息，确认部署请求已成功同步到IoT Hub。

4. 检查模块命名规则 #

确保模块名称仅包含字母、数字、连字符、下划线、句点，无空格或特殊字符——不符合规则的名称可能导致IoT Hub无法正常识别模块。

5. 等待同步延迟 #

IoT Hub与Edge设备间的配置同步可能存在5-10分钟的延迟，修正配置后可等待一段时间再刷新Set Modules页面。

内容的提问来源于stack exchange，提问作者NILESH