如何在Android设备上定位SQLite数据库？代码运行异常求助

原代码无法运行的核心问题：

• API废弃：Environment.getExternalStoragePublicDirectory() 在 Android 10（API 29）及以上已被废弃，系统限制了对公共存储目录的直接访问。
• 权限缺失：访问公共Documents目录需要申请对应存储权限，未授权会导致文件无法创建/访问。
• 路径访问限制：直接传递公共存储绝对路径给SQLiteOpenHelper，会因系统权限管控导致数据库无法正常初始化。

方案一：使用应用私有外部存储（推荐，无需权限） #

应用私有外部存储属于应用专属目录，无需申请存储权限，卸载应用时会自动清理，适合存储应用自身数据库。

修正后的完整代码：

public class DataBase extends SQLiteOpenHelper {
    private static final String DATABASE_NAME = "your_db_name.db";
    private static final int DATABASE_VERSION = 1;
    private final Context context;

    public DataBase(Context context) {
        super(context, getDatabasePath(context), null, DATABASE_VERSION);
        this.context = context;
    }

    private static String getDatabasePath(Context context) {
        // 获取应用私有外部存储的Documents子目录
        File documentsDir = new File(context.getExternalFilesDir(null), "Documents");
        // 确保目录存在，mkdirs会创建所有父目录
        if (!documentsDir.exists()) {
            documentsDir.mkdirs();
        }
        // 返回数据库文件的绝对路径
        return new File(documentsDir, DATABASE_NAME).getAbsolutePath();
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        // 在这里添加数据库表创建逻辑，示例：
        // db.execSQL("CREATE TABLE IF NOT EXISTS user (id INTEGER PRIMARY KEY, name TEXT)");
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 在这里添加数据库升级逻辑，示例：
        // db.execSQL("DROP TABLE IF EXISTS user");
        // onCreate(db);
    }
}

方案二：访问公共Documents目录（需权限适配） #

如果必须将数据库放到公共Documents目录，需要处理权限申请和Android 10+的存储访问框架（SAF）适配：

1. 配置权限清单 #

在AndroidManifest.xml中添加权限：

<!-- Android 12及以下读写权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />
<!-- Android 13+文档访问权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_DOCUMENTS" />

2. 动态申请权限 #

在Activity中先申请权限，再初始化数据库：

private static final int REQUEST_STORAGE_PERMISSION = 1001;

private void checkAndInitDatabase() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        String permission = Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU
                ? Manifest.permission.READ_MEDIA_DOCUMENTS
                : Manifest.permission.WRITE_EXTERNAL_STORAGE;

        if (ContextCompat.checkSelfPermission(this, permission) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{permission}, REQUEST_STORAGE_PERMISSION);
            return;
        }
    }
    // 权限已通过，初始化数据库
    initDatabase();
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            initDatabase();
        } else {
            Toast.makeText(this, "需要存储权限才能访问数据库", Toast.LENGTH_SHORT).show();
        }
    }
}

private void initDatabase() {
    DataBase dbHelper = new DataBase(this);
    SQLiteDatabase db = dbHelper.getWritableDatabase();
    // 后续数据库操作
}

3. 适配Android 10+的SAF访问 #

Android 10+禁止直接读写公共存储，需通过SAF获取文件Uri来访问数据库：

public class DataBase extends SQLiteOpenHelper {
    private static final String DATABASE_NAME = "your_db_name.db";
    private static final int DATABASE_VERSION = 1;
    private final Context context;
    private final Uri dbUri;

    public DataBase(Context context, Uri dbUri) {
        super(context, null, null, DATABASE_VERSION);
        this.context = context;
        this.dbUri = dbUri;
    }

    @Override
    public SQLiteDatabase getWritableDatabase() {
        try {
            ParcelFileDescriptor pfd = context.getContentResolver().openFileDescriptor(dbUri, "rw");
            if (pfd != null) {
                return SQLiteDatabase.openDatabase(
                        pfd.getFileDescriptor().toString(),
                        null,
                        SQLiteDatabase.OPEN_READWRITE | SQLiteDatabase.NO_LOCALIZED_COLLATORS
                );
            }
        } catch (FileNotFoundException | SQLException e) {
            e.printStackTrace();
        }
        return super.getWritableDatabase();
    }

    @Override
    public SQLiteDatabase getReadableDatabase() {
        try {
            ParcelFileDescriptor pfd = context.getContentResolver().openFileDescriptor(dbUri, "r");
            if (pfd != null) {
                return SQLiteDatabase.openDatabase(
                        pfd.getFileDescriptor().toString(),
                        null,
                        SQLiteDatabase.OPEN_READONLY | SQLiteDatabase.NO_LOCALIZED_COLLATORS
                );
            }
        } catch (FileNotFoundException | SQLException e) {
            e.printStackTrace();
        }
        return super.getReadableDatabase();
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        // 表创建逻辑
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 数据库升级逻辑
    }
}

4. 通过SAF创建公共目录下的数据库 #

在Activity中调用SAF让用户选择公共Documents目录并创建数据库：

private static final int REQUEST_CREATE_PUBLIC_DB = 1002;

private void createPublicDatabase() {
    Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    intent.setType("application/x-sqlite3");
    intent.putExtra(Intent.EXTRA_TITLE, DATABASE_NAME);
    // 指定初始目录为公共Documents
    Uri publicDocsUri = MediaStore.Files.getContentUri("external");
    intent.putExtra(DocumentsContract.EXTRA_INITIAL_URI, publicDocsUri);
    startActivityForResult(intent, REQUEST_CREATE_PUBLIC_DB);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CREATE_PUBLIC_DB && resultCode == RESULT_OK && data != null) {
        Uri dbUri = data.getData();
        // 初始化数据库
        DataBase dbHelper = new DataBase(this, dbUri);
        SQLiteDatabase db = dbHelper.getWritableDatabase();
        // 后续操作
    }
}

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