一、图库找不到照片的问题排查与修复 #

咱们先拆解问题根源：你现在把照片存在了应用私有外部存储目录（通过getExternalFilesDir(Environment.DIRECTORY_PICTURES)获取的路径），这个目录是应用专属的“私密空间”，系统默认的媒体扫描器不会主动扫描这里的文件；再加上你在API 24环境下用Uri.fromFile(f)生成file://类型的Uri发送扫描广播，这会触发FileUriExposedException（可能你没注意到崩溃日志），导致广播根本没被媒体扫描器接收，所以图库自然找不到照片。

给你两个可行的修复方案，按需选择：

方案1：切换到公共图片目录存储 #

把照片存到系统公共的图片文件夹，媒体扫描器会自动识别这里的文件，修改createImageFile方法即可：

private File createImageFile() throws IOException {
    String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
    String imageFileName = "JPEG_" + timeStamp + "_";
    // 替换为系统公共图片目录
    File storageDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
    File image = File.createTempFile(
            imageFileName, /* 前缀 */
            ".jpg", /* 后缀 */
            storageDir /* 存储目录 */
    );
    currentPhotoPath = image.getAbsolutePath();
    return image;
}

⚠️ 注意：你在Manifest里给WRITE_EXTERNAL_STORAGE设置了maxSdkVersion="18"，API 19及以上版本写入公共目录需要动态申请权限，记得补充权限申请的逻辑哦。

方案2：通过MediaStore注册图片到媒体库（推荐适配Android 10+） #

如果不想用公共目录，或者要适配更高版本的Android，可以通过MediaStore把私有目录的照片信息注册到系统媒体库，这样图库就能直接识别。修改onActivityResult方法：

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_IMAGE_CAPTURE && resultCode == RESULT_OK) {
        try {
            File imageFile = new File(currentPhotoPath);
            ContentValues values = new ContentValues();
            values.put(MediaStore.Images.Media.DISPLAY_NAME, imageFile.getName());
            values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");

            // Android 10及以上需要设置相对路径
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/MyAppPhotos");
                values.put(MediaStore.Images.Media.IS_PENDING, 1);
            } else {
                values.put(MediaStore.Images.Media.DATA, imageFile.getAbsolutePath());
            }

            ContentResolver resolver = getContentResolver();
            Uri uri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);

            if (uri != null) {
                // 将拍摄的图片写入MediaStore对应的Uri
                try (OutputStream outputStream = resolver.openOutputStream(uri)) {
                    try (InputStream inputStream = new FileInputStream(imageFile)) {
                        byte[] buffer = new byte[1024];
                        int bytesRead;
                        while ((bytesRead = inputStream.read(buffer)) != -1) {
                            outputStream.write(buffer, 0, bytesRead);
                        }
                    }
                }

                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                    values.put(MediaStore.Images.Media.IS_PENDING, 0);
                    resolver.update(uri, values, null, null);
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

这种方式不需要发送扫描广播，直接通过系统媒体库API注册图片，兼容性更好。

另外说一句：你的file_paths.xml和FileProvider配置是没问题的，不用调整～

二、两篇官方教程的核心区别 #

这两篇教程的定位完全不同，咱们从几个维度区分：

• 核心目标：
  • 《Save the full-size photo》：重点是「如何获取并保存完整尺寸的照片」，解决的是相机拍照默认返回缩略图的问题，默认把照片存在应用私有目录，适合不需要用户在图库查看的场景（比如应用内部的临时图片、头像）。
  • 《Add the photo to a gallery》：在前者的基础上，核心是「让拍摄的照片在系统图库中可见」，解决的是私有目录图片不被系统识别的问题，适合需要用户分享、管理的公开图片场景。
• 存储策略：
  • 前者用应用私有外部存储，照片随应用卸载删除，隐私性强；
  • 后者引导用公共存储或MediaStore注册，照片不会随应用卸载删除（公共存储的情况），开放性更好。
• 实现步骤：
  • 前者只需要处理拍照、文件保存的逻辑；
  • 后者需要额外添加媒体扫描广播或MediaStore插入逻辑，让系统媒体库识别图片。

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