Spring Boot中应在哪里执行自定义SQL创建数据库enum枚举类型？

关于Session.createNativeQuery()方案的说明 #

你可以用这个方法执行创建语句，但不是最优选择，需要你自行处理幂等性逻辑，否则重复执行会直接抛出SQL异常。
如果你坚持要用这个方法，可将执行逻辑放在Spring容器初始化完成的回调位置，比如：

• 标注了@PostConstruct的启动类方法中
• 实现ApplicationListener<ContextRefreshedEvent>的监听器中
  执行前需要先查询数据库元数据表（以PostgreSQL为例查询pg_type表），确认status枚举类型不存在时再执行创建语句。

更优的替代方案（按易用性排序） #

方案1：使用Spring Boot原生初始化脚本（新手最友好） #

直接在src/main/resources目录下新建schema.sql文件，写入带幂等判断的创建语句：

CREATE TYPE IF NOT EXISTS status as ENUM ('completed', 'incomplete', 'removed');

然后在配置文件中添加如下配置：

# Spring Boot 2.x版本配置
spring.datasource.initialization-mode=always
# Spring Boot 3.x版本配置
# spring.sql.init.mode=always
# 建议关闭Hibernate自动DDL避免冲突
spring.jpa.hibernate.ddl-auto=none

Spring Boot启动时会自动执行该脚本，IF NOT EXISTS判断会保证语句仅在枚举不存在时生效，无需额外写Java代码。

方案2：使用数据库版本控制工具（生产环境推荐） #

可以用Flyway或Liquibase这类专门的数据库迁移工具，将创建枚举的SQL作为首个版本的迁移脚本存入指定目录，工具会自动记录脚本执行状态，保证同一条SQL仅会在首次启动时执行一次，后续所有表结构变更都可以通过这类工具统一管理，避免多环境数据库结构不一致的问题。

方案3：简化枚举映射逻辑（无需创建数据库枚举） #

如果你不想维护数据库层面的枚举类型，可以直接修改Java实体字段配置，将枚举映射为字符串存储：

@Enumerated(EnumType.STRING)
public Status status;

去掉原有@Column(columnDefinition = "status")配置即可，Hibernate会自动将枚举值以字符串形式存入VARCHAR类型字段，无需额外执行SQL创建数据库枚举，唯一缺点是数据库层面没有枚举值约束。

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