.NET MAUI Windows端FilePicker.PickAsync调用COM组件返回E_FAIL求助

错误详情 #

运行安装包部署的.NET MAUI Windows应用时，调用FilePicker.PickAsync选择图片文件会抛出以下错误：

Error HRESULT E_FAIL has been returned from a call to a COM component.

错误堆栈：

at Microsoft.Maui.Storage.FilePickerImplementation.PlatformPickAsync(PickOptions options, Boolean allowMultiple)
   at Microsoft.Maui.Storage.FilePickerImplementation.PickAsync(PickOptions options)
   at MyApplication.Platforms.Windows.CustomFilePicker.ImageFilePicker(String TitleMessage)
   at MyApplication.Views.Settings_View.OnBrowserClicked(Object sender, EventArgs e)

复现步骤 #

• 仅在安装包部署后出现，Visual Studio调试时无此问题
• 点击打开文件选择器的按钮触发错误，应用直接崩溃
• 事件查看器关联异常代码为0xc000027b

代码示例 #

自定义文件选择器方法：

public async Task<string> ImageFilePicker(string TitleMessage)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = TitleMessage,
        FileTypes = FilePickerFileType.Images
    });
    var signaturePath = result?.FullPath.ToString();
    return signaturePath;
}

额外信息 #

• 应用仅面向Windows平台，以管理员身份运行
• 使用最新版.NET MAUI Community Toolkit
• 已在package.appxmanifest中添加以下权限但无效：

<Capabilities>
    <rescap:Capability Name="packageManagement" />
    <Capability Name="internetClient"/>
    <Capability Name="privateNetworkClientServer"/>
    <uap:Capability Name="removableStorage"/>
    <uap:Capability Name="picturesLibrary"/>
    <uap:Capability Name="videosLibrary"/>
</Capabilities>

• 已在Windows平台特定目录创建CustomFilePicker类及自定义方法

问题解答 #

可能原因 #

1. 管理员权限与UWP文件选择器冲突：UWP文件选择器组件属于非管理员进程，无法与管理员权限的应用正常交互，触发COM上下文不匹配错误。
2. 自定义选择器实现缺陷：若CustomFilePicker直接封装MAUI原生FilePicker，未处理Windows平台权限上下文差异，会引发该问题。
3. 包清单配置遗漏：缺少broadFileSystemAccess权限（需系统设置额外启用），或清单命名空间声明不全。

解决方法 #

方法1：移除管理员权限要求

若应用无需强制管理员权限，取消相关配置：

• 右键项目→属性→Windows设置→取消勾选“以管理员身份运行此程序”
• 或修改Package.appxmanifest，删除管理员权限声明。

方法2：使用Windows原生文件对话框替代

直接调用Windows原生FileOpenPicker规避MAUI组件的兼容性问题：

using Windows.Storage.Pickers;
using Windows.Storage;

public async Task<string> ImageFilePicker(string TitleMessage)
{
    var picker = new FileOpenPicker();
    picker.ViewMode = PickerViewMode.Thumbnail;
    picker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
    picker.FileTypeFilter.Add(".png");
    picker.FileTypeFilter.Add(".jpg");
    picker.FileTypeFilter.Add(".jpeg");
    
    // *关键：管理员权限下需使用此方法重载*
    StorageFile file = await picker.PickSingleFileAsync();
    return file?.Path;
}

注意：需确保包清单已声明picturesLibrary或broadFileSystemAccess权限。

方法3：启用broadFileSystemAccess权限

若需访问任意位置文件，在Package.appxmanifest中添加：

<Capabilities>
    <!-- 保留已有权限 -->
    <rescap:Capability Name="broadFileSystemAccess" />
</Capabilities>

之后在Windows系统设置→应用→目标应用→权限→文件系统中，手动允许应用访问所有文件。

方法4：确保在UI线程调用文件选择器

用MainThread.InvokeOnMainThreadAsync包裹调用代码，保证在UI线程执行：

public async Task<string> ImageFilePicker(string TitleMessage)
{
    return await MainThread.InvokeOnMainThreadAsync(async () =>
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            PickerTitle = TitleMessage,
            FileTypes = FilePickerFileType.Images
        });
        return result?.FullPath;
    });
}

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