Spring Boot集成SQLite时唯一列创建异常求助

问题根源 #

你遇到的问题本质是Hibernate的增量表结构更新策略与SQLite的语法限制冲突：当spring.jpa.hibernate.ddl-auto设为update时，Hibernate会先检查表是否存在，再尝试用ALTER TABLE添加缺失的唯一约束，但SQLite仅支持重命名表、添加列等有限的ALTER操作，不支持直接添加唯一约束。而旧版SQLiteDialect未针对这个逻辑做适配，导致没有在表创建阶段直接生成约束。

可行解决方案 #

方案1：调整DDL生成策略（开发环境快速解决） #

将DDL自动生成策略改为create或create-drop：

spring.jpa.hibernate.ddl-auto=create

此模式下Hibernate会直接重建整张表，SQLiteDialect会在CREATE TABLE语句中直接声明word列的UNIQUE约束，完全绕开不支持的ALTER操作。

• 注意：create-drop会在应用关闭时删除表，仅适合开发测试；create每次启动都会删表重建，绝对不能用于生产环境。

方案2：使用Hibernate社区版SQLite方言（生产环境兼容首选） #

旧版org.hibernate.dialect.SQLiteDialect对SQLite特性支持不完善，Hibernate 6.x之后官方推荐使用社区维护的方言，它专门适配了SQLite的DDL语法，能在表创建阶段直接生成唯一约束，避免后续的ALTER操作尝试。

1. 添加Maven依赖（对应你的Hibernate版本）：

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-community-dialects</artifactId>
    <version>${hibernate.version}</version>
</dependency>

2. 配置方言：

spring.jpa.properties.hibernate.dialect=org.hibernate.community.dialect.SQLiteDialect

方案3：表级唯一约束声明（辅助优化） #

将字段级的unique=true替换为表级约束声明，让Hibernate更明确地生成约束逻辑：

@Entity
@Table(name = "my_entities", uniqueConstraints = {
    @UniqueConstraint(columnNames = "word", name = "UK_my_entities_word")
})
public class MyEntity {
    // 常规ID字段
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String word;

    // 其他字段及Getter/Setter
}

这种方式和字段级声明效果一致，但配合新版方言使用时，能进一步减少不必要的ALTER操作尝试。

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