如何在Windows端构建启动MAUI应用及运行无响应问题排查

问题结论 #

你使用的.NET 6预览版搭配MAUI预览环境，本身是支持直接在Windows桌面端运行应用的，启动失败属于预览版常见的运行时依赖缺失问题，和你遇到的0x80040154 (REGDB_E_CLASSNOTREG)错误对应。

修复步骤 #

• 先安装匹配版本的Windows App Runtime运行时：你所用的.NET 6.0.100-preview.7版本对应的WinUI 3依赖为Windows App SDK 1.0-preview3，打开VS Installer，在「单个组件」标签页搜索「Windows App SDK」，勾选对应预览版本的运行时组件完成安装即可。
• 不要直接双击bin/obj目录下生成的裸exe启动：该预览版的MAUI Windows端默认是打包型应用，必须走VS的部署流程才能正常注册运行。正确操作是将VS顶部的启动目标切换为「Windows (Machine)」，直接按F5启动调试，VS会自动完成依赖校验、应用注册和启动操作。
• 如果需要单独发布可运行的程序包，请选择「打包应用」发布模式，生成.msix/.appx安装包，安装后从开始菜单启动即可，不要直接运行发布目录下的exe文件，打包模式会自动将所有依赖包含到安装包中，避免运行时缺失问题。
• 临时测试可以调整项目属性：在Windows平台配置页中将「打包模式」修改为未打包，此时生成的exe可以直接双击运行，但需要确保本机已经提前安装好对应版本的Windows App Runtime运行时，否则仍会报类未注册错误。

报错原因说明 #

你在事件查看器中看到的COM类未注册错误，本质是系统中没有安装WinUI 3对应的运行时组件，无法识别Microsoft.UI.Xaml.Application相关的COM接口，和编译环节无关，所以构建、发布流程都不会报错，仅在运行时触发进程终止。

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