Android应用更新时如何完整替换旧SQLite数据库？

阿华AIGC实验室

2026-5-25

嘿，我懂你现在的需求——想在App更新时处理SQLite数据库的结构变更，同时还要和WebService实现自动同步对吧？不过先给你提个醒：完全替换旧数据库是绝对不可取的，这会直接清空用户之前存的离线数据，用户体验直接拉胯。正确的姿势是做数据库版本迁移，也就是在保留用户原有数据的前提下，增量更新数据库结构。下面给你一步步拆解具体操作：

一、核心原则：别直接替换，要增量迁移

直接替换数据库等于把用户之前的离线数据全删了，这绝对是用户不能接受的，咱们要做的是“改结构不丢数据”。

二、具体迁移步骤

1. 给数据库加版本号管理

首先，在你的数据库操作类里（比如Android的SQLiteOpenHelper、iOS的FMDB封装类），给数据库设置版本号。比如1.0版本的数据库版本号设为1，这次更新后版本号升到2。以后每次改数据库结构，都把版本号往上加。

2. 给旧表新增字段（用ALTER TABLE）

对于需要加字段的旧表，别删表重建，用SQLite的ALTER TABLE语句来新增字段，这样原有数据会保留。比如你有个topics主题表，要加个sync_time字段记录同步时间：

ALTER TABLE topics ADD COLUMN sync_time INTEGER DEFAULT 0;

放心，SQLite的ALTER TABLE支持新增列，完全满足你的需求。

3. 创建新表（用CREATE TABLE IF NOT EXISTS）

需要新增的表直接用CREATE TABLE语句创建，记得加IF NOT EXISTS，避免重复创建报错。比如建个sync_log表记录同步日志：

CREATE TABLE IF NOT EXISTS sync_log (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    sync_type TEXT,
    sync_time INTEGER,
    status INTEGER
);

4. 在升级回调里执行迁移逻辑

不同平台的实现细节不一样，但核心逻辑都是：当App检测到本地数据库版本低于新版本时，执行对应的迁移脚本。
举个Android的例子，在SQLiteOpenHelper里重写onUpgrade()方法：

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
    // 如果旧版本是1，需要升级到2
    if (oldVersion < 2) {
        // 给旧表加字段
        db.execSQL("ALTER TABLE topics ADD COLUMN sync_time INTEGER DEFAULT 0;");
        // 创建新表
        db.execSQL("CREATE TABLE IF NOT EXISTS sync_log (id INTEGER PRIMARY KEY AUTOINCREMENT, sync_type TEXT, sync_time INTEGER, status INTEGER);");
    }
}

iOS用FMDB的话，就打开数据库时先查版本号，版本不够就执行对应的SQL语句就行。