Spring Boot向PostgreSQL插入带Enum角色的用户时报错求助

核心原因分析 #

错误提示「ERREUR: syntaxe en entrée invalide pour le type oid : « VENDEUR »」明确说明PostgreSQL正在尝试将字符串VENDEUR插入到OID类型的列中，而非你预期的VARCHAR列。这和你声明的数据库列类型矛盾，大概率是以下场景之一：

• 数据库role列实际类型为OID，而非VARCHAR（建表或迁移脚本写错）
• Spring Boot 3.x搭配的Hibernate 6.x对枚举的默认映射行为变化，导致注解配置被覆盖
• 实体类注解存在遗漏或错误，比如@Column错误指定了列类型

分步解决办法 #

1. 确认并修正数据库列类型 #

连接PostgreSQL执行查询，检查目标表的列类型：

SELECT column_name, data_type FROM information_schema.columns WHERE table_name = 'user';

如果role列的data_type是oid，执行修改语句：

ALTER TABLE "user" ALTER COLUMN "role" TYPE VARCHAR(255);

注意：若列中已有数据，需先确认数据兼容VARCHAR类型，或备份后再执行修改

2. 修正实体类映射注解 #

确保UserEntity中的角色字段注解明确且无冲突，示例代码：

public enum Role {
    ADMIN, VENDEUR, CLIENT
}

@Entity
@Table(name = "user")
public class UserEntity {
    // 其他字段...
    
    @Enumerated(EnumType.STRING)
    @Column(name = "role", nullable = false, columnDefinition = "VARCHAR(255)")
    private Role role;
    
    // getter/setter...
}

• 添加columnDefinition = "VARCHAR(255)"强制Hibernate按VARCHAR类型映射，规避Hibernate 6的默认行为干扰
• 若之前使用了Hibernate旧版本的@Type(type = "string")注解，直接移除即可，@Enumerated(EnumType.STRING)在Hibernate 6中已足够

3. 检查全局配置 #

查看application.properties/application.yml，移除或调整可能干扰枚举映射的配置：

• 比如spring.jpa.properties.hibernate.type.enum相关的全局规则，或spring.jpa.hibernate.naming.implicit-strategy的异常设置
• 确保没有强制将枚举映射为OID类型的配置项

4. 验证插入逻辑 #

确保插入用户时，角色字段直接赋值为枚举实例，而非手动转字符串：

UserEntity user = new UserEntity();
user.setRole(Role.VENDEUR);
userRepository.save(user);

Hibernate会自动处理枚举到字符串的转换，无需手动干预

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