已更新连接字符串，但Azure IoT Hub中设备模块仍显示断开连接

基础验证步骤 #

• 检查连接字符串正确性
  确认/etc/adu/du-config.json中的connectionString完全匹配IoT Hub设备的主/副连接字符串，避免多余空格或特殊字符。可通过以下命令快速验证：

  cat /etc/adu/du-config.json | grep connectionString
  

• 重启Agent服务并检查状态
  配置修改后必须重启服务才能生效：

  sudo systemctl restart deviceupdate-agent
  

  查看服务是否正常运行：

  sudo systemctl status deviceupdate-agent
  

  若服务启动失败，实时查看系统日志定位问题：

  journalctl -u deviceupdate-agent -f
  

网络连通性排查 #

• 测试IoT Hub端点访问
  使用nc命令验证设备能否访问IoT Hub的443端口（替换{your-iothub-name}为实际IoT Hub名称）：

  nc -zv {your-iothub-name}.azure-devices.net 443
  

• 代理环境配置检查
  如果设备处于代理网络下，需在du-config.json中添加代理配置：

  "proxy": "http://<proxy-ip>:<proxy-port>"
  

  同时确认代理允许访问Azure IoT Hub相关域名。

设备与模块身份验证 #

• 确认设备注册状态
  在Azure门户的IoT Hub中，检查目标设备是否存在且状态为「已启用」。
• 验证Device Update模块存在性
  确认设备的模块列表中已包含DeviceUpdate模块，若未自动创建，可手动添加模块并使用设备连接字符串完成注册。

深度日志分析 #

• 查看Agent详细运行日志
  Agent日志默认存储在/var/log/adu目录，实时跟踪最新日志：

  tail -f /var/log/adu/agent.log
  

  重点关注含connection、error、disconnect关键词的条目，定位具体连接失败原因。

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