如何调试无法启动的Windows独立部署MAUI应用

针对你遇到的独立部署MAUI应用在部分Windows系统启动无响应、事件日志报0xc000027b错误的问题，以下是几个能获取精准错误信息的方法：

1. 给MAUI应用添加本地日志输出 #

修改项目的Program.cs，配置日志将启动过程的详细信息写入本地文件：

using Microsoft.Extensions.Logging;

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        });

    // 配置日志输出到应用目录下的Logs文件夹
    builder.Logging.AddFile("Logs/app-startup-{Date}.txt");

    return builder.Build();
}

重新编译发布后启动应用，检查生成的日志文件，里面会记录启动阶段的初始化细节、异常信息。

2. 用WinDbg捕获崩溃现场 #

• 安装WinDbg Preview（微软商店可直接获取）
• 打开WinDbg，选择File > Launch executable，选中你的MyApp.exe启动
• 应用崩溃后，在命令行输入!analyze -v，工具会生成完整的崩溃分析报告，包括调用栈、具体异常点，能精准定位Microsoft.ui.xaml.dll中的故障原因。

3. 强制生成崩溃转储文件 #

• 打开注册表编辑器，导航到HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps
• 若没有LocalDumps项，右键新建项
• 在LocalDumps下新建字符串值DumpFolder，设置为你指定的存储路径（比如C:\MyAppDumps）
• 新建DWORD值DumpType，设置为2（全转储）
• 启动应用，崩溃后会在指定路径生成.dmp文件，用WinDbg打开即可分析详细崩溃原因。

4. 命令行启动时重定向输出 #

用命令行启动并将所有输出写入文件：

MyApp.exe > app-log.txt 2>&1

查看生成的app-log.txt，可能会包含启动时的依赖缺失、组件初始化失败等隐性错误提示。

5. 检查Windows App SDK版本兼容性 #

错误模块Microsoft.ui.xaml.dll属于Windows App SDK组件，独立部署的MAUI应用虽自带运行时，但部分系统可能存在版本冲突：

• 对比目标系统C:\Windows\System32\Microsoft.ui.xaml.dll的版本与你部署包中的版本
• 在项目的.csproj中固定Windows App SDK版本，避免自动升级导致的兼容问题：

<PropertyGroup>
    <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
    <WindowsAppSDKVersion>1.3.221209.1</WindowsAppSDKVersion>
</PropertyGroup>

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