Xamarin Forms中SignalR Client发布版链接模式序列化异常求助

这个问题的核心原因很明确：Android Release模式下的链接器优化把SignalR协商响应类的关键构造函数给移除了。当链接器设置为Sdk and User Assemblies时，它会自动剔除它认为“未被使用”的代码——而NegotiationResponse类的构造函数是被Newtonsoft.Json通过反射调用的，链接器检测不到这种间接引用，就把它删掉了，最终导致反序列化失败。

下面是几种可行的解决方案，按推荐程度排序：

方案1：使用链接器配置文件（推荐） #

这是最优雅的方式，既能保留链接器的优化效果，又能确保SignalR和Newtonsoft.Json的必要代码不被移除：

• 在你的Android项目中新建一个XML文件，命名为LinkerConfig.xml
• 右键这个文件，选择「属性」，把生成操作设置为LinkDescription
• 在文件中填入以下配置：

<?xml version="1.0" encoding="utf-8" ?>
<linker>
  <!-- 保留SignalR协商响应类的所有成员 -->
  <assembly fullname="Microsoft.AspNetCore.SignalR.Client">
    <type fullname="Microsoft.AspNetCore.Sockets.Client.HttpConnection+NegotiationResponse" preserve="all" />
  </assembly>
  <!-- 确保Newtonsoft.Json的核心序列化逻辑不被优化掉 -->
  <assembly fullname="Newtonsoft.Json">
    <type fullname="Newtonsoft.Json.JsonSerializer" preserve="all" />
  </assembly>
</linker>

这个配置会明确告诉链接器：不要动这两个类型的任何成员，Newtonsoft.Json就能正常反序列化协商响应了。

方案2：调整链接器选项（快速临时方案） #

如果不想写配置文件，可以暂时降低链接器的优化程度：

• 打开Android项目的属性，找到「Android选项」→「链接器」
• 把链接设置从Sdk and User Assemblies改成Sdk Assemblies Only
• 重新编译Release版本

这个方法的缺点是APK体积会有所增大，因为链接器不再优化你引用的第三方程序集，但胜在操作简单，能快速验证问题是否解决。

方案3：代码层面添加Preserve特性（仅适用于自定义类） #

如果是你自己定义的类遇到类似问题，可以给类加上[Preserve(AllMembers = true)]特性，强制链接器保留所有成员。但因为NegotiationResponse是SignalR的内部类，我们没法直接修改它的代码，所以这个方案在这里不适用，只做知识补充。

完成上述操作后，重新编译Release版本并测试，SignalR的协商流程应该就能正常执行了。

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