DocumentFile本地存储方法（exist/canWrite等）性能低下问题咨询

问题描述 #

• 在手机内置本地存储（非云存储）环境下，DocumentFile 的 exists() 和 canWrite() 方法相比 File 占用CPU时间明显更高：单次调用耗时约8-30毫秒，而 File 相同操作耗时通常不超过10毫秒，平均耗时更低。
• 测试覆盖设备：三星S10（Android 12）、三星S22 Ultra（Android 13），使用SAF（存储访问框架）时性能表现依旧糟糕。
• 更严重的是 DocumentFile.findFile() 方法，即便目标文件夹仅包含0-2个文件，该方法的执行耗时也极久。

性能瓶颈根源 #

DocumentFile 的性能问题源于其底层实现的低效设计：

• 参考 TreeDocumentFile.java 源码可知，listFiles() 方法仅查询文档ID，遍历子项获取显示名称等属性时，需要重复发起ContentProvider查询，频繁的跨进程通信带来了极大的性能开销。
• exists()、canWrite()、findFile() 等核心方法，本质上都是通过 ContentResolver 发起跨进程查询请求，相比 File 直接操作本地文件系统的方式，多了跨进程调用的额外耗时。

优化解决方案 #

1. 替换 DocumentFile，直接使用 DocumentContract 操作
   • 所有文件操作通过 DocumentContract 结合Uri完成，彻底避免 DocumentFile 封装层带来的冗余调用和性能损耗。
2. 优化ContentProvider查询逻辑
   • 自行查询ContentProvider时，在投影（projection）中一次性包含所有需要的字段（如显示名称、文档ID、权限标识等），避免多次发起查询请求。
3. 已知文件信息时直接拼接Uri
   • 若已明确文件的位置和名称，直接拼接对应的Uri，无需通过 ContentResolver 查询获取，减少不必要的耗时。

我花费大量时间从 File 切换到 DocumentFile，却没想到应用因此变得异常缓慢，若最初仅有 DocumentContract，我会直接使用它。

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