必须用 dotnet publish 而非 dotnet build 启用 AOT，需指定 -r RID 和 --self-contained true，并设置 /p:PublishAot=true；项目必须使用 Microsoft.NET.Sdk，禁用隐式框架引用，所有依赖（如 JSON、HTTP、数据库驱动）须 ≥8.0 且适配 AOT。
不能直接用 dotnet build 生成 AOT 二进制——Native AOT 是发布阶段行为，必须走 dotnet publish 并显式指定运行时标识符（RID），否则编译会静默失败或报错 “The RuntimeIdentifier must be set for native AOT publish.”
必须用 Microsoft.NET.Sdk 基础 SDK，禁用所有隐式框架引用
AOT 不支持 Microsoft.NET.Sdk.Web、Microsoft.NET.Sdk.Worker 等带宿主逻辑的 SDK。哪怕项目是控制台，只要 .csproj 开头不是 <project sdk="Microsoft.NET.Sdk"></project>，--aot 或 PublishAot 就会被忽略。
- 删掉所有
<frameworkreference></frameworkreference>，比如Microsoft.AspNetCore.App；改用 NuGet 包（如Microsoft.AspNetCore.App.Ref）并确认其版本 ≥8.0 - 若用到日志、配置、HTTP 客户端等，统一换为
Microsoft.Extensions.*8.x+ 版本（如Microsoft.Extensions.Http8.0.0） - 数据库驱动如
Npgsql必须 ≥8.0，Microsoft.Data.Sqlite同理，否则连接字符串解析会因反射裁剪而崩溃
dotnet publish 命令必须带 -r 和 --self-contained
AOT 编译本质是跨平台原生代码生成，不指定 RID 就没有目标架构，构建直接中断。也不能用 any 或省略 —— win-x64、linux-x64、osx-arm64 必须写全。
- 正确命令示例：
dotnet publish -c Release -r linux-x64 --self-contained true /p:PublishAot=true /p:PublishTrimmed=true - Windows 上若报 “LLVM not found”，需手动安装 LLVM，并确保
clang++在 PATH 中；Linux/macOS 同理 - 调试需要符号文件？加
--strip-symbols false，否则默认 strip 掉 pdb，无法 attach 调试
JSON 序列化和 HttpClient 必须提前“声明存在”
AOT 静态分析无法推导运行时才决定的类型名或方法签名，System.Text.Json 默认反射序列化路径会被整段裁剪，HttpClient 的构造器也可能被移除，导致运行时报 MissingMethodException。
- 禁用
System.Net.Http.Json扩展（含反射），改用原始HttpClient+StringContent发送 JSON 字符串 - 若需强类型序列化，必须用
System.Text.Json.SourceGeneration，定义[JsonSerializable]上下文类，并在 DI 或选项中显式注册TypeInfoResolver - 在
rd.xml或项目文件中保留关键类型：<type name="System.Net.Http.HttpClient" dynamic="Required All"></type>，否则 DNS/SSL 相关类型可能被裁剪
真正难的不是写对第一行命令，而是所有第三方依赖都得过一遍 AOT 兼容性筛子——Newtonsoft.Json 即使升级到 13.0.3，某些动态场景仍会崩；DI 容器里注册的服务如果用了表达式树或 Activator.CreateInstance，也会在运行时突然消失。这些不会在编译时报错，只会在目标机器上静默失败。
