当数据库列名与 java 实体字段名不一致时，可通过 `@column(name = "xxx")` 显式指定列名映射，确保 jpa 正确绑定数据，尤其适用于继承结构或遗留数据库场景。
在 Spring Boot + JPA 开发中，常见场景是数据库使用下划线命名（如 user_name、created_at），而 Java 实体遵循驼峰命名规范（如 userName、createdAt）。若字段名不匹配且未显式声明映射关系，JPA 默认按字段名推导列名（如 userName → user_name 仅在启用 SpringNamingStrategy 时自动生效），但该策略不可靠，尤其在字段位于父类、存在继承关系或需精确控制时极易失效——正如提问中所述：子类无法通过 setter 正确设置父类字段，导致值为 null。
此时，最直接、可靠且符合 JPA 规范的解决方案是使用 @Column 注解显式绑定：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
@Entity
@Table(name = "users")
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
// 数据库列为 user_name，Java 字段为 userName
@Column(name = "user_name")
private String userName;
// 数据库列为 acct_status，Java 字段为 status
@Column(name = "acct_status")
private String status;
// 若字段在父类中（如 BaseEntity 定义 createTime）
// 同样需在父类字段上标注 @Column
}✅ 关键要点：
- @Column(name = "...") 必须标注在实际映射的字段上（即使该字段位于 @MappedSuperclass 父类中），而非仅依赖 setter；
- 不要试图在子类中重写父类字段或通过 setter 手动赋值——JPA 的 ORM 映射发生在反射注入阶段，绕过 setter 将导致字段始终为 null；
- 若使用 Lombok，确保 @Data / @Setter 不干扰 @Column 的生效（通常无冲突，但需避免 @Access(AccessType.PROPERTY) 等特殊配置）；
- 对于只读字段或需忽略的列，可配合 insertable = false, updatable = false 控制持久化行为。
? 进阶提示：
若项目中大量存在列名/字段名不一致问题，可全局配置 Hibernate 命名策略（如 spring.jpa.hibernate.naming.physical-strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy），但显式 @Column 始终优先级最高、语义最清晰、调试最友好，推荐作为首选实践。
