Hibernate生成SQLite表未添加自增主键，如何解决？

我为Spring Boot项目创建了JPA实体Country，代码如下：

@Getter
@Setter
@Entity
@Data
public class Country {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @Column(nullable = false)
    private String region;

    @Column(nullable = false)
    private String continent;
}

运行应用后生成了SQLite数据库文件，但查看发现country表的结构中未包含AUTOINCREMENT属性。生成的DDL语句如下：

CREATE TABLE "country" (
    "id"    INTEGER,
    "continent" varchar(255) NOT NULL,
    "name"  varchar(255) NOT NULL,
    "region"    varchar(255) NOT NULL,
    PRIMARY KEY("id")
);

我的application配置如下：

spring.datasource.url=jdbc:sqlite:./database.sqlite
spring.datasource.driver-class-name=org.sqlite.JDBC
spring.jpa.database-platform=org.hibernate.community.dialect.SQLiteDialect
spring.jpa.hibernate.ddl-auto=update
spring.jpa.properties.hibernate.hbm2ddl.auto=update
spring.jpa.show-sql=true

请问如何确保生成的表结构包含AUTOINCREMENT？

1. 先明确SQLite的自增逻辑 #

SQLite中，INTEGER PRIMARY KEY本身就具备自动递增特性，不需要显式添加AUTOINCREMENT。AUTOINCREMENT是可选约束，仅用于强制主键值永远不重用已删除行的ID；默认自增逻辑会重用这些ID。如果业务没有严格的ID不重用需求，当前表结构已经满足自增要求。

2. 若必须生成AUTOINCREMENT #

如果一定要让Hibernate生成带AUTOINCREMENT的DDL，可通过以下两种方式实现：

方式一：自定义SQLite方言

默认的SQLiteDialect不会生成AUTOINCREMENT，你可以自定义方言重写主键生成逻辑：

import org.hibernate.community.dialect.SQLiteDialect;
import org.hibernate.dialect.identity.IdentityColumnSupport;
import org.hibernate.dialect.identity.SQLiteIdentityColumnSupport;

public class CustomSQLiteDialect extends SQLiteDialect {
    @Override
    public IdentityColumnSupport getIdentityColumnSupport() {
        return new SQLiteIdentityColumnSupport() {
            @Override
            public String getIdentitySelectString(String table, String column, int type) {
                return "SELECT last_insert_rowid()";
            }

            @Override
            public String getIdentityColumnString(int type) {
                // 返回带AUTOINCREMENT的列定义
                return "INTEGER PRIMARY KEY AUTOINCREMENT";
            }
        };
    }
}

修改application配置中的方言路径：

spring.jpa.database-platform=com.yourpackage.CustomSQLiteDialect

方式二：在实体字段显式指定列定义

直接在id字段上通过@Column指定DDL：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(columnDefinition = "INTEGER PRIMARY KEY AUTOINCREMENT")
private Long id;

注意：建议将spring.jpa.hibernate.ddl-auto临时设置为create或create-drop测试（生产环境谨慎操作），因为update模式不会修改已存在的主键列定义。

3. 关键注意点 #

• AUTOINCREMENT会带来额外性能开销，仅在必须保证ID永不重用的场景下使用。
• 修改方言或字段定义后，需删除现有表或使用create模式重新生成，update模式无法更新已存在的主键约束。

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