.NET 9 WPF程序Obfuscar混淆公共API后无法启动的问题求助

问题原因 #

WPF的XAML解析依赖反射机制匹配公共类、属性、事件绑定的名称。当Obfuscar的KeepPublicApi设为false时，所有未被排除的公共类型和成员会被重命名，导致XAML找不到对应的目标，从而抛出System.Windows.Markup.XamlParseException，内部的System.NotImplementedException通常是因为找不到绑定的事件处理方法或属性导致的。

解决方案 #

1. 用特性标记需要保留原名的类型和成员 #

在被XAML直接引用的公共类（如Window、UserControl）、事件处理方法、依赖属性、绑定属性上添加[Obfuscation(Feature = "renaming", Exclude = true)]特性，告诉Obfuscar跳过这些元素的重命名：

using System.Reflection;
using System.Windows;

[Obfuscation(Feature = "renaming", Exclude = true)]
public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
    }

    [Obfuscation(Feature = "renaming", Exclude = true)]
    private void Button_Click(object sender, RoutedEventArgs e)
    {
        // 修改文本框内容的逻辑
    }

    // 若有依赖属性，同样需要标记
    [Obfuscation(Feature = "renaming", Exclude = true)]
    public static readonly DependencyProperty DisplayTextProperty =
        DependencyProperty.Register(nameof(DisplayText), typeof(string), typeof(MainWindow));

    [Obfuscation(Feature = "renaming", Exclude = true)]
    public string DisplayText
    {
        get => (string)GetValue(DisplayTextProperty);
        set => SetValue(DisplayTextProperty, value);
    }
}

2. 在Obfuscar配置文件中添加排除规则 #

如果不想修改代码，可以直接在Obfuscar的配置文件（如obfuscar.xml）中指定需要保留原名的类型和成员：

<Obfuscator>
    <Var name="KeepPublicApi" value="false" />
    <!-- 针对目标程序集配置排除规则 -->
    <Module file="YourWpfApplication.exe">
        <!-- 排除整个MainWindow类的重命名 -->
        <Type name="YourAppNamespace.MainWindow" exclude="renaming" />
        <!-- 若需单独排除某个方法，可单独配置 -->
        <Method name="YourAppNamespace.MainWindow.Button_Click" exclude="renaming" />
    </Module>
</Obfuscator>

3. 全面验证XAML绑定的目标 #

逐一检查XAML中的所有绑定项：

• x:Class指定的类必须保留原名
• 事件绑定（如Click="Button_Click"）对应的方法必须保留原名
• 数据绑定（如Binding Path=DisplayText）对应的属性必须保留原名
• 命令绑定对应的命令属性或方法必须保留原名

4. 排查其他反射依赖的公共成员 #

如果程序中存在其他通过反射调用的公共成员（如自定义服务、插件接口），也需要将这些成员排除在重命名之外，否则会引发类似的运行时异常。

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