如何在Spring JPA中将实体关联对象的属性映射为数据库列

你不需要把这个对象设为独立实体，应该用**嵌入式类（Embeddable）**来实现需求——它能让对象的属性直接嵌入到主实体对应的数据库表中，而不是生成单独的表。

步骤1：定义嵌入式类 #

把你要嵌入的对象类加上@Embeddable注解，不需要@Entity或主键注解：

import jakarta.persistence.Embeddable;

@Embeddable
public class UserProfile {
    private String phone;
    private Integer age;
    private String address;

    // 无参构造器、getter/setter 必须提供，JPA需要
    public UserProfile() {}

    // 带参构造器（可选）
    public UserProfile(String phone, Integer age, String address) {
        this.phone = phone;
        this.age = age;
        this.address = address;
    }

    // getter和setter方法
    public String getPhone() { return phone; }
    public void setPhone(String phone) { this.phone = phone; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public String getAddress() { return address; }
    public void setAddress(String address) { this.address = address; }
}

步骤2：在主实体中嵌入该类 #

在主实体类里，用@Embedded注解标记这个嵌入式类的属性：

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Embedded;

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;

    // 嵌入UserProfile类的属性
    @Embedded
    private UserProfile profile;

    // 无参构造器、getter/setter
    public User() {}

    public User(Long id, String username, String email, UserProfile profile) {
        this.id = id;
        this.username = username;
        this.email = email;
        this.profile = profile;
    }

    // getter和setter方法
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    public UserProfile getProfile() { return profile; }
    public void setProfile(UserProfile profile) { this.profile = profile; }
}

步骤3：处理列名冲突（可选） #

如果嵌入式类的属性名和主实体的属性名重复，或者你想自定义嵌入式属性对应的数据库列名，可以用@AttributeOverrides和@AttributeOverride来指定：

@Entity
public class User {
    // ... 其他属性

    @Embedded
    @AttributeOverrides({
        @AttributeOverride(name = "phone", column = @Column(name = "user_phone")),
        @AttributeOverride(name = "address", column = @Column(name = "user_address"))
    })
    private UserProfile profile;

    // ... getter/setter
}

这样生成的user表会包含id、username、email、phone、age、address（或自定义的列名）这些字段，完全符合你把对象属性当作主实体自身属性映射的需求。

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