Node.js SDK向Azure IoT Hub发送C2D直接方法超时问题排查

• 修正Payload格式
  你的代码中对payload使用了JSON.stringify，但invokeDeviceMethod要求传入的payload是原生JavaScript对象，而非JSON字符串。设备端监听直接方法时，收到的会是字符串而非预期的结构化对象，导致设备无法正确解析请求，进而没有返回响应，最终触发超时。

  修改代码中的payload部分：

  const payload = {        
      methodName: "GetAllLockerStatus_method",
      responseTimeoutInSeconds: 30,
      payload: { MessageID: 1 }, // 直接传入对象，无需JSON.stringify
  };
  

• 核对设备端方法监听名称
  确保设备端注册的直接方法名称和代码中的methodName完全一致，包括大小写、下划线等特殊字符。门户能成功调用说明设备端监听逻辑正确，重点检查代码中是否存在拼写错误。

• 规范异步调用的生命周期处理
  你的函数声明为async，但invokeDeviceMethod使用了回调模式，可能导致函数提前结束，无法正确捕获错误并返回给客户端。建议将回调转为Promise形式，确保等待方法调用完成：

  exports.sendDirectMethod = async (req, res) => {    
      const connectionString = process.env.IOTHUB_CONNECTION_STRING;    
      const deviceId = "HW2";
      const serviceClient = iothub.Client.fromConnectionString(connectionString);
      const payload = {        
          methodName: "GetAllLockerStatus_method",
          responseTimeoutInSeconds: 30,
          payload: { MessageID: 1 },
      };
  
      try {
          const result = await serviceClient.invokeDeviceMethod(deviceId, payload);
          console.log(`Response status: ${result.status}`);
          console.log(`Response payload: ${result.payload}`);
          res.status(200).json(result);
      } catch (err) {
          console.error(err.message);
          res.status(500).send(err.message);
      } finally {
          await serviceClient.close(); // 调用完成后关闭客户端连接
      }
  };
  

• 确认设备在线状态
  虽然门户能成功调用，但需验证API调用时设备确实处于在线状态。可通过Azure IoT Hub门户查看设备连接状态，排除设备临时断连或网络异常的情况。

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