Android Studio中如何手动指定SQLite数据库文件存储路径？

迁移后表不存在的原因 #

项目通过Zip迁移时，主目录的SQLite数据库文件可能未被正确打包，或者新环境下App默认读取内部存储的空数据库，而非你指定的外部文件。

手动指定非默认数据库路径的两种方法 #

方法1：自定义SQLiteOpenHelper子类 #

重写SQLiteOpenHelper的路径相关方法，强制使用自定义目录：

public class CustomDBHelper extends SQLiteOpenHelper {
    private static final String DB_NAME = "your_db.db";
    // 自定义路径，示例为外部存储的应用专属目录
    private static final String CUSTOM_DIR = "/sdcard/your_app_data/";
    private Context mContext;

    public CustomDBHelper(Context context) {
        super(context, DB_NAME, null, 1);
        mContext = context;
    }

    @Override
    public File getDatabasePath(String name) {
        // 创建目录（不存在则创建）
        File dir = new File(CUSTOM_DIR);
        if (!dir.exists()) dir.mkdirs();
        return new File(dir, name);
    }

    @Override
    public SQLiteDatabase getWritableDatabase() {
        return SQLiteDatabase.openOrCreateDatabase(getDatabasePath(DB_NAME), null);
    }

    @Override
    public SQLiteDatabase getReadableDatabase() {
        return SQLiteDatabase.openOrCreateDatabase(getDatabasePath(DB_NAME), null);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        // 务必保留建表语句，确保首次运行或迁移后表能创建
        db.execSQL("CREATE TABLE IF NOT EXISTS your_table (id INTEGER PRIMARY KEY, content TEXT)");
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        // 数据库升级逻辑（按需实现）
    }
}

权限配置

如果使用外部存储路径，需在AndroidManifest.xml添加权限：

<!-- Android 10及以下 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<!-- Android 10+ 兼容旧存储逻辑 -->
<application
    ...
    android:requestLegacyExternalStorage="true">
</application>

Android 6.0及以上还需在代码中动态申请读写权限。

方法2：直接指定路径打开数据库 #

若无需SQLiteOpenHelper，可直接调用API打开指定路径的数据库：

String dbPath = "/storage/emulated/0/your_custom_folder/your_db.db";
File dbFile = new File(dbPath);
// 创建父目录
if (!dbFile.getParentFile().exists()) {
    dbFile.getParentFile().mkdirs();
}
// 打开或创建数据库
SQLiteDatabase db = SQLiteDatabase.openOrCreateDatabase(dbFile, null);
// 执行数据库操作

迁移后表不存在的快速修复 #

1. 确认原项目的SQLite数据库文件已复制到新电脑的自定义路径下
2. 卸载测试设备上的旧App，清除残留的空数据库后重新运行项目

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