CameraX开发简易安卓相机应用无法保存照片问题求助

核心问题点 #

• 路径拼接逻辑错误
  1. 根路径硬编码缺少前缀斜杠，且不兼容不同设备的存储路径规则
  2. 文件夹路径和文件名拼接时缺少路径分隔符，最终生成的文件路径不符合预期，无法写入不存在的父目录
• 缺少必要的动态权限申请
  未申请相机权限、外部存储写入权限（Android 13+需申请READ_MEDIA_IMAGES权限），无权限无法完成照片写入操作
• 未捕获异常详细信息
  onError回调中仅弹出失败提示，未打印异常堆栈，无法快速定位具体错误原因

修复步骤 #

1. 首先补充权限配置与申请逻辑
   在AndroidManifest.xml中添加权限声明：

<!-- 相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Android 12及以下存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13及以上媒体照片权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

<uses-feature android:name="android.hardware.camera.any" />

页面启动时先检查并动态申请上述权限，权限通过后再初始化CameraX。

2. 修正照片保存路径逻辑
   不要硬编码存储路径，使用官方提供的公共目录API，拼接时补充路径分隔符：

public void capture_image()
{
    // 使用公共图片目录下的JayurCam文件夹，兼容全版本系统
    File ex = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES), "JayurCam");
    if(!ex.exists()) {
        boolean dirCreated = ex.mkdirs();
        if (!dirCreated) {
            Toast.makeText(this, "文件夹创建失败", Toast.LENGTH_SHORT).show();
            return;
        }
    }
    String dte = String.valueOf(new Date().getTime());
    // 补充路径分隔符，保证文件是保存在JayurCam目录下
    File path = new File(ex, dte + ".jpg");
    ImageCapture.OutputFileOptions outputFileOptions =
            new ImageCapture.OutputFileOptions.Builder(path).build();
    imageCapture.takePicture(outputFileOptions, ContextCompat.getMainExecutor(this),
            new ImageCapture.OnImageSavedCallback() {
                @Override
                public void onImageSaved(@NonNull ImageCapture.OutputFileResults outputFileResults) {
                    Toast.makeText(BaseCamera.this, "照片保存成功", Toast.LENGTH_SHORT).show();
                }
                @Override
                public void onError(@NonNull ImageCaptureException exception) {
                    // 打印异常信息方便排查
                    Log.e("CameraXError", "保存失败: ", exception);
                    Toast.makeText(BaseCamera.this, "保存失败: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
                }
            }
    );
}

3. 可选优化
   可以给ImageCapture设置目标分辨率，避免部分设备适配问题；拍照前先判断imageCapture是否已经初始化完成，避免空指针。

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