.NET项目混淆后启动报空引用异常 配置Obfuscation无效如何解决

• 首先拿到完整错误堆栈：给程序注册全局未处理异常回调，把报错的完整调用栈、出错位置的类型、成员信息输出到日志。混淆后的堆栈如果是混淆后的随机名称，用混淆工具生成的mapping映射文件反查原始代码位置，先定位到具体是哪段代码抛的空引用，不要靠猜改配置。
• 先清理你现在加的所有零散Obfuscation特性：现有配置逻辑完全冲突，既有全局关闭优化的规则，又有开启属性重命名、开启成员重命名的规则，还有无目标的排除标记，不同混淆工具解析这些冲突规则的优先级不一样，根本不会按你预期生效。尤其是你写的[Obfuscation(Exclude = true)]没有指定作用目标，部分混淆工具会默认将其应用到特性所在的程序集模块本身，根本不会作用到你需要排除混淆的业务成员上，属于完全无效的配置。
• 定位到出错代码后，重点核对几类高风险逻辑：
  • 所有靠反射调用的成员：包括XAML/Blazor的组件绑定、JSON/XML序列化的模型类、依赖注入按名称解析的服务、通过反射读取自定义特性的逻辑、动态构造表达式树访问的属性，这些逻辑依赖原始成员名，一旦被重命名或者裁剪，就会因为找不到目标成员返回null，触发空引用。
  • 实现框架约定接口的成员：比如实现INotifyPropertyChanged的属性、Web API的控制器方法、中间件约定的Invoke方法，这类成员如果被错误重命名，框架找不到对应实现时就会返回null。
  • 被优化裁剪的无静态引用成员：如果成员只通过反射调用，没有被静态代码直接引用，混淆的裁剪功能会直接把这部分代码删掉，调用时自然会出现空引用。

• 先做控制变量定位根因：把混淆工具的重命名、字符串加密、资源处理、代码裁剪、流程混淆所有功能全部关闭，跑一次混淆后的程序，如果能正常启动，就逐个开启单项混淆功能，每开一项测一次启动，定位到底是哪个功能触发的报错。
• 针对定位到的问题模块加精确排除规则，不要上来就给整个程序集加全局排除：
  比如定位到是序列化模型类的成员被重命名导致的报错，就给对应模型类或者整个模型命名空间加精确的排除规则：

  // 对整个类的所有成员关闭重命名
  [Obfuscation(Feature = "renaming", Exclude = true, ApplyToMembers = true)]
  public class UserSerializeModel
  {
      public string UserName { get; set; }
  }
  

• 优先用混淆工具自带的框架兼容预设：现在主流的.NET混淆工具都内置了WPF、ASP.NET Core、WinForm、MAUI等常见框架的兼容规则，直接开启对应预设就能自动跳过所有框架依赖反射的成员，比自己手写特性准确率高很多。
• 写Obfuscation特性时必须显式写全参数：不要写不带Exclude、ApplyToMembers参数的特性，不同混淆工具对缺省参数的解析逻辑不一致，很容易出现规则不生效的问题。

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