.NET4.5.2 WPF移植MqttNet示例出现编译错误问题排查

核心原因是MQTTnet版本不兼容。
你跑通的.NET 5示例用的是MQTTnet 4.x版本，该版本最低支持.NET Framework 4.6.1，不支持4.5.2。当你给.NET Framework 4.5.2项目通过NuGet安装依赖时，NuGet会自动拉取兼容4.5.2的最高MQTTnet版本，也就是3.x最终版3.1.2。MQTTnet 3.x和4.x存在大量破坏性API变更，直接复制4.x的代码到3.x环境必然触发全量编译错误。
对应报错的直接原因：

• 3.x版本的客户端事件采用C#原生+=语法绑定，不存在ConnectedHandler、DisconnectedHandler这类属性式绑定入口，相关委托类型也不存在
• 3.x版本的IManagedMqttClient没有暴露PublishAsync方法，消息发布接口和4.x完全不同
• 3.x版本创建IMqttServer实例时必须传入构建好的配置对象，不支持4.x的无参创建后再加载配置的逻辑

二选一即可：

方案1：升级目标框架（推荐） #

• 将WPF项目的目标框架从.NET Framework 4.5.2升级到*.NET Framework 4.6.1或更高版本*，即可兼容MQTTnet 4.x版本，无需修改示例代码
• 操作路径：右键项目→【属性】→【应用程序】→【目标框架】，选择4.6.1及以上版本保存
• 重新通过NuGet安装MQTTnet、MQTTnet.Extensions.ManagedClient包，版本和原.NET 5示例保持一致，粘贴原代码即可正常编译运行

方案2：保持4.5.2框架，适配3.x版本API #

如果无法升级目标框架，就将MQTTnet相关包统一降级到3.1.2版本，按照3.x的API规则改写代码：
服务端代码改写参考：

var options = new MqttServerOptionsBuilder()
       .WithDefaultEndpoint()
       .WithDefaultEndpointPort(707)
       .WithConnectionValidator(OnNewConnection)
       .WithApplicationMessageInterceptor(OnNewMessage)
       .Build();
// 3.x必须传入配置对象创建服务端实例
IMqttServer mqttServer = new MqttFactory().CreateMqttServer(options);
// 显式调用启动方法
await mqttServer.StartAsync();

客户端代码改写参考：

var managedClient = new MqttFactory().CreateManagedMqttClient();
// 3.x采用原生事件语法绑定回调
managedClient.Connected += OnConnected;
managedClient.Disconnected += OnDisconnected;
managedClient.ConnectingFailed += OnConnectingFailed;
managedClient.ApplicationMessageReceived += OnMessageReceived;

// 回调方法签名要匹配3.x的事件参数定义，示例：
private void OnConnected(object sender, MqttClientConnectedEventArgs e)
{
    // 连接成功逻辑
}

// 发布消息调用示例
await managedClient.PublishAsync(new MqttApplicationMessageBuilder()
    .WithTopic("demo/test")
    .WithPayload(System.Text.Encoding.UTF8.GetBytes("test message"))
    .WithExactlyOnceQoS()
    .Build());

注意：3.x版本的托管客户端重连逻辑和4.x存在差异，仅做Demo演示不受影响，生产环境使用需要额外验证重连、消息补发可靠性。

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