【媒体文件选择器】Matisse 图片排序异常？一文看懂 MediaStore 时间字段与正确排序方案

原创于 2025-12-15 09:02:08 发布 · 置顶 · 124 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#gitee

存档笔记专栏收录该内容

18 篇文章

订阅专栏

『AI先锋杯·14天征文挑战第9期』 10w+人浏览 83人参与

摘要：
系统相册与 Matisse 排序不一致的根因分析，提供统一稳定的排序实现方式。

【Android】Matisse 图片排序异常问题深度分析与完整解决方案

关联文档：

【媒体文件选择器】知乎 Matisse 全功能解析：Android 开发者必看的图片与视频选择器指南

在 Android 项目中使用 Matisse 选择图片是一件再常见不过的事情。然而在某些设备上，我们可能会遇到一个不符预期的现象：

系统相册中排序正常，但在 Matisse 中打开同一个相册，图片顺序却完全不一致。

这个问题看似简单，实际上牵涉到了 MediaStore 字段意义差异、厂商系统修改导致的时间戳异常、以及 Matisse 的内部排序逻辑。本篇文章将完整拆解问题产生原因、源码定位过程，以及给出可稳定运行的解决方案。

一、问题场景：系统相册排序正常，但第三方选择器排序错乱

项目中使用 Matisse 作为图片选择器，在大部分设备中表现稳定，但在某些 Android 机型上，用户反馈：

系统自带相册中按「时间」排序完全正常
进入 App 的图片选择界面后，同一批图片顺序乱了
新拍的图有时排在很后面
多张同一时间生成的截图排序混乱、不稳定

这类问题往往表现为“偶发”，但当用户频繁截图、编辑图片时，排序乱序几乎一定能复现。

二、问题复现：修改时间、拍摄时间字段表现不一致

在问题设备上，通过 adb 查看 MediaStore 记录：

adb shell content query --uri content://media/external/images/media

可观察到以下情况：

DATE_TAKEN（拍摄时间）字段经常为 0 或 null
DATE_MODIFIED（文件修改时间）比较准确
文件管理器与系统相册常以 DATE_MODIFIED 排序
某些第三方应用采信 DATE_TAKEN 导致顺序出现差异

结论：系统相册与 Matisse 使用了不同排序字段。

三、深入源码：Matisse 默认排序规则的真正逻辑

Matisse 的核心加载器 AlbumMediaLoader 中定义了排序规则：
在这里插入图片描述

public static final String ORDER_BY =
        "case ifnull(" + MediaStore.Images.Media.DATE_TAKEN + ",0)" +
        " when 0 then " + MediaStore.Images.Media.DATE_MODIFIED + "*1000" +
        " else " + MediaStore.Images.Media.DATE_TAKEN +
        " end" + " DESC , " + MediaStore.Images.ImageColumns._ID + " DESC";

这一段 SQL 表示什么？

逻辑可以拆解成三步：

优先使用 DATE_TAKEN（拍摄时间）
如果 DATE_TAKEN 为空或为 0，则 fallback 到 DATE_MODIFIED
最终按降序排列

看似合理，但最大问题是：

某些设备对 `DATE_TAKEN` 的写入策略完全不同

发现在某国产机型（品牌匿名，因为这是该品牌关于图库的优化策略导致，不是说不好）上照片排序不符预期

在这些设备中：

截图默认没有 DATE_TAKEN
某些编辑后的图片会覆写 DATE_TAKEN = 0
图片被重新保存后 DATE_TAKEN 丢失
文件复制到本机时，系统不会重新写入 DATE_TAKEN

结果就是：

Matisse 认为“拍摄时间为 0，优先 fallback 到修改时间”，
但系统相册认为“直接按修改时间排序”。

两者排序依据不一致 → 排序就乱了。

这就是排序异常的根本原因。

四、验证：两种排序方式导致的不同结果

为了验证差异，我们构建了两条排序规则：

系统相册（推测逻辑）

推测该品牌手机的系统相册，排序是按照修改时间倒排。

ORDER BY DATE_MODIFIED DESC

Matisse 默认逻辑（源码）

