Hey，我看你用FileProvider实现了相机拍照保存的逻辑，但偶尔会出现图片存不进相册的情况。结合你的代码和Android开发中常见的坑，我整理了几个关键排查点和修复方案：

一、先检查文件创建与存储权限 #

你的createImageFile()方法很可能是问题源头之一：

• 权限问题：API 23+必须动态申请WRITE_EXTERNAL_STORAGE权限（API 30+虽然有分区存储，但要让相册看到图片，还是得确保有媒体库访问权限）。如果没申请权限，文件根本写不进去。
• 存储目录选择：如果你的createImageFile()把文件存在了应用私有目录（比如getFilesDir()），相册默认是看不到这个目录的。建议改成公共图片目录，或者后续主动通知媒体库扫描。

给你一个靠谱的createImageFile()示例：

private File createImageFile() throws IOException {
    // 生成唯一文件名避免冲突
    String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss", Locale.CHINA).format(new Date());
    String imageFileName = "CAM_" + timeStamp + "_";
    // 公共图片目录，相册默认会扫描这里
    File storageDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
    File image = File.createTempFile(imageFileName, ".jpg", storageDir);
    // 保存文件路径，后续扫描要用
    mCurrentPhotoPath = image.getAbsolutePath();
    return image;
}

二、核对FileProvider配置是否正确 #

很多人这里会踩坑：

1. 检查AndroidManifest.xml里的FileProvider注册，确保authorities和你代码里的getContext().getPackageName() + ".provider"完全一致：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.provider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

2. 确认res/xml/file_paths.xml配置了对应的存储目录，比如你用公共图片目录的话，要加：

<external-path name="public_pictures" path="Pictures" />

如果是应用私有外部目录，就用external-files-path标签。

三、拍照后主动通知媒体库扫描 #

就算文件成功保存了，媒体库也不会实时刷新，所以相册看不到。拍照完成后（比如在onActivityResult或者新的Activity Result API回调里），一定要触发扫描：

简单方案：发送广播通知扫描 #

private void notifyGallery() {
    Intent scanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    File photoFile = new File(mCurrentPhotoPath);
    Uri photoUri = Uri.fromFile(photoFile);
    scanIntent.setData(photoUri);
    getContext().sendBroadcast(scanIntent);
}

API 29+推荐方案：直接插入MediaStore #

如果你的APP适配到Android 10及以上，更推荐用MediaStore直接插入记录，这样相册能立刻看到图片，还能避免分区存储的问题：

private void addToMediaStore(Context context) {
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, "我的照片.jpg");
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES);
    values.put(MediaStore.Images.Media.IS_PENDING, 1);

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

    try {
        // 把拍摄的图片复制到MediaStore指定的位置
        OutputStream os = resolver.openOutputStream(uri);
        FileInputStream is = new FileInputStream(new File(mCurrentPhotoPath));
        // 这里可以用IOUtils或者自己实现文件复制
        byte[] buffer = new byte[1024];
        int len;
        while ((len = is.read(buffer)) != -1) {
            os.write(buffer, 0, len);
        }
        is.close();
        os.close();

        // 标记为已完成，媒体库就能识别了
        values.clear();
        values.put(MediaStore.Images.Media.IS_PENDING, 0);
        resolver.update(uri, values, null, null);
    } catch (IOException e) {
        e.printStackTrace();
        // 出错就删除这条记录
        resolver.delete(uri, null, null);
    }
}

四、完善Intent权限设置 #

你已经加了FLAG_GRANT_WRITE_URI_PERMISSION，但最好再加上读权限，并且显式给相机应用授予权限，避免部分厂商定制的相机APP权限不足：

Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT, pictureUri);
// 同时添加读写权限
intent.setFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
// 显式授予权限给所有能处理这个Intent的应用
List<ResolveInfo> resInfoList = getContext().getPackageManager()
        .queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo info : resInfoList) {
    String packageName = info.activityInfo.packageName;
    getContext().grantUriPermission(packageName, pictureUri,
            Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
}

最后给你几个测试排查技巧 #

• 拍照后打印mCurrentPhotoPath，用文件管理器去这个路径看文件是否真的存在，如果不存在，说明是文件创建或权限问题。
• 查看Logcat，搜索FileNotFoundException、SecurityException这些关键词，错误日志会直接告诉你哪里出问题了。

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