Azure Function IoTHubTrigger中无法获取IoT Hub消息的ContentEncoding/ContentType问题

首先明确说：这不是一个bug，而是IoT Hub和Azure Function绑定之间的预期行为。我来给你拆解原因和解决办法：

为什么会出现这个情况？ #

当你用Microsoft.Azure.Devices.Client SDK的Message类设置ContentEncoding和ContentType时，这两个属性属于客户端SDK层面的封装字段，但IoT Hub在将消息转发到Event Hub兼容的端点（也就是Azure Function的IoTHubTrigger绑定对接的端点）时，并不会把这两个属性自动映射到EventData的SystemProperties集合里。

而自定义属性能正常传输，是因为IoT Hub会原样把Message.Properties里的所有键值对转发到EventData.Properties中，这是明确支持的标准行为。

解决办法 #

最直接且可靠的方式，就是把ContentEncoding和ContentType也放到自定义属性里一起发送，这样在Azure Function里就能正常读取到了：

客户端发送代码示例

var deviceClient = DeviceClient.CreateFromConnectionString("<你的设备连接字符串>", TransportType.Mqtt);
var payload = Encoding.UTF8.GetBytes("{\"temperature\":25}");
var message = new Message(payload);

// 设置内置属性
message.ContentEncoding = "utf-8";
message.ContentType = "application/json";

// 同时添加到自定义属性
message.Properties.Add("ContentEncoding", message.ContentEncoding);
message.Properties.Add("ContentType", message.ContentType);

await deviceClient.SendEventAsync(message);

Azure Function接收代码示例

[FunctionName("ProcessIoTHubMessages")]
public static void Run(
    [IoTHubTrigger("messages/events", Connection = "IoTHubConnectionString")] EventData[] events,
    ILogger log)
{
    foreach (var eventData in events)
    {
        // 从自定义属性中读取编码和类型
        if (eventData.Properties.TryGetValue("ContentEncoding", out var encodingValue))
        {
            log.LogInformation($"消息内容编码：{encodingValue}");
        }
        if (eventData.Properties.TryGetValue("ContentType", out var typeValue))
        {
            log.LogInformation($"消息内容类型：{typeValue}");
        }

        // 处理消息体
        var messageBody = Encoding.UTF8.GetString(eventData.Body.Array, eventData.Body.Offset, eventData.Body.Count);
        log.LogInformation($"收到消息内容：{messageBody}");
    }
}

如果你不想用自定义属性，也可以选择把编码和类型信息直接嵌入到消息payload中，但这样需要你自己负责序列化和反序列化的逻辑，相对麻烦一些，不如自定义属性的方式直接。

另外补充一句：这个行为在后续的SDK版本（包括更高版本的Microsoft.Azure.Devices.Client）中也没有变化，因为Event Hub的系统属性集合是固定规范，IoT Hub并没有把这两个客户端字段纳入系统属性的转发范围。

内容的提问来源于stack exchange，提问作者Markus S.