Android 相机拍照防空文件方法

本文详解 Android 使用 Camera Intent 拍照时因预创建临时文件导致“未拍照却生成空文件”的问题，提供基于全局 File 引用 + onActivityResult 状态判断的可靠解决方案，并附完整代码实践与关键注意事项。

在 Android 开发中，通过 MediaStore.ACTION_IMAGE_CAPTURE 启动系统相机是一种常见且高效的方式。但一个易被忽视的问题是：即使用户取消拍摄或直接返回，程序预先创建的临时文件仍会保留在存储目录中，形成零字节（0B）的无效图片文件。这不仅浪费存储空间，还可能干扰后续图片管理逻辑（如图库扫描、上传校验等）。

根本原因在于：File.createTempFile() 在调用 startActivityForResult() 前就已执行，无论用户是否实际完成拍摄，该文件都已被物理创建。而 onActivityResult() 中仅当 resultCode == RESULT_OK 时才被触发——这意味着用户点击“确认保存”后才会进入该分支；但用户点击“取消”“返回”或相机异常退出时，resultCode 通常为 RESULT_CANCELED 或其他非 OK 值，此时临时文件无人清理。

✅ 正确解法是：

1. 将 imageFile 声明为 Activity/Fragment 的成员变量（全局引用），确保 onActivityResult() 能访问到同一实例；
2. 在 onActivityResult() 中统一判断结果码：仅当 RESULT_OK 时处理图片；其余所有情况（包括 RESULT_CANCELED、RESULT_FIRST_USER 或异常中断）均应主动删除该临时文件。

以下是优化后的完整实现示例：

public class PhotoCaptureActivity extends AppCompatActivity {
    private static final int REQUEST_CODE_TAKE_PHOTO = 1;
    private File imageFile; // ✅ 全局声明，跨方法共享

    public void onCapturePhoto(String fileName) {
        File storageDir = getExternalFilesDir(Environment.DIRECTORY_PICTURES);
        try {
            // ✅ 创建临时文件并赋值给成员变量
            imageFile = File.createTempFile(fileName, ".jpg", storageDir);
            currentPhotoPath = imageFile.getAbsolutePath();

            Uri imageUri = FileProvider.getUriForFile(
                this,
                "com.abc.projectname.bf", // 注意：需与 manifest 中 provider authority 一致
                imageFile
            );

            Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
            intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
            startActivityForResult(intent, REQUEST_CODE_TAKE_PHOTO);

        } catch (IOException e) {
            Log.e("Camera", "Failed to create temp file", e);
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        if (requestCode == REQUEST_CODE_TAKE_PHOTO) {
            if (resultCode == RESULT_OK) {
                // ✅ 用户成功拍照并确认 —— 文件有效，可安全使用
                if (imageFile != null && imageFile.exists()) {
                    Log.i("Camera", "Photo saved: " + imageFile.getAbsolutePath());
                    // 此处可加载 Bitmap、压缩、上传或保存至数据库等
                    handleCapturedImage(imageFile);
                }
            } else {
                // ❌ 用户未拍照（取消/返回/崩溃）—— 删除残留临时文件
                if (imageFile != null && imageFile.exists()) {
                    boolean deleted = imageFile.delete();
                    Log.i("Camera", "Temp file deleted: " + deleted + " | " + imageFile.getAbsolutePath());
                }
            }
        }
    }

    private void handleCapturedImage(File photoFile) {
        // 示例：加载缩略图显示（生产环境建议使用 Glide / Coil）
        Bitmap bitmap = BitmapFactory.decodeFile(photoFile.getAbsolutePath());
        if (bitmap != null) {
            imageView.setImageBitmap(bitmap);
        }
    }
}

⚠️ 关键注意事项：

• FileProvider 配置必须正确：确保 AndroidManifest.xml 中 的 android:authorities 与 FileProvider.getUriForFile() 第三个参数完全一致（如 "com.abc.projectname.bf"），否则会抛出 IllegalArgumentException；
• 权限适配 Android 10+（Scoped Storage）：getExternalFilesDir() 返回的是应用专属目录，无需额外运行时权限，且不受分区存储限制，推荐优先使用；避免写入 Environment.getExternalStoragePublicDirectory()；
• 避免内存泄漏风险：若在 Fragment 中实现，请使用 requireActivity() 并注意生命周期，在 onDestroyView() 或 onDetach() 中置空 imageFile（可选）；
• 增强鲁棒性（进阶）：可在 onCreate() 中扫描并清理上次遗留的临时文件（按命名规则匹配 .jpg 且大小为 0B），作为兜底策略。

通过上述结构化处理，即可彻底杜绝“未拍照却生成空文件”的问题，保障图片存储逻辑的健壮性与用户体验的一致性。