通过命令行启动MAUI Windows应用时出现COM线程错误求助

问题场景 #

尝试通过命令行启动MAUI Windows应用时，启动界面冻结并抛出错误，此前在Xamarin Forms Windows应用中执行相同操作可正常运行。

错误信息 #

System.Runtime.InteropServices.COMException: 'The application called an interface that was marshalled for a different thread.

The Application Object must initially be accessed from the multi-thread apartment.'

复现步骤 #

1. 新建MAUI多平台模板应用
2. 在WinUI项目的Package.appxmanifest中添加以下配置：

xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"
IgnorableNamespaces="uap rescap uap5">

<Applications>
    <Application Id="App" Executable="$targetnametoken$.exe" EntryPoint="$targetentrypoint$">
        <uap:VisualElements
          DisplayName="MauiApp3"
          Description="MauiApp3"
          BackgroundColor="transparent"
          Square150x150Logo="Assets\Square150x150Logo.png"
          Square44x44Logo="Assets\Square44x44Logo.png">
            <uap:DefaultTile Wide310x150Logo="Assets\Wide310x150Logo.png" />
            <uap:SplashScreen Image="Assets\SplashScreen.png" />
        </uap:VisualElements>
        <Extensions>
            <uap5:Extension
            Executable="MauiApp3.WinUI.exe"
            EntryPoint="MauiApp3.WinUI.App"
            Category="windows.appExecutionAlias">
                <uap5:AppExecutionAlias>
                    <uap5:ExecutionAlias Alias="maui33.exe" />
                </uap5:AppExecutionAlias>
            </uap5:Extension>
        </Extensions>
    </Application>
</Applications>

<Capabilities>
    <rescap:Capability Name="runFullTrust" />
</Capabilities>

解决方法 #

这个错误的核心是MAUI应用默认线程公寓模型与命令行启动的线程环境不匹配，MAUI对UI线程的公寓模型要求比Xamarin Forms更严格。

1. 修改WinUI项目的Program.cs #

默认MAUI Windows启动代码未显式指定线程公寓类型，需手动设置为STA（单线程公寓）（大部分WinUI控件依赖STA环境）。修改代码如下：

using Microsoft.UI.Xaml;

namespace MauiApp3.WinUI;

public static class Program
{
    [STAThread]
    static void Main(string[] args)
    {
        WinRT.ComWrappersSupport.InitializeComWrappers();
        Application.Start((p) => new App());
    }
}

2. 调整应用执行别名配置 #

确保Package.appxmanifest中的EntryPoint指向自定义的程序入口类，示例如下：

<uap5:Extension
    Executable="MauiApp3.WinUI.exe"
    EntryPoint="MauiApp3.WinUI.Program"
    Category="windows.appExecutionAlias">
    <uap5:AppExecutionAlias>
        <uap5:ExecutionAlias Alias="maui33.exe" />
    </uap5:AppExecutionAlias>
</uap5:Extension>

3. 规范UI初始化逻辑 #

避免在App.xaml.cs的构造函数中执行跨线程或耗时操作，将初始化逻辑移至OnLaunched方法中，该方法会自动在UI线程执行。

原理说明 #

Windows COM对象需要在特定线程公寓（STA/MTA）中访问。IDE启动MAUI应用时会自动设置正确的线程公寓，但通过命令行别名启动时，该初始化步骤可能被跳过，导致应用在错误线程环境中访问UI对象，最终抛出异常。显式标记[STAThread]可强制主线程以单线程公寓模式启动，匹配WinUI控件的运行要求。

内容的提问来源于stack exchange，提问作者D.madushanka