Spring JPA创建外键约束报错：关联列数量不匹配

问题分析 #

你遇到的两个报错本质是同一问题：Hibernate生成的外键DDL未明确指定关联表的主键列，导致数据库判定外键列数与目标主键列数不匹配。结合代码和描述，核心原因分为两种可能：

1. 实体映射未显式指定外键关联的目标主键列，Hibernate默认生成的SQL缺失关键的主键列声明
2. 数据库中目标表（tbcadastro）实际为复合主键，但你的实体映射成了单主键，导致列数不匹配

解决方案 #

情况1：tbcadastro是单主键（codigo） #

直接在PedidoModel的fkCliente关联中，通过referencedColumnName明确指定目标主键列：

修改PedidoModel中的关联代码：

@ManyToOne
@JoinColumn(name = "fk_cliente", referencedColumnName = "codigo")
ClienteModel fkCliente;

同时修正PedidoModel中主键生成的冗余配置（@SequenceGenerator与IDENTITY策略冲突，IDENTITY依赖数据库自增，无需序列）：

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(name = "id_pedido", nullable = false)
int idPedido;

调整后Hibernate会生成你预期的DDL：

alter table tbpedidoentrega add constraint FKxxxx foreign key (fk_cliente) references tbcadastro (codigo)

情况2：tbcadastro是复合主键 #

如果数据库中tbcadastro确实为复合主键（比如codigo+empresa_id），需调整实体映射匹配复合主键结构：

1. 创建复合主键类：

@Embeddable
public class ClientePK implements Serializable {
    @Column(name = "codigo")
    int idCliente;
    @Column(name = "empresa_id")
    int empresaId;

    // 必须重写equals和hashCode以保证主键唯一性判断
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        ClientePK clientePK = (ClientePK) o;
        return idCliente == clientePK.idCliente && empresaId == clientePK.empresaId;
    }

    @Override
    public int hashCode() {
        return Objects.hash(idCliente, empresaId);
    }
}

2. 修改ClienteModel使用复合主键：

@Entity
@Getter
@Setter
@NoArgsConstructor
@Table(name = "tbcadastro")
public class ClienteModel implements Serializable {
    
    @EmbeddedId
    ClientePK id;
    
    // 其他字段保持不变...
}

3. 修改PedidoModel的关联，指定所有复合主键列：

@ManyToOne
@JoinColumns({
    @JoinColumn(name = "fk_cliente", referencedColumnName = "codigo"),
    @JoinColumn(name = "fk_empresa", referencedColumnName = "empresa_id")
})
ClienteModel fkCliente;

额外检查 #

确认JPA方言配置与数据库类型匹配，以PostgreSQL为例：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

内容的提问来源于stack exchange，提问作者Siri-Piell