C# WinUI 3应用微软商店后台崩溃显示“Unknown”如何调试？

一、现有崩溃记录"Unknown"的排查方法 #

1. 确认符号文件上传状态 #

微软商店依赖PDB符号文件解析崩溃堆栈，若未正确上传，崩溃记录会显示为"Unknown"：

• 打包应用时，确保勾选"生成符号文件(.pdb)"选项；
• 登录合作伙伴中心，进入应用的"包"->"符号文件"页面，上传对应版本的PDB文件（需与上架包版本完全匹配）。

2. 实现应用内全局异常捕获 #

在App.xaml.cs中添加未处理异常捕获逻辑，将异常日志写入本地存储，方便后续提取分析：

public App()
{
    InitializeComponent();
    
    // 捕获AppDomain级别的未处理异常
    AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
    // 捕获WinUI应用级别的未处理异常
    Application.Current.UnhandledException += Current_UnhandledException;
}

private void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
    if (e.ExceptionObject is Exception ex)
    {
        SaveCrashLog(ex, "AppDomain Unhandled Exception");
    }
}

private void Current_UnhandledException(object sender, Microsoft.UI.Xaml.UnhandledExceptionEventArgs e)
{
    SaveCrashLog(e.Exception, "WinUI App Unhandled Exception");
    e.Handled = true; // 阻止系统默认崩溃提示，避免影响用户体验
}

private async void SaveCrashLog(Exception ex, string errorType)
{
    try
    {
        var logContent = $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] {errorType}:\n{ex.ToString()}\n\n";
        var localFolder = Windows.Storage.ApplicationData.Current.LocalFolder;
        var logFile = await localFolder.CreateFileAsync("crash_logs.txt", Windows.Storage.CreationCollisionOption.OpenIfExists);
        await Windows.Storage.FileIO.AppendTextAsync(logFile, logContent);
    }
    catch { } // 避免日志写入失败引发二次异常
}

可通过微软商店反馈中心或自定义入口，引导用户提交本地日志。

3. 利用Windows事件查看器提取崩溃信息 #

在用户设备的事件查看器中，导航至Windows日志 > 应用程序，筛选应用名称相关的"错误"类型事件，其中通常包含崩溃的异常代码、调用堆栈（若设备存在匹配PDB）等关键信息。

二、适配WinUI 3的第三方崩溃检测SDK #

1. Sentry #

• 支持WinUI 3/.NET 6+应用，自动捕获未处理异常、线程异常，提供完整堆栈跟踪与设备上下文信息；
• 支持上传PDB符号文件解析混淆代码，可添加自定义标签、用户信息辅助排查；
• 集成方式：通过NuGet安装Sentry包，在App.xaml.cs初始化：

SentrySdk.Init(options =>
{
    options.Dsn = "你的Sentry项目Dsn";
    options.AutoSessionTracking = true;
    options.Release = "你的应用版本号";
});

2. App Center #

• 微软官方出品，与微软生态兼容，支持崩溃收集、用户分析、测试分发等功能；
• 对WinUI 3支持完善，可自动关联上传的符号文件；
• 集成方式：安装Microsoft.AppCenter.Crashes和Microsoft.AppCenter.Analytics NuGet包，初始化代码：

AppCenter.Start("你的App Center应用密钥", typeof(Crashes), typeof(Analytics));

3. Rollbar #

• 支持.NET全平台应用，包括WinUI 3，提供实时崩溃警报、错误分组、上下文日志等功能；
• 支持自定义数据附加，可关联用户行为与崩溃事件；
• 集成方式：安装Rollbar.NetCore包，初始化：

RollbarLocator.RollbarInstance.Configure(new RollbarConfig("你的Rollbar项目令牌")
{
    Environment = "Production",
    Enabled = true
});

注意事项 #

• 无论使用哪种方案，必须确保上传与发布版本完全匹配的PDB符号文件，否则无法解析准确代码位置；
• 第三方SDK的网络请求需符合微软商店权限要求，通常只需添加"Internet (Client)"权限即可。

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