Azure IoT设备端点指向Blob存储：非ASCII字符及扩展名错误问题

看起来你碰到了IoT Hub设备数据存储到Blob时的两个典型问题：非ASCII乱码显示，以及文件扩展名不符合预期。结合你给出的Blob数据示例（里面有Avro格式的元数据标识），我来逐一帮你解决：

1. 非ASCII字符异常：其实是Avro二进制格式的正常表现 #

你看到的Ð这类奇怪字符，不是乱码，而是IoT Hub默认用Avro二进制格式存储消息时的文件头元数据（包含codec、schema信息）。当你用普通文本编辑器打开二进制Avro文件时，就会把二进制字节解析成ASCII字符，导致显示异常。

解决办法分两种场景： #

• 场景1：需要保留Avro格式（适合批量数据处理）
  别用文本编辑器直接打开，改用支持Avro格式的工具来解析：

  • 用Azure Storage Explorer：打开Blob后，右键选择「Open with Avro Viewer」，就能正常查看消息的EnqueuedTime、Properties、Body等内容。
  • 用代码解析（比如Python）：使用fastavro库读取并解析Avro文件，示例代码如下：

    from fastavro import reader
    from azure.storage.blob import BlobClient
    
    # 替换成你的Blob连接字符串和Blob路径
    blob_client = BlobClient.from_connection_string("your_connection_string", container_name="your_container", blob_name="your_blob_path.avro")
    with blob_client.open_read() as avro_file:
        avro_reader = reader(avro_file)
        for record in avro_reader:
            print("EnqueuedTime:", record["EnqueuedTimeUtc"])
            print("Body:", record["Body"])
            # 按需处理其他字段
    

• 场景2：希望直接存储为可读的JSON文本
  如果不需要Avro的二进制优化，可以切换到JSON格式存储（需要你的IoT Hub是标准层，基础层不支持自定义格式）：

  1. 进入IoT Hub的「路由」页面，新建或编辑指向Blob存储的路由规则
  2. 在「端点」配置中，选择你的Blob存储端点
  3. 找到「格式」下拉框，选择「JSON」而非默认的「Avro」
  4. 保存后，新存储的文件就是纯JSON格式，用文本编辑器打开不会有非ASCII异常字符。

2. 文件扩展名不正确：调整存储格式或自定义文件名 #

默认情况下，IoT Hub会根据存储格式自动设置文件扩展名：Avro格式对应.avro，JSON格式对应.json。如果你的扩展名不符合预期，按以下方式调整：

解决步骤： #

• 如果你需要特定扩展名（比如.json）：
  1. 确保路由规则中选择的存储格式是JSON（Avro格式强制用.avro扩展名，无法修改）
  2. 在Blob端点的配置中，找到「文件名称格式」，自定义路径和文件名，比如设置为：

     devices/{deviceId}/{YYYY}/{MM}/{DD}/{HH}/{mm}/message.json
     

     这里的{deviceId}、{YYYY}等是占位符，会自动替换为实际的设备ID和时间，最后固定用.json作为扩展名。
• 如果你坚持用Avro格式但想改扩展名：
  这是不推荐的，因为Avro工具依赖.avro扩展名识别格式。如果必须修改，可以通过Azure Function或Logic Apps设置触发器，当Blob上传后自动重命名扩展名，但会增加额外的复杂度。

验证方案 #

调整设置后，发送一条测试消息到IoT Hub，等待几分钟（IoT Hub会批量写入Blob，不是实时），然后查看Blob存储：

• 若选JSON格式，文件扩展名应为.json，打开后是清晰的JSON结构，无异常字符
• 若选Avro格式，用Avro Viewer打开能正常解析所有字段

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