.NET 8.0.100中PublishAot与System.Text.Json反序列化的警告处理

核心原因 #

你遇到的两个警告本质是因为默认的JsonSerializer.Deserialize重载依赖动态代码生成和未引用代码，这和AOT编译的静态特性冲突——AOT会提前编译所有代码，不会留动态生成的余地，裁剪代码时也会移除未被显式引用的部分。

消除警告的两种方案 #

方案一：使用System.Text.Json源代码生成器（推荐） #

这是官方适配AOT的标准方案，步骤如下：

1. 定义JsonSerializerContext
   在项目中创建一个继承JsonSerializerContext的类，用JsonSerializable标记需要序列化/反序列化的目标类型（比如你的TwitchInfo）：

   using System.Text.Json.Serialization;
   
   [JsonSerializable(typeof(TwitchInfo))]
   public partial class AppJsonContext : JsonSerializerContext
   {
   }
   

2. 替换反序列化代码
   把原来触发警告的JsonSerializer.Deserialize(Stream, Type, JsonSerializerOptions)调用，替换为基于JsonTypeInfo的重载：

   // 原触发警告的代码
   // var config = JsonSerializer.Deserialize(stream, typeof(TwitchInfo), options);
   // 修改后的代码
   var config = JsonSerializer.Deserialize(stream, AppJsonContext.Default.TwitchInfo);
   

   编译时会提前生成对应类型的序列化代码，完全适配AOT规则，从根源消除警告。

方案二：临时忽略警告（不推荐） #

如果暂时不想修改代码，可在.csproj中添加配置屏蔽对应警告：

<PropertyGroup>
  <NoWarn>$(NoWarn);IL2026;IL3000</NoWarn>
</PropertyGroup>

• IL2026：对应RequiresUnreferencedCodeAttribute的警告
• IL3000：对应RequiresDynamicCodeAttribute的警告

注意：忽略警告只是隐藏提示，并未解决AOT运行时潜在的反序列化失败风险，仅适合临时测试场景。

验证 #

修改完成后重新执行dotnet publish，警告会消失，同时AOT编译后的程序可稳定运行。

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