Android无法从内部存储导入数据至/data/data/{package_name}问题排查

核心问题分析 #

你的本地恢复功能失效主要源于路径逻辑错误、存储API使用不当和权限缺失这几个关键点，具体如下：

1. 恢复逻辑路径完全颠倒 #

在restoreData()方法中，你错误地将应用私有数据目录作为文件来源，把外部存储的备份目录作为目标——正确逻辑应该是从外部备份目录读取文件，写入到应用私有数据目录。

2. Android 11+存储API使用错误 #

• Android 11（API 30）及以上版本中，Environment.getExternalStorageDirectory()已被废弃，直接硬拼//Documents//backup//路径无法保证兼容性，公共Documents目录需通过Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)或存储访问框架（SAF）获取。
• 低于Android 11的设备中，sd变量会被赋值为null，导致备份/恢复时创建目标目录失败。

3. 权限缺失 #

• 访问公共Documents目录需要申请READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE权限（Android 10及以下），Android 11+则需要MANAGE_EXTERNAL_STORAGE权限（或通过SAF授权）。
• 若备份文件权限设置不正确，复制到应用私有目录的过程会失败。

4. 目录复制逻辑不匹配 #

备份时你分别复制了databases和app_audios两个子目录，但恢复时却尝试复制整个backup目录，目录结构不对应，导致数据无法正确覆盖。

修复后的代码示例 #

package com.oz.levi.core.backup;

import android.os.Build;
import android.os.Environment;

import com.oz.levi.utils.Utils;

import java.io.File;
import java.io.IOException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;

public class LocalBackupService {
    private static final String BASE_DATA_PATH = "data/com.oz.levi/"; // 修正路径分隔符
    private static final String BACKUP_DIR_NAME = "backup";
    private final ExecutorService executorService = Executors.newFixedThreadPool(4);

    public interface BackupCallback {
        void onSuccess();
        void onFailure(Exception e); // 新增失败回调，区分执行结果
    }

    public void backup(BackupCallback callback) {
        executorService.execute(() -> {
            try {
                backupData();
                callback.onSuccess();
            } catch (Exception e) {
                callback.onFailure(e);
            }
        });
    }

    public void restore(BackupCallback callback) {
        executorService.execute(() -> {
            try {
                restoreData();
                callback.onSuccess();
            } catch (Exception e) {
                callback.onFailure(e);
            }
        });
    }

    private void backupData() throws IOException {
        // 获取公共Documents目录
        File documentsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
        File backupRootDir = new File(documentsDir, BACKUP_DIR_NAME);
        // 创建备份目录（不存在则创建）
        if (!backupRootDir.exists() && !backupRootDir.mkdirs()) {
            throw new IOException("无法创建备份目录");
        }

        File dataDir = Environment.getDataDirectory();
        // 源目录：应用私有数据下的databases和app_audios
        File sourceDbDir = new File(dataDir, BASE_DATA_PATH + "databases");
        File sourceAudioDir = new File(dataDir, BASE_DATA_PATH + "app_audios");
        // 目标备份目录
        File destDbDir = new File(backupRootDir, "databases");
        File destAudioDir = new File(backupRootDir, "app_audios");

        Utils.copyDirectory(sourceDbDir, destDbDir);
        Utils.copyDirectory(sourceAudioDir, destAudioDir);
    }

    private void restoreData() throws IOException {
        // 获取公共Documents下的备份目录
        File documentsDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS);
        File backupRootDir = new File(documentsDir, BACKUP_DIR_NAME);
        if (!backupRootDir.exists()) {
            throw new IOException("备份目录不存在");
        }

        File dataDir = Environment.getDataDirectory();
        // 源备份目录
        File sourceDbDir = new File(backupRootDir, "databases");
        File sourceAudioDir = new File(backupRootDir, "app_audios");
        // 目标应用私有数据目录
        File destDbDir = new File(dataDir, BASE_DATA_PATH + "databases");
        File destAudioDir = new File(dataDir, BASE_DATA_PATH + "app_audios");

        // 确保目标目录存在
        if (!destDbDir.exists() && !destDbDir.mkdirs()) {
            throw new IOException("无法创建目标数据库目录");
        }
        if (!destAudioDir.exists() && !destAudioDir.mkdirs()) {
            throw new IOException("无法创建目标音频目录");
        }

        Utils.copyDirectory(sourceDbDir, destDbDir);
        Utils.copyDirectory(sourceAudioDir, destAudioDir);
    }
}

额外注意事项 #

1. 权限申请：
   • Android 6.0+动态申请READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限。
   • Android 11+需在Manifest中声明MANAGE_EXTERNAL_STORAGE权限，并引导用户到系统设置开启权限；或改用SAF让用户手动选择备份目录（更符合谷歌合规要求）。
2. Utils.copyDirectory实现：确保该方法能正确处理文件覆盖、子目录递归复制，以及文件权限设置（复制后文件需保证应用可读写）。
3. 异常日志：在onFailure中打印异常堆栈信息，方便排查具体失败原因。

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