树莓派3A+上Azure IoT Edge模块部署失败求助

1. 确认模块镜像架构匹配 #

• 检查自定义temperatureTest模块的镜像架构：执行docker inspect <镜像名>:<标签>，查看Architecture字段是否为arm，而非amd64。
• 本地构建镜像时，确保Dockerfile基于arm32v7基础镜像（比如mcr.microsoft.com/azureiotedge-base:1.4.20-arm32v7），且构建命令添加--platform linux/arm/v7参数。

2. 检查IoT Edge运行时网络配置 #

• 执行iotedge check，重点修复container runtime和network configuration部分的所有告警项。
• 确认部署清单中模块的NetworkingConfig配置为{"EndpointsConfig": {"azure-iot-edge": {}}}，确保使用IoT Edge内部专用网络。

3. 验证模块连接字符串与权限 #

• 登录IoT Hub查看设备的模块孪生，确认connectionString字段与部署清单完全一致，无拼写错误或过期情况。
• 检查IoT Hub的设备共享访问策略，确保该设备拥有RegistryRead和DeviceConnect权限。

4. 排查树莓派本地网络限制 #

• 执行sudo iptables -L，确认本地防火墙未阻止IoT Edge相关端口（默认443、8883）的出站连接。
• 测试IoT Hub端点连通性：执行nc -zv <你的IoT Hub名称>.azure-devices.net 443，确保能正常建立连接。

5. 对齐IoT Edge运行时版本 #

• 执行iotedge version，确认树莓派上的IoT Edge版本与Ubuntu虚拟机上的版本一致，若差异较大，升级至相同稳定版本（如1.4.x系列）。

6. 深挖边缘中心日志细节 #

• 执行iotedge logs edgeHub，搜索与temperatureTest模块相关的日志，排查是否存在证书错误、身份验证失败等深层问题，这些可能是连接拒绝的根源。

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