Android 11+无法在外部存储创建数据库问题求助

一、Android 10+外部存储的关键变更 #

• 分区存储（Scoped Storage）默认启用：Android 10（API 29）开始强制推行分区存储机制，APP仅能访问自身专属的外部存储目录（/Android/data/[包名]/）和系统公共媒体目录，无法像Android 9及以下版本那样自由访问外部存储根目录或其他APP的私有目录。
• 旧存储路径失效：之前依赖Environment.getExternalStorageDirectory()等API获取的外部存储路径，在Android 10+中无法执行写入操作，这正是触发SQLiteCantOpenDatabaseException（错误码14）的核心原因——系统拒绝了对非授权路径的访问请求。
• 常规存储权限受限：Android 11（API 30）及以上版本，即便申请了READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限，也仅能访问公共媒体文件，无法操作非媒体类文件或自定义目录；若要全量访问外部存储，需申请MANAGE_EXTERNAL_STORAGE特殊权限，但该权限需用户手动跳转系统设置开启，且Google Play对其使用场景审核极为严格，仅允许文件管理器、备份类等特定APP申请。

二、数据库创建问题的可行解决方案 #

方案1：迁移至APP专属外部存储目录（推荐） #

这是最贴合系统规范的方案，无需额外特殊权限，代码修改成本低：

// 替换旧的存储路径，使用APP专属外部目录
String dbDirPath = getExternalFilesDir(null) + "/db";
File dbDir = new File(dbDirPath);
// 先确保目录存在
if (!dbDir.exists()) {
    dbDir.mkdirs();
}
// 初始化数据库
String dbPath = dbDirPath + "/mydb.db";
MyDatabaseHelper dbHelper = new MyDatabaseHelper(this, dbPath, null, 1);

该目录下的文件会随APP卸载自动清除，无需担心残留文件，且无需申请额外存储权限。

方案2：临时兼容Android 10（过渡方案） #

若暂时不想修改存储路径，可在AndroidManifest.xml的<application>标签中添加以下属性：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

注意：该属性仅在Android 10（API 29）生效，Android 11及以上版本会被系统忽略，无法继续使用旧存储逻辑，仅适合临时过渡。

方案3：申请全存储访问权限（特殊场景） #

如果你的APP属于文件管理器、数据备份等必须全量访问外部存储的类型，可按以下步骤操作：

1. 在AndroidManifest.xml中添加权限声明：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

2. 代码中引导用户开启权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        intent.setData(Uri.parse("package:" + getPackageName()));
        startActivityForResult(intent, 1001);
    }
}

此方案需严格遵循Google Play的权限政策，非必要场景不建议使用。

三、错误码14的额外排查点 #

• 确认已申请READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限（访问公共媒体目录时需要，访问APP专属目录无需）；
• 检查存储路径拼写是否正确，确保目录创建代码执行成功，避免因目录不存在导致数据库无法创建。

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