Android SQLite表创建失败求助：重复主键定义问题

嗨，我一眼就看出问题出在哪了——你的实体类字段注解冲突，导致生成的SQL语句里重复定义了id列，而且还都设成了主键，这肯定会让SQLite报错！

问题根源分析 #

你生成的SQL语句是：

CREATE TABLE IF NOT EXISTS `SeasonMasterDB` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `id` TEXT PRIMARY KEY AUTOINCREMENT, `name` TEXT );

这里出现了两个id列，原因是你的实体类里：

• Long id字段用了@PrimaryKey注解，默认会映射到表的id列（而且因为是Long类型，自动设为INTEGER AUTOINCREMENT主键）；
• 同时你给String idValue字段加了@Column(name = "id")，强制让它也映射到id列，这就造成了同一个列名重复定义，还都标记为主键，SQLite当然不允许这种情况。

两种可行的解决方案 #

根据你的业务需求选一种就行：

方案1：保留自增主键，修改字符串字段的列名

如果你需要一个自增的Long类型主键，同时还要存储一个字符串类型的ID值，只要把idValue的列名改成不重复的就行：

@Table(name = "SeasonMasterDB",database = AppDatabase.class) 
public class SeasonMasterDB extends Model { 
    @PrimaryKey 
    public Long id; // 自增主键，映射到表的`id`列
    @Column(name = "external_id") // 改成不重复的列名，比如external_id、id_str等
    public String idValue; 
    @Column(name = "name") 
    public String name; 

    public SeasonMasterDB() { }
    // 其他构造方法或业务逻辑...
}

这样生成的SQL会是正常的：

CREATE TABLE IF NOT EXISTS `SeasonMasterDB` (`id` INTEGER PRIMARY KEY AUTOINCREMENT, `external_id` TEXT, `name` TEXT );

方案2：用String类型作为主键（去掉自增）

如果你的业务不需要自增Long主键，而是想用String类型的值作为主键，那就要调整注解——注意SQLite的AUTOINCREMENT只支持INTEGER类型，String主键需要自己赋值：

@Table(name = "SeasonMasterDB",database = AppDatabase.class) 
public class SeasonMasterDB extends Model { 
    @PrimaryKey 
    public String id; // 直接用String作为主键，自己处理主键值
    @Column(name = "name") 
    public String name; 

    public SeasonMasterDB() { }
    // 其他构造方法或业务逻辑...
}

对应的SQL会变成：

CREATE TABLE IF NOT EXISTS `SeasonMasterDB` (`id` TEXT PRIMARY KEY, `name` TEXT );

最后一步：清理旧的数据库结构 #

修改完实体类后，记得要么卸载APP重新安装（清空旧的数据库文件），如果用的是Room等带版本管理的ORM，要更新数据库版本号并处理迁移，避免旧的表结构缓存导致问题。

如果还有业务上的特殊需求，比如主键的生成规则，随时补充细节我再帮你调整！

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