.NET MAUI桌面应用跨会话保留文件/文件夹访问权限方案咨询

针对.NET MAUI桌面应用跨会话丢失文件/文件夹权限的问题，需结合各平台的权限机制做针对性处理，以下是分平台的具体实现方案：

Windows平台：使用FutureAccessList持久化权限 #

Windows提供了StorageApplicationPermissions.FutureAccessList来保存用户授权的文件/文件夹访问令牌，重启应用后可通过令牌直接恢复权限：

• 用户选择文件夹/文件后，将对应的StorageFolder/StorageFile添加到FutureAccessList，获取唯一令牌并保存到本地存储（如Preferences）
• 应用启动时读取令牌，调用API恢复访问权限
• 代码示例：

// 保存权限令牌
var folderPicker = new FolderPicker();
folderPicker.FileTypeFilter.Add("*");
var selectedFolder = await folderPicker.PickFolderAsync();
if (selectedFolder != null)
{
    string token = StorageApplicationPermissions.FutureAccessList.Add(selectedFolder);
    Preferences.Default.Set("LastFolderToken", token);
}

// 启动时恢复权限
string savedToken = Preferences.Default.Get("LastFolderToken", string.Empty);
if (!string.IsNullOrEmpty(savedToken))
{
    try
    {
        var folder = await StorageApplicationPermissions.FutureAccessList.GetFolderAsync(savedToken);
        // 成功恢复权限，可直接访问该文件夹
    }
    catch (Exception)
    {
        // 令牌失效，触发重新选择流程
    }
}

• 注意：FutureAccessList默认最多保存1000个令牌，可定期清理无效条目；令牌会随应用卸载失效。

macOS平台：使用Scoped Bookmarks持久化权限 #

macOS沙箱应用需通过安全范围书签（Security-Scoped Bookmarks）持久化访问权限：

• 用户选择文件夹后，创建书签并将书签数据转为Base64字符串保存到本地
• 启动时解析书签数据，重新获取访问权限
• 代码示例：

// 保存书签
var folderPicker = new FolderPicker();
var selectedFolder = await folderPicker.PickFolderAsync();
if (selectedFolder != null)
{
    var nsUrl = new NSUrl(selectedFolder.FullPath);
    NSError error;
    var bookmarkData = nsUrl.CreateBookmarkData(NSUrlBookmarkCreationOptions.WithSecurityScope, null, null, out error);
    if (error == null)
    {
        string bookmarkBase64 = Convert.ToBase64String(bookmarkData);
        Preferences.Default.Set("LastFolderBookmark", bookmarkBase64);
    }
}

// 启动时恢复权限
string savedBookmark = Preferences.Default.Get("LastFolderBookmark", string.Empty);
if (!string.IsNullOrEmpty(savedBookmark))
{
    try
    {
        byte[] bookmarkData = Convert.FromBase64String(savedBookmark);
        NSUrl bookmarkUrl;
        bool isStale;
        NSError error;
        bookmarkUrl = NSUrl.FromBookmarkData(bookmarkData, NSUrlBookmarkResolutionOptions.WithSecurityScope, null, out isStale, out error);
        if (error == null)
        {
            bookmarkUrl.StartAccessingSecurityScopedResource();
            // 访问完成后需调用bookmarkUrl.StopAccessingSecurityScopedResource()释放资源
        }
        else
        {
            // 书签失效，触发重新选择
        }
    }
    catch (Exception)
    {
        // 处理异常
    }
}

• 注意：需在Info.plist中添加com.apple.security.files.user-selected.read-write权限；访问完成后必须释放资源。

Linux平台：路径保存与权限回退 #

Linux下权限依赖文件系统权限和应用沙箱配置，可通过以下方式处理：

• 保存用户选择的文件夹/文件路径到本地存储
• 启动时直接尝试访问路径，若抛出UnauthorizedAccessException或路径不存在，则提示用户重新选择
• 若使用Flatpak打包，可引导用户通过命令flatpak override --filesystem=~/OneDrive将常用文件夹添加到应用永久访问列表
• 代码示例：

// 保存路径
var folderPicker = new FolderPicker();
var selectedFolder = await folderPicker.PickFolderAsync();
if (selectedFolder != null)
{
    Preferences.Default.Set("LastFolderPath", selectedFolder.FullPath);
}

// 启动时尝试访问
string savedPath = Preferences.Default.Get("LastFolderPath", string.Empty);
if (!string.IsNullOrEmpty(savedPath))
{
    try
    {
        var folder = new DirectoryInfo(savedPath);
        if (folder.Exists)
        {
            // 正常访问
        }
        else
        {
            // 路径不存在，触发重新选择
        }
    }
    catch (UnauthorizedAccessException)
    {
        // 无权限，触发重新选择
    }
}

OneDrive特殊处理 #

• 确保保存的是OneDrive本地同步文件夹的实际路径，而非云端链接
• 可通过检测路径是否包含"OneDrive"关键字（注意多语言版本差异）或让用户手动确认同步路径
• 当OneDrive同步位置变更时，保存的路径会失效，需捕获路径不存在的异常，引导用户重新选择

统一处理流程 #

1. 应用启动时从本地存储读取对应的持久化信息（令牌/书签/路径）
2. 调用对应平台API尝试恢复访问权限
3. 若恢复失败（异常、路径不存在、令牌过期等），自动触发文件/文件夹选择流程
4. 用户每次选择后，更新本地存储的持久化信息
5. 在所有文件操作处添加异常捕获，遇到权限不足或路径失效时引导用户重新选择

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