Room数据库中@PrimaryKey(autoGenerate = true)未自动生成主键问题

你遇到的问题是因为Room对Integer类型主键的自动生成逻辑有特殊要求，加上可能存在的数据库表结构未更新问题，导致插入时uid被当作0处理引发冲突。以下是具体解决办法：

一、改用int基本类型主键（最稳妥） #

将User实体中的uid类型从Integer改为int，Room对于int类型的主键，当值为0时会自动触发自增ID生成（前提是autoGenerate = true）：

@Entity
public class User {
    @PrimaryKey(autoGenerate = true)
    public int uid;

    @ColumnInfo(name = "first_name")
    public String firstName;

    @ColumnInfo(name = "last_name")
    public String lastName;
}

二、确保Integer类型主键插入时为null #

如果坚持用Integer类型，必须保证插入的User对象uid为null（Java中引用类型默认是null，但要避免不小心赋值为0）。可以在插入前打印验证：

User user = new User();
user.firstName = "Ste";
user.lastName = "Kor";
Log.d("Debug", "User uid before insert: " + user.uid); // 应输出null

只有当uid为null时，Room才会为Integer类型主键自动生成自增ID。

三、更新数据库版本（关键步骤） #

如果之前已经创建过数据库，修改@PrimaryKey注解后需要升级数据库版本，否则Room不会更新表的自增属性：

1. 修改Database类的版本号：

@Database(entities = {User.class}, version = 2) // 版本号+1
public abstract class DataBase extends RoomDatabase {
    public abstract UserDao userDao();
}

2. 若无需保留旧数据，添加破坏性迁移让Room重建数据库：

DataBase db = Room.databaseBuilder(getApplicationContext(), DataBase.class, "DB")
        .allowMainThreadQueries()
        .fallbackToDestructiveMigration()
        .build();

若需要保留数据，需编写Migration类手动修改表结构，为uid字段添加自增属性。

四、验证自动生成结果（可选） #

修改Dao的@Insert方法返回long类型，获取自动生成的主键ID，确认是否成功：

@Dao
public interface UserDao {
    // ... 其他方法
    @Insert
    long insert(User user); // 单个插入可以改名更直观
}

插入时获取返回值：

long generatedId = userDao.insert(user);
Log.d("Result", "自动生成的主键ID：" + generatedId);

返回值大于0则说明自动生成成功。

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