SQLite与Room ORM插入默认冲突策略及行为差异疑问

先回应你的疑问：你后来的发现是对的——SQLite和Room ORM的默认插入冲突策略都是ABORT，但两者的表现形式不同，这是因为Room对底层SQLite做了封装适配，下面详细拆解：

一、先纠正最初的猜测 #

你一开始以为“SQLite执行失败，Room忽略查询”是不准确的：

• SQLite不会默默失败，而是会抛出约束异常；
• Room也不会忽略查询，而是通过返回值告知插入失败，底层逻辑和SQLite的ABORT完全一致。

二、两者ABORT策略的核心语义（完全一致） #

不管是SQLite还是Room，ABORT的核心逻辑都是：

当插入操作违反约束（比如唯一键冲突、非空约束）时，立即终止当前插入语句的执行，回滚该语句带来的所有更改（注意：不是回滚整个事务，除非你是在事务中执行），数据库状态回到执行该语句之前的样子。

三、表现形式的差异（为什么看起来不一样） #

1. SQLite原生的ABORT行为 #

在原生SQLite中，执行违反约束的INSERT语句时，SQLite会直接抛出**SQLITE_CONSTRAINT异常**。比如在命令行执行：

INSERT INTO users (id, name) VALUES (1, 'Alice');
-- 再次执行相同id的插入，会报错：UNIQUE constraint failed: users.id

这种异常需要你主动捕获或处理，否则会中断程序流程。

2. Room的ABORT行为 #

Room作为Android平台的ORM框架，对SQLite的异常做了封装处理：

• 当你使用默认的@Insert注解（不指定onConflict参数）时，底层还是用SQLite的ABORT策略；
• 但Room会捕获SQLite抛出的约束异常，转而返回一个**-1的长整型值**给调用者，表示插入失败。

举个Room代码的例子：

@Dao
interface UserDao {
    // 默认使用ABORT策略，无需显式指定
    @Insert
    suspend fun insertUser(user: User): Long
}

// 调用时
val result = userDao.insertUser(User(1, "Alice"))
if (result == -1L) {
    // 插入失败，处理冲突逻辑
}

这种设计是为了贴合Android开发者的编码习惯——用返回值判断结果，比强制捕获异常更简洁友好，同时完全保留了ABORT策略的核心语义。

四、关于Room官方文档的疑问 #

你提到Room官方文档没明确说明默认冲突策略，其实这个默认值可以从@Insert注解的源码中看到：@Insert的onConflict参数默认值就是OnConflictStrategy.ABORT。官方文档可能因为这是“默认行为”，没有单独拿出来强调，但确实是ABORT没错。

总结 #

• 两者默认冲突策略完全一致：都是ABORT，核心是终止违规插入、不修改数据库；
• 差异仅在于对外暴露的方式：SQLite抛出异常，Room用返回值-1表示失败，本质是Room做了一层封装适配。

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