使用Azure IoT Hub Java SDK创建设备遇DeviceAuthenticationNoneInvalid错误

问题根源 #

你使用的1.6.23版本SDK中，Device.createFromId()方法传入null作为对称密钥参数时，并不会触发IoT Hub自动生成密钥，反而会将设备的认证类型设置为无效的None，这直接导致IoT Hub返回DeviceAuthenticationNoneInvalid错误。该版本SDK的实现逻辑和文档描述存在偏差。

正确解决方案 #

方法1：使用Device.createWithId()方法（推荐） #

这个方法是专门设计用来让IoT Hub自动生成设备对称密钥的，无需手动传入密钥参数：

// 替换原创建设备的代码
Device device = Device.createWithId(DEVICE_ID);

修改后的完整代码：

package ch.rfag.Azure;

import com.microsoft.azure.sdk.iot.service.RegistryManager;
import com.microsoft.azure.sdk.iot.service.Device;
import com.microsoft.azure.sdk.iot.service.exceptions.IotHubException;

import java.io.IOException;
import java.security.NoSuchAlgorithmException;

public class CreateDevice {
    private static final String IOT_HUB_CONNECTION_STRING =
            "HostName=your-iothub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=yourKey";
    private static final String DEVICE_ID = "JAVA-CREATED-DEVICE-1";

    public static void main(String[] args) throws NoSuchAlgorithmException, IOException {
        RegistryManager registryManager = RegistryManager.createFromConnectionString(IOT_HUB_CONNECTION_STRING);
        // 使用createWithId触发自动生成密钥
        Device device = Device.createWithId(DEVICE_ID);

        try {
            device = registryManager.addDevice(device);
        } catch (IotHubException e) {
            System.err.println("Error creating device (it might already exist): " + e.getMessage());
            device = registryManager.getDevice(DEVICE_ID);
        }

        System.out.println("Device created successfully!");
        System.out.println("Device id: " + device.getDeviceId());
        System.out.println("Primary Key: " + device.getPrimaryKey());
        System.out.println("Secondary Key: " + device.getSecondaryKey());
    }
}

方法2：手动生成对称密钥后传入 #

如果需要自行生成密钥，可以使用Device.generateKey()方法生成符合要求的密钥，再传入createFromId：

String primaryKey = Device.generateKey();
String secondaryKey = Device.generateKey();
Device device = Device.createFromId(DEVICE_ID, primaryKey, secondaryKey);

关于异步方法无响应的问题 #

你尝试的异步方法无响应，大概率是因为主线程在异步任务执行完成前就退出了。对于该场景，使用同步的addDevice()方法更直接可靠，无需额外处理线程阻塞逻辑。如果一定要用异步，需要调用get()方法等待任务完成，示例：

registryManager.addDeviceAsync(device).get();

不过这种写法本质上和同步方法效果一致，不如直接用同步方法简洁。

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