.NET MAUI中FilePicker偶现返回Null及文件打开失败问题求助

问题1：FilePicker返回Null触发空引用错误 #

分析 #

空引用错误可能来自这些场景：

• FilePicker.Default在部分平台/环境下未正确初始化
• 异步操作过程中出现未预期异常，或fileList控件未正确关联XAML元素
• 取消文件选择时，未覆盖所有异常分支导致错误抛出

修复方案 #

1. 增加FilePicker.Default的非空判断，做防御性编程
2. 使用带取消令牌的PickAsync重载，避免异步操作异常挂起
3. 移除重复设置ItemsSource的代码，依赖ObservableCollection的自动UI通知更新（需确保XAML中已绑定ItemsSource到SearchResults）
4. 细化异常捕获，区分取消操作和其他错误

问题2：Launcher打开文件触发NSCocoaErrorDomain Code=256错误 #

分析 #

iOS的隐私沙盒机制限制：应用无法直接访问沙盒外的文件，FilePicker返回的原路径仅拥有临时授权，直接打开会因权限不足失败，错误码256和底层paramErr均由此导致。

修复方案 #

1. 将选中的文件复制到应用沙盒目录（如FileSystem.CacheDirectory或FileSystem.AppDataDirectory）
2. 使用file://协议构造Uri，确保跨平台路径格式正确
3. 增加文件复制过程的异常处理

修正后的完整代码 #

private string selectedFilePath;
public ObservableCollection<string> SearchResults { get; } = new ObservableCollection<string>();

public MainPage()
{
    InitializeComponent();
    BindingContext = this;
    // 建议在XAML中直接绑定：<ListView x:Name="fileList" ItemsSource="{Binding SearchResults}" ItemTapped="OnFileTapped" />
}

private async void OnSelectFileClicked(object sender, EventArgs e)
{
    SearchResults.Clear();
    try
    {
        if (FilePicker.Default == null)
        {
            Console.WriteLine("FilePicker is not available on this platform.");
            return;
        }

        var cancellationTokenSource = new CancellationTokenSource();
        var fileResult = await FilePicker.Default.PickAsync(new PickOptions
        {
            PickerTitle = "Select a file"
        }, cancellationTokenSource.Token);

        if (fileResult != null)
        {
            // 复制文件到应用沙盒，解决iOS权限问题
            var localFilePath = Path.Combine(FileSystem.CacheDirectory, fileResult.FileName);
            using (var sourceStream = await fileResult.OpenReadAsync())
            using (var targetStream = File.Create(localFilePath))
            {
                await sourceStream.CopyToAsync(targetStream);
            }

            selectedFilePath = localFilePath;
            SearchResults.Add(localFilePath);
        }
    }
    catch (OperationCanceledException)
    {
        Console.WriteLine("File selection was canceled.");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error picking file: {ex.Message}");
    }
}

private async void OnFileTapped(object sender, ItemTappedEventArgs e)
{
    if (e.Item is not string filePath || string.IsNullOrEmpty(filePath))
    {
        Console.WriteLine("Invalid file path.");
        return;
    }

    try
    {
        var fileUri = new Uri($"file://{filePath}");
        await Launcher.OpenAsync(fileUri, new LauncherOptions
        {
            Title = $"Open {Path.GetFileName(filePath)}"
        });
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error opening file: {ex.Message}");
    }
}

额外注意事项 #

• XAML配置：确保ListView的ItemsSource已绑定到SearchResults，无需代码重复设置
• iOS权限：在Info.plist中添加必要的文件访问描述（如NSDocumentsFolderUsageDescription），根据业务需求调整
• 临时文件清理：定期清理CacheDirectory中的复制文件，避免占用过多存储空间

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