ORDER BY 
    CASE WHEN DATE_TAKEN IS NULL OR DATE_TAKEN = 0 
        THEN DATE_MODIFIED * 1000 
        ELSE DATE_TAKEN 
    END DESC,
    _ID DESC

在测试设备上导入一组图片、截图、编辑图后，会观察到：

系统相册严格按最近修改时间降序排列
Matisse 内部按“拍摄时间 + 修改时间 fallback”排序
即使是同一批图片，顺序也完全不同

五、解决方案：强制按 date_modified 排序

我们重新构建一个稳定排序规则，使 Matisse 的行为与系统相册一致：

以下提供两种方案供参考：

修改AlbumMediaLoader源码

直接替换 AlbumMediaLoader 中 ORDER_BY 的字符串。

把它复制到你当前的 AlbumMediaLoader 即可

public static final String ORDER_BY =
    "CASE " +
      " WHEN ifnull(" + MediaStore.MediaColumns.DATE_MODIFIED + ",0) > 1000000000000 THEN " + MediaStore.MediaColumns.DATE_MODIFIED +
      " WHEN ifnull(" + MediaStore.Images.Media.DATE_TAKEN + ",0) > 0 THEN " + MediaStore.Images.Media.DATE_TAKEN +
      " ELSE " + MediaStore.MediaColumns.DATE_MODIFIED + " * 1000 " +
    " END DESC, " +
    MediaStore.Images.ImageColumns._ID + " DESC";

完全可用的自定义 Loader

public class CustomAlbumMediaLoader extends CursorLoader {

    public CustomAlbumMediaLoader(Context context, Uri uri) {
        super(context, uri,
                PROJECTION,
                SELECTION,
                SELECTION_ARGS,
                ORDER_BY);
    }

    private static final String[] PROJECTION = {
            MediaStore.Files.FileColumns._ID,
            MediaStore.MediaColumns.MIME_TYPE,
            MediaStore.MediaColumns.DATE_MODIFIED,
            MediaStore.MediaColumns.DATE_ADDED
    };

    private static final String SELECTION =
            MediaStore.Files.FileColumns.MEDIA_TYPE + "=?";

    private static final String[] SELECTION_ARGS = new String[]{
            String.valueOf(MediaStore.Files.FileColumns.MEDIA_TYPE_IMAGE)
    };

    // **强制按修改时间排序**
    private static final String ORDER_BY =
            MediaStore.MediaColumns.DATE_MODIFIED + " DESC, " +
            MediaStore.Files.FileColumns._ID + " DESC";
}

替换 Matisse 默认 LoaderEngine，即可让 Matisse 只使用 DATE_MODIFIED 排序。

如果你使用的是自定义 LoaderEngine：

AlbumMediaLoader.registerLoader(new CustomLoaderEngine());

确保所有相册加载都走你定义的 Loader。

六、为什么必须使用 DATE_MODIFIED？

在实际 Android 生态中：

截图、编辑图、保存图 → 都会更新 DATE_MODIFIED
部分设备不会写 DATE_TAKEN
复制到本地或从微信保存也不会写 DATE_TAKEN
部分厂商重新压图会把 DATE_TAKEN 清零
系统相册几乎都以 DATE_MODIFIED 为准

因此：

DATE_MODIFIED 是 Android 上最稳定、最统一、兼容最广的排序依据。

七、最终效果：与系统相册保持一致

在强制使用 DATE_MODIFIED DESC 后：

所有测试设备排序一致
与系统相册完全对齐
截图、编辑图、新拍照片排序完全正确
不再出现随机乱序、前后颠倒问题

八、总结：这个排序问题其实比想象更复杂

很多开发者以为“图片排序混乱”是 UI 问题、Recycler 顺序问题、甚至是 Glide 缓存问题。但核心原因其实是：

不同机型对 DATE_TAKEN 的写入策略不一致
系统相册与第三方库使用不同字段作为排序依据
Matisse 默认排序策略在现实场景下并不通用

因此，最稳妥的解决方式就是：

👉 在所有设备上统一使用 DATE_MODIFIED 进行排序
👉 替换 Matisse 内部 LoaderEngine，确保排序逻辑可控
👉 保证与系统相册的体验保持一致