如何解决UWP应用中SQLite网络路径访问异常问题

问题根源 #

调试模式下UWP应用容器权限限制宽松，允许直接访问UNC路径；但发布模式会严格执行沙箱权限规则，即便开启了privateNetworkClientServer和internetClient，默认也无法直接读写SMB共享上的SQLite文件。

解决步骤 #

1. 补充必要权限 #

根据你的发布场景选择对应的权限：

• 非企业/个人发布：添加broadFileSystemAccess权限，该权限允许应用访问系统所有文件（含网络共享），但需要用户手动授权。在Package.appxmanifest中添加：

  <Capabilities>
    <Capability Name="internetClient" />
    <Capability Name="privateNetworkClientServer" />
    <uap:Capability Name="broadFileSystemAccess" />
  </Capabilities>
  

  用户授权操作：打开设置 > 隐私和安全性 > 文件系统，找到你的应用并开启权限开关。

• 企业内部发布：添加enterpriseAuthentication权限，配合域身份验证自动获取网络访问权限，无需用户手动操作：

  <Capabilities>
    <Capability Name="internetClient" />
    <Capability Name="privateNetworkClientServer" />
    <Capability Name="enterpriseAuthentication" />
  </Capabilities>
  

2. 用UWP原生API替代直接路径访问 #

UWP沙箱不推荐直接使用UNC路径操作文件，改用StorageFile API来获取文件对象，再通过流操作SQLite：

// 获取网络共享文件
StorageFile sqliteFile = await StorageFile.GetFileFromPathAsync(@"\\ServerName\SharedFolder\FileName.sqlite");

// 以读写模式打开文件流
using (var fileStream = await sqliteFile.OpenAsync(FileAccessMode.ReadWrite))
{
    // 初始化SQLite连接（此处假设使用SQLite-NET库）
    using (var connection = new SQLiteConnection(fileStream.AsStream()))
    {
        // 执行数据库读写操作
        // ...
    }
}

3. 同步调试与发布的配置 #

检查发布版本的Package.appxmanifest，确保所有需要的权限都已添加，避免调试和发布配置不一致导致权限缺失。

4. 可选：添加文件类型关联 #

如果你的SQLite文件使用特定后缀（如.sqlite），在Package.appxmanifest中添加文件类型关联，提升应用对该文件的识别能力：

<Extensions>
  <uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="sqlite">
      <uap:SupportedFileTypes>
        <uap:FileType>.sqlite</uap:FileType>
      </uap:SupportedFileTypes>
    </uap:FileTypeAssociation>
  </uap:Extension>
</Extensions>

重要提示 #

• broadFileSystemAccess在Microsoft Store发布时需要提交权限使用说明，审核通过后才能上架。
• 企业环境优先使用enterpriseAuthentication，减少用户操作成本。
• 始终使用UWP提供的StorageFile/StorageFolder API处理文件，适配沙箱权限模型，避免因直接路径访问导致的权限问题。

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