本文详解如何使用@column(name = "xxx")注解将数据库中与java字段名不一致的列正确映射到jpa实体类，尤其适用于继承结构下父类字段映射失效的场景。
在Spring Boot + JPA开发中，数据库表列名（如 user_name、created_at）常采用下划线命名法，而Java实体类字段（如 userName、createdAt）遵循驼峰命名规范。若未显式指定映射关系，JPA 默认按字段名推导列名（如 userName → user_name），但该行为依赖于PhysicalNamingStrategy配置，且在复杂场景（如字段位于父类、自定义SQL查询、视图映射）下易失效，导致字段为null。
此时，应使用@Column注解显式声明列名，确保映射精准可靠：
@Entity
@Table(name = "users")
public class User {
@Id
private Long id;
// 数据库列为 'full_name'，Java字段为 'name'
@Column(name = "full_name")
private String name;
// 数据库列为 'acct_status'，Java字段为 'status'
@Column(name = "acct_status")
private String status;
// 若字段在父类中（如 BaseEntity 中的 'created_at'）
// 同样需在父类字段上标注 @Column
}✅ 关键要点：
- @Column(name = "...") 必须直接标注在目标字段上（即使该字段定义在父类中），不可仅依赖getter/setter或构造器赋值；
- 父类字段若参与JPA映射，父类也应标注@MappedSuperclass（而非@Entity），并确保子类能继承其映射元数据；
- 避免在业务逻辑中手动通过setter“补救”映射失败——这违背ORM设计原则，且在懒加载、代理对象等场景下极易出错；
- 若涉及复杂查询（如@Query原生SQL），仍需配合@SqlResultSetMapping或@ConstructorResult保证列到字段的显式绑定。
? 进阶提示：
对于全局统一的列名转换规则（如全部下划线转驼峰），可配置spring.jpa.hibernate.naming.physical-strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy（Spring Boot 2.6+默认启用），但显式@Column始终具有最高优先级，推荐在关键字段上保留，以增强代码可读性与健壮性。
