使用Azure Java SDK的ModuleClient连接IoTEdge时缺失IOTEDGE_WORKLOADURI环境变量的解决方法

这个错误是因为你调用的ModuleClient.createFromEnvironment()方法依赖IoT Edge运行时提供的环境变量，而当前运行环境中缺少核心变量IoTEdge_WorkLoadURI。以下分两种场景给出解决方法：

一、在IoT Edge设备的容器中运行模块（生产部署场景） #

这是IoT Edge模块的标准运行方式，无需手动配置环境变量：

• 把你的Java代码打包成Docker镜像，推送到容器注册表（比如Azure容器注册表ACR）。
• 在Azure门户的IoT Edge设备配置页，添加自定义模块，填写镜像地址、注册表访问凭据。
• 完成部署后，IoT Edge运行时会自动为容器注入IoTEdge_WorkLoadURI、IOTEDGE_DEVICEID、IOTEDGE_MODULEID等所有必要环境变量，代码调用createFromEnvironment()就能正常获取连接参数。

二、本地开发调试（设备外运行代码） #

如果要在本地IDE直接运行代码调试，需要手动模拟IoT Edge运行时的环境变量：

1. 获取IoT Edge设备的工作负载URI
   在目标IoT Edge设备上执行命令：

   # 先找到edgeAgent容器ID
   iotedge list
   # 查看edgeAgent的环境变量，找到WorkloadUri值
   docker inspect <edgeAgent容器ID> | grep WorkloadUri
   

   通常这个值是unix:///var/run/iotedge/workload.sock（Linux设备）或http://localhost:15580（Windows设备）。
2. 在本地设置环境变量
   在你的开发环境（比如IDE的运行配置、系统环境变量）中添加以下变量：
   • IOTEDGE_WORKLOADURI：步骤1获取的WorkloadUri值
   • IOTEDGE_DEVICEID：你的IoT Edge设备ID
   • IOTEDGE_MODULEID：你要调试的模块名称（比如MyJavaModule）
   • IOTEDGE_IOTHUBHOSTNAME：你的IoT Hub主机名（格式如xxx.azure-devices.net）
3. 确保本地可访问IoT Edge工作负载服务
   如果是远程调试（比如本地Windows调试Linux IoT Edge设备），需要将设备的工作负载端口映射到本地，或者确保网络连通。

代码小修正 #

你提供的代码里存在HTML转义字符，比如"应该替换为普通双引号"，修正后的代码片段：

client.setMessageCallback("Input", msgCallback, client);

另外，代码最后一行打印的IothubConnectionstringVariableName是无效的环境变量名，IoT Edge模块不会自动注入这个变量，可改为打印IOTEDGE_WORKLOADURI来验证环境变量是否正确加载。

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