Android Sqlite从v3迁移到v4报无此列错误 开发端无法复现仅Firebase捕获崩溃

问题背景 #

Android端SQLite数据库从版本3升级到版本4时出现线上崩溃，开发环境无法复现，仅在Firebase崩溃日志中上报。版本4引入了Room数据库替换原有原生SQLiteDatabase实现，因原部分表存在Room不支持的数据类型，迁移逻辑为：重命名原有旧表，创建符合Room要求的同名列新表，再将旧表数据拷贝到新表中。

崩溃日志 #

异常类型 #

android.database.sqlite.SQLiteException

堆栈信息 #

致命异常: f.a.x.d: subscribe()方法调用中缺少onError处理器，异常未被处理。 | android.database.sqlite.SQLiteException: 不存在的列: column15 (code 1): , 编译SQL时出错: INSERT INTO table_name (
_id,
column1 ,
column2 ,
column3 ,
column4 ,
column5 ,
column6 ,
column7 ,
column8 ,
column9 ,
column10 ,
column11 ,
column12 ,
column13 ,
column14 ,
<截断: 9039 字符>
at io.reactivex.internal.functions.Functions$OnErrorMissingConsumer.accept(Functions.java:704)
at io.reactivex.internal.functions.Functions$OnErrorMissingConsumer.accept(Functions.java:701)
at io.reactivex.internal.subscribers.LambdaSubscriber.onError(LambdaSubscriber.java:79)
... 其余堆栈省略

根因分析 #

1. 迁移逻辑列映射不完整：90%以上概率是你编写的从旧表拷贝数据到新表的SQL语句存在列不匹配问题。要么是旧版本v3表实际存在column15字段，但你写死的拷贝字段列表只写到column14，要么是新Room表未声明column15，但拷贝逻辑里带了这个字段。
   开发环境无法复现的核心原因是你测试用的v3版本都是最新打包的版本，而线上存在大量从更早期版本迭代升级上来的用户，这些用户的旧表结构和你本地测试用的v3表结构不一致。
2. Room实体与表结构不匹配：你定义的Room@Entity实体类中声明了column15字段，但创建新表的SQL或迁移逻辑中未新增该字段，导致Room自动生成的INSERT语句携带了不存在的列。
3. 迁移逻辑执行分支遗漏：存在部分用户跳过中间版本直接升级到v4，你的迁移逻辑未覆盖跨版本升级的场景，导致表结构变更未完整执行。

修复方案 #

• 优先补全RxJava的异常处理：所有RxJava的subscribe调用必须显式传入onError回调，哪怕仅做日志上报也可避免直接崩溃，同时可获取完整的未截断崩溃日志，确认完整INSERT语句的字段列表。
• 优化迁移拷贝逻辑：不要写死字段列表，通过PRAGMA table_info(旧表名)动态读取旧表的列集合，仅取新旧表共有的列做数据拷贝，示例SQL参考：

-- 明确指定所有需要拷贝的列，确保新旧表均存在这些字段
INSERT INTO target_table (_id, column1, column2, column3, ... , column15) 
SELECT _id, column1, column2, column3, ... , column15 FROM renamed_old_table;

• 新增线上表结构埋点：在迁移逻辑执行前，将当前用户的旧表结构上报到Firebase自定义事件，即可快速确认崩溃用户的旧表实际字段列表，定位列缺失原因。
• 覆盖全版本升级测试：拉取所有已对外发布的历史版本安装包，分别测试从各个历史版本直接升级到v4的流程，验证表结构变更和数据迁移的正确性。

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