Android分区存储下osmdroid离线地图文件随机删除问题排查

可能的原因 #

• osmdroid缓存清理逻辑误删：如果你的代码中调用了osmdroid提供的瓦片缓存清理API（比如TileWriter.clear()），或是配置了自动缓存大小阈值，部分版本的osmdroid清理逻辑会扫描整个osmdroidBasePath目录下的文件，而非仅限制在tiles子目录，会误删同目录下你自行下载的离线地图文件。
• 厂商自定义ROM的存储优化逻辑：三星、欧乐风这类厂商的定制系统会额外实现存储自动清理策略，即便你的离线文件存放在getExternalFilesDir目录（系统原生逻辑不会自动清理该目录），部分ROM在判定存储紧张、或是应用长期未启动时，会将该目录下识别为「非必要数据」的大体积文件（比如离线地图包）清理，仅保留应用运行必须的目录结构（比如你看到的tiles文件夹还存在）。
• 应用初始化逻辑冲突：检查你应用启动时的文件操作逻辑，是否存在对osmdroidBasePath目录的遍历、删除旧版本地图文件的逻辑，若版本比对、文件校验逻辑存在bug，会误将正常的离线地图识别为旧版本冗余文件删除。
• 下载文件的持久化异常：如果你的下载逻辑是先将文件写入临时文件，下载完成后再移动到osmdroidBasePath目录，若移动操作没有做完成校验，部分情况下系统重启后未持久化的临时文件会被回收，看起来就像文件被自动删除。

排查建议 #

• 将离线地图文件单独存放在getExternalFilesDir下的独立目录，和osmdroid的缓存目录完全隔离，避免被osmdroid的清理逻辑误操作；如果需要保留现有目录结构，清理缓存时明确只删除tiles子目录下的文件，不要扫描父目录。
• 针对三星等定制ROM的用户，可以引导用户将应用加入系统的「存储优化白名单」「不休眠应用列表」，避免系统自动清理应用数据。
• 增加应用启动时的离线文件校验逻辑，记录已下载文件的哈希值、大小等信息，文件丢失时可以上报对应时间点的系统存储状态、应用休眠状态，帮助定位问题。

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