Spring Boot项目中如何在Entity实体类中映射关联数据库视图

DevOps 小满

2026-10-7

Spring Boot JPA 实体类映射数据库视图解决方案

JPA 映射数据库视图和映射普通物理表的逻辑完全一致，只需要按以下步骤修改你的代码即可：

第一步：修正视图定义（原代码存在拼写+逻辑问题）

你提供的视图SQL存在两处问题，先修正避免后续查询报错：

CREATE VIEW customers_view AS
SELECT
    -- 这里的customer_id作为唯一主键使用
    c.id AS customer_id,
    c.firstname,
    c.lastname,
    -- 子查询加LIMIT 1避免单个客户多个订单时返回多行报错
    (SELECT o.ordernumber FROM orders o
     WHERE o.customer_id = c.id
     ORDER BY o.id DESC LIMIT 1) AS ordernumber
FROM customers c

注意：原SQL中的custoumer为拼写错误，已修正为customer

第二步：修改实体类代码

你的原有实体类存在字段重复定义、冗余主键字段、没有指定映射视图名等问题，修改后代码如下：

import org.hibernate.annotations.Immutable;
import jakarta.persistence.*;
import lombok.*;

@Entity
// 指定映射的视图名称
@Table(name = "customers_view")
// 加Immutable注解标记该实体为只读，Hibernate不会执行更新、插入操作，避免报错同时优化性能
@Immutable
@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
public class CustomerInformation {

    // 用视图中唯一的customer_id作为主键，删除原有不存在于视图的id字段
    @Id
    @EqualsAndHashCode.Include
    @Column(name = "customer_id")
    private Long customerId;

    @Column(name = "firstname")
    private String firstname;

    @Column(name = "lastname")
    private String lastname;
    
    @Column(name = "ordernumber")
    private String orderNumber; 
}