Android指定图库图片路径通过Glide加载到ImageView失败求助

• Android 10（API 29）及以上系统默认启用分区存储机制，直接拼接Environment.getExternalStorageDirectory()相关物理路径访问公共图库文件的行为被系统限制，即使申请了存储读取权限，也无法通过这种文件路径直接读取文件，这是加载失败的核心原因。
• 代码存在逻辑错误：重复调用Glide的.load()方法时，后调用的方法会覆盖之前的加载配置；部分路径拼接时第二个参数带了开头的/，会被系统识别为绝对路径，直接忽略传入的父路径，导致实际访问路径和你预期的不一致；硬编码/mnt/sdcard/0属于厂商私有路径，不具备全设备通用性，大概率访问失败。
• 用Uri.fromFile()生成的文件类型Uri在高版本系统上不具备访问权限，Glide加载这类Uri会被系统拦截，无法读取文件内容。

不需要使用已废弃的startActivityForResult，直接通过系统MediaStore接口按文件名查询目标图片的合法Content Uri，再传给Glide加载即可，完全符合系统权限规则。

1. 按文件名查询图片合法Uri #

/**
 * 按文件名查询公共图库中对应图片的可访问Uri
 * @param targetFileName 目标图片文件名，例如 "my_gallery_image.png"
 */
private Uri getGalleryImageUri(String targetFileName) {
    ContentResolver resolver = getContentResolver();
    // 适配不同版本系统的图库Uri集合
    Uri imageCollection = Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q ?
            MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL) :
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI;

    String[] queryProjection = {MediaStore.Images.Media._ID};
    // 按文件名精确匹配筛选
    String querySelection = MediaStore.Images.Media.DISPLAY_NAME + " = ?";
    String[] selectionArgs = {targetFileName};

    try (Cursor cursor = resolver.query(
            imageCollection,
            queryProjection,
            querySelection,
            selectionArgs,
            null
    )) {
        if (cursor != null && cursor.moveToFirst()) {
            long imageId = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
            // 生成Glide可直接加载的content://类型Uri
            return ContentUris.withAppendedId(imageCollection, imageId);
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

2. Glide正确加载代码 #

// 替换为你实际需要加载的图片文件名
String targetImageName = "my_gallery_image.png";
Uri imageUri = getGalleryImageUri(targetImageName);

if (imageUri != null) {
    Glide.with(this)
            .load(imageUri)
            .error(R.mipmap.image_error)
            .diskCacheStrategy(DiskCacheStrategy.ALL)
            .into(imageView_H);
} else {
    Toast.makeText(this, "未在图库中找到指定名称的图片", Toast.LENGTH_SHORT).show();
}

补充注意事项 #

• 权限适配：Android 12及以下版本在Manifest中声明READ_EXTERNAL_STORAGE权限，Android 13及以上版本声明READ_MEDIA_IMAGES权限即可，不需要申请写存储权限。
• Android 10临时兼容：如果需要快速适配Android 10设备，可以在Manifest的<application>标签下添加android:requestLegacyExternalStorage="true"，但该配置在Android 11及以上版本会失效，长期适配必须使用MediaStore方案。
• 不要使用任何硬编码的物理存储路径，不同厂商设备的存储挂载路径存在差异，硬编码路径无法保证全设备兼容。

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