SQLite中Upsert的使用：保留Status字段不变的实现问题

阿华AIGC实验室

2026-5-15

解决SQLite UPSERT时保留Status字段原有值的问题

我来帮你搞定这个问题！你的核心需求是在滚动列表时对SQLite表做UPSERT（存在则更新，不存在则插入），同时绝对不能修改Status字段的原有值——这正好戳中了INSERT OR REPLACE的一个小坑：它本质是先删除旧行再插入新行，如果新插入的语句里没指定Status，就会用默认值覆盖掉原来的值。

先分析你原语句的错误

你之前的SQL执行失败，主要原因是：

字段列表里没有包含STATUS字段，但VALUES末尾却加了一个获取STATUS的子查询，导致字段数量和值的数量不匹配，SQLite直接抛出语法错误。
直接拼接变量到SQL语句里，不仅容易引发语法错误（比如字符串字段没加单引号），还存在SQL注入风险。

方案一：修正`INSERT OR REPLACE`语句，保留原有Status

要让INSERT OR REPLACE不覆盖Status，你需要在字段列表里明确包含STATUS，并在VALUES中通过子查询获取原有值（如果是新记录，子查询返回NULL，这时候可以用COALESCE指定默认值）。

推荐用占位符?来拼接参数，避免语法错误和注入风险：

// 构造SQL语句，字段列表包含所有要更新的字段+STATUS
String upsertSql = "INSERT OR REPLACE INTO " + TABLE_NAME + "("
        + VIDEO_ID + ", " + VIDEOTITLE + ", " + VIDEO_TIME + ", "
        + VIDEO_VIEW + ", " + VIDEO_AMOUNT + ", " + VIDEO_THUMB + ", "
        + VIDEO_URL + ", " + VIDEO_DETAILS + ", " + YOUTUBE_KEY + ", " + STATUS + ")"
        + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, "
        + // 子查询获取原有Status，新记录则用默认值（替换成你的实际默认值即可）
        "COALESCE((SELECT " + STATUS + " FROM " + TABLE_NAME + " WHERE " + VIDEO_ID + " = ?), 'default_status')"
        + ")";

// 执行SQL，参数顺序要和占位符严格对应
db.execSQL(upsertSql, new Object[]{
        curr_id, videoTitle, videoTime, videoView,
        videoAmount, videoThumb, videoUrl, videoDetails,
        youtubeKey, curr_id
});

方案二：用`UPDATE + INSERT`实现更安全的UPSERT

INSERT OR REPLACE因为会删除旧行，可能带来一些潜在问题（比如触发删除触发器）。更稳妥的方式是先尝试更新已有记录，如果没有更新到任何行，再执行插入：

// 1. 先尝试更新已有记录（只更新需要的字段，完全不碰Status）
String updateSql = "UPDATE " + TABLE_NAME + " SET "
        + VIDEOTITLE + " = ?, " + VIDEO_TIME + " = ?, "
        + VIDEO_VIEW + " = ?, " + VIDEO_AMOUNT + " = ?, "
        + VIDEO_THUMB + " = ?, " + VIDEO_URL + " = ?, "
        + VIDEO_DETAILS + " = ?, " + YOUTUBE_KEY + " = ?"
        + " WHERE " + VIDEO_ID + " = ?";

db.execSQL(updateSql, new Object[]{
        videoTitle, videoTime, videoView, videoAmount,
        videoThumb, videoUrl, videoDetails, youtubeKey, curr_id
});

// 2. 检查是否有行被更新
if (db.getDatabase().getChanges() == 0) {
    // 没有更新到，说明是新记录，执行插入（Status会自动使用表定义的默认值）
    String insertSql = "INSERT INTO " + TABLE_NAME + "("
            + VIDEO_ID + ", " + VIDEOTITLE + ", " + VIDEO_TIME + ", "
            + VIDEO_VIEW + ", " + VIDEO_AMOUNT + ", " + VIDEO_THUMB + ", "
            + VIDEO_URL + ", " + VIDEO_DETAILS + ", " + YOUTUBE_KEY + ")"
            + " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)";
    
    db.execSQL(insertSql, new Object[]{
            curr_id, videoTitle, videoTime, videoView,
            videoAmount, videoThumb, videoUrl, videoDetails, youtubeKey
    });
}

这个方案的优势是：