Azure.Messaging.EventHubs.EventData的SystemProperties未完全填充问题求助

核心原因：SDK属性结构调整 #

旧版Microsoft.Azure.EventHubs SDK会将message-id、correlation-id、user-id放入SystemProperties字典中，而新版Azure.Messaging.EventHubs SDK将这些属性提升为EventData的顶级成员属性，不再存入SystemProperties。

解决方案 #

1. 直接访问EventData的顶级属性 #

替换原有的SystemProperties读取逻辑，改用新SDK提供的专属属性：

// 正确读取方式
string messageId = eventData.MessageId;
string correlationId = eventData.CorrelationId;
string userId = eventData.UserId;

2. 验证设备端属性设置 #

确认设备发送消息时已正确设置这些属性：

• 设备端使用IoT SDK发送消息时，需显式设置Message.MessageId、Message.CorrelationId、Message.UserId
• 可通过IoT Hub门户的消息路由测试或设备端日志，验证属性是否被正常发送

3. 升级至最新稳定版SDK #

确保使用的Azure.Messaging.EventHubs和Azure.Messaging.EventHubs.Processor NuGet包为最新稳定版本，旧版本可能存在属性映射的兼容性问题。

4. 检查AMQP传输配置 #

若自定义了AmqpTransportSettings，确认未禁用属性传递相关配置。默认配置下，AMQP会完整传递所有消息属性，无需额外修改。

兼容旧代码的临时方案（不推荐） #

如果需要快速适配旧代码逻辑，可手动将顶级属性注入SystemProperties字典：

eventData.SystemProperties.TryAdd("message-id", eventData.MessageId);
eventData.SystemProperties.TryAdd("correlation-id", eventData.CorrelationId);
eventData.SystemProperties.TryAdd("user-id", eventData.UserId);

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