Hibernate JPA命名规则修正：移除下划线及映射异常排查

一、核心问题原因解析 #

1. 父类id字段被添加子类前缀user_profile_id #

Hibernate默认的隐式命名策略（如ImplicitNamingStrategyLegacyJpaImpl）处理继承关系时，会自动为@MappedSuperclass或单表继承父类的字段添加子类实体名称前缀，目的是避免多表继承场景下的字段命名冲突。如果你的BaseModel标注了@MappedSuperclass，默认策略就会把子类名UserProfile拼接到父类id字段前，生成user_profile_id。

2. loginCount转为蛇形命名login_count #

这是JPA/Hibernate的默认命名转换行为：默认物理命名策略会将Java字段的驼峰式命名转换为数据库的蛇形命名（小写+下划线分隔）。你配置的PhysicalNamingStrategyStandardImpl本身不做驼峰转蛇形，但如果存在配置残留、依赖中包含其他命名策略（如Spring Boot的SpringPhysicalNamingStrategy），或者ImplicitNamingStrategy的配置间接触发了转换，仍会出现该现象。

二、自定义命名策略后MySQL报错的根源 #

你遇到的Field 'login_count' doesn't have a default value错误，核心是MySQL大小写配置与Hibernate字段命名不匹配：

• AWS Aurora MySQL默认开启lower_case_table_names=1，会将所有表名、字段名转换为小写存储。
• 自定义命名策略生成了LoginCount驼峰式字段名，Hibernate生成SQL时使用该名称，但MySQL实际存储的是login_count（自动转小写）。
• 这种映射不匹配导致Hibernate以为操作的是LoginCount字段，而MySQL中实际存在的是login_count，最终插入时login_count字段未被赋值，触发NOT NULL无默认值的报错。

三、分步解决方案 #

方案1：统一命名策略，适配MySQL大小写规则 #

放弃自定义驼峰字段名，改用与MySQL兼容的蛇形命名，同时保证父类id映射为id：

1. 自定义PhysicalNamingStrategy实现：

public class CustomPhysicalNamingStrategy extends PhysicalNamingStrategyStandardImpl {
    @Override
    public Identifier toPhysicalColumnName(Identifier name, JdbcEnvironment context) {
        // 父类id字段直接返回"id"
        if ("id".equalsIgnoreCase(name.getText())) {
            return Identifier.toIdentifier("id");
        }
        // 其他字段将驼峰转蛇形（小写）
        String snakeCase = CaseFormat.UPPER_CAMEL.to(CaseFormat.LOWER_UNDERSCORE, name.getText());
        return Identifier.toIdentifier(snakeCase);
    }
}

2. 配置Hibernate使用该策略：

<property name="hibernate.implicit_naming_strategy" value="org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl"/>
<property name="hibernate.physical_naming_strategy" value="com.yourpackage.CustomPhysicalNamingStrategy"/>

3. 确保数据库表结构的字段为id和login_count，可通过hibernate.hbm2ddl.auto=update自动同步，或手动生成DDL。

方案2：显式指定字段名（最直接） #

如果不想修改命名策略，直接在实体类字段上用@Column显式指定数据库字段名：

@MappedSuperclass
public class BaseModel {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id") // 显式指定字段名
    private Long id;
    // getter/setter
}

public class UserProfile extends BaseModel {
    @Column(name = "login_count") // 显式指定蛇形字段名
    private Integer loginCount;
    // 其他字段
}

这种方式直接绕过隐式转换逻辑，避免命名不匹配问题。

方案3：强制MySQL区分大小写（不推荐） #

修改Aurora MySQL的lower_case_table_names参数为2（仅适用于Linux系统，需重启实例），让MySQL保留字段名大小写。但该方式会增加运维复杂度，可能引发兼容性问题，不建议生产环境使用。

四、验证步骤 #

1. 重启应用，查看Hibernate生成的SQL语句，确认字段名与数据库实际字段一致。
2. 检查数据库表结构，确保id和login_count字段存在，且login_count的NOT NULL约束有合理默认值（或代码中保证插入时赋值）。

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