Android外部存储文件保存位置混乱及写入失败问题咨询

一、先理清存储概念，纠正混淆 #

• 技术定义的Internal Storage：App专属私有目录，路径为getFilesDir()或getCacheDir()，无需存储权限，其他App无法访问，卸载App时会被删除。这才是你最初想存的"Internal Storage"。
• 用户认知的"Internal Memory"：属于Android技术定义的Primary External Storage，SD卡是Secondary External Storage，两者都归为External Storage范畴，需要权限（不同版本要求不同），用户可通过文件管理器访问。

二、Android9/10创建目录失败的核心原因 #

1. 权限流程缺失：Android6+需动态申请WRITE_EXTERNAL_STORAGE权限，仅在设置里开启不够，必须在代码中完成动态权限请求流程。
2. 适配代码错误：
   • API29（Android10）开始，Environment.getExternalStoragePublicDirectory()已被废弃，且Scoped Storage限制直接在公共目录下创建自定义文件夹，字符串拼接路径的方式也易出现格式错误。
   • Android9/10中，直接在Environment.getExternalStorageDirectory()下创建目录，必须确保已获得WRITE_EXTERNAL_STORAGE权限，且路径构造正确。

三、正确实现方案 #

场景1：保存到真正的Internal Storage（App私有） #

无需权限，文件仅你的App可访问：

FileOutputStream outStream = null;
// 获取App私有Internal Storage目录
File dir = new File(getActivity().getFilesDir(), "Test_Folder");

if (!dir.exists()) {
    boolean isCreated = dir.mkdirs();
    if (!isCreated) {
        Log.e("File", "Directory not created");
        Toast.makeText(getActivity(), "Directory not created", Toast.LENGTH_SHORT).show();
        return;
    }
}

String fileName = String.format("%d.jpg", System.currentTimeMillis());
File outFile = new File(dir, fileName);

try {
    outStream = new FileOutputStream(outFile);
    bitmap.compress(Bitmap.CompressFormat.JPEG, 100, outStream);
    outStream.flush();
    outStream.close();
    Toast.makeText(getActivity(), "Saved to Internal Storage", Toast.LENGTH_SHORT).show();
} catch (FileNotFoundException e) {
    e.printStackTrace();
} catch (IOException e) {
    e.printStackTrace();
}

场景2：保存到公共图库目录（用户可见，适配全版本） #

针对不同版本适配Scoped Storage，避免权限和目录创建问题：

步骤1：Manifest声明权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />
<!-- Android10+无需WRITE权限，若要访问所有文件需MANAGE_EXTERNAL_STORAGE（不推荐） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30"
    tools:ignore="ScopedStorage" />

步骤2：动态申请权限（Android6+）

// 仅Android6-9需要申请WRITE_EXTERNAL_STORAGE
if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.P &&
        ContextCompat.checkSelfPermission(getActivity(), Manifest.permission.WRITE_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(getActivity(),
            new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
            1001);
    return;
}

步骤3：全版本保存代码

// 保存Bitmap到公共图库
private void saveBitmapToGallery(Bitmap bitmap) {
    String displayName = String.format("%d.jpg", System.currentTimeMillis());
    String mimeType = "image/jpeg";
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, displayName);
    values.put(MediaStore.Images.Media.MIME_TYPE, mimeType);

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        // Android10+用MediaStore插入，无需手动创建目录
        values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/Test_Folder");
        values.put(MediaStore.Images.Media.IS_PENDING, 1);
    } else {
        // Android9及以下，先确保目录存在
        File dir = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES), "Test_Folder");
        if (!dir.exists() && !dir.mkdirs()) {
            Log.e("File", "Directory not created");
            Toast.makeText(getActivity(), "Directory not created", Toast.LENGTH_SHORT).show();
            return;
        }
        values.put(MediaStore.Images.Media.DATA, new File(dir, displayName).getAbsolutePath());
    }

    ContentResolver resolver = getActivity().getContentResolver();
    Uri uri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
    if (uri == null) {
        Log.e("File", "Failed to insert media");
        Toast.makeText(getActivity(), "Save failed", Toast.LENGTH_SHORT).show();
        return;
    }

    try (OutputStream outStream = resolver.openOutputStream(uri)) {
        if (!bitmap.compress(Bitmap.CompressFormat.JPEG, 100, outStream)) {
            throw new IOException("Failed to compress bitmap");
        }
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            values.clear();
            values.put(MediaStore.Images.Media.IS_PENDING, 0);
            resolver.update(uri, values, null, null);
        }
        Toast.makeText(getActivity(), "Saved to Gallery", Toast.LENGTH_SHORT).show();
    } catch (IOException e) {
        e.printStackTrace();
        // 插入失败，删除无效条目
        resolver.delete(uri, null, null);
        Toast.makeText(getActivity(), "Save failed", Toast.LENGTH_SHORT).show();
    }
}

四、关键注意事项 #

• 避免直接操作Environment.getExternalStorageDirectory()或废弃API，优先用MediaStore适配Android10+的Scoped Storage。
• 若必须访问SD卡（Secondary External Storage），需通过Context.getExternalFilesDirs()获取路径，且Android11+需MANAGE_EXTERNAL_STORAGE权限，不推荐普通App使用。

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