JPA查询报错Unknown column 'd1_0.id_ruolo'，求技术排查

错误原因分析 #

报错Unknown column 'd1_0.id_ruolo' in 'field list'的核心问题在于数据库表结构的双向外键设计不合理，加上JPA实体类的关联映射重复，导致框架生成SQL时错误地将数据库中驼峰命名的idRuolo列转换为下划线格式的id_ruolo，最终找不到对应字段。

你的数据库中dipendente和ruolo表互相设置了外键（dipendente.idRuolo关联ruolo.id，ruolo.idDipendente关联dipendente.id），这种双向外键在业务逻辑上不符合员工与角色的常规关系（通常是多员工对应单一角色），同时让JPA的关联映射逻辑产生混乱。

分步解决方法 #

1. 修正数据库表结构（推荐方案） #

以「多员工对应单一角色」的常规业务逻辑为例，删除ruolo表中多余的外键列和约束：

-- 删除ruolo表的外键约束
ALTER TABLE ruolo DROP FOREIGN KEY ruolo_ibfk_1;
-- 删除多余的idDipendente列
ALTER TABLE ruolo DROP COLUMN idDipendente;
-- 删除对应的索引
ALTER TABLE ruolo DROP INDEX idDipendente;

2. 修正JPA实体类映射 #

Dipendente实体（员工）

保留多对一关联到角色，删除多余的一对多关联属性：

package com.negozio.model;

import java.io.Serializable;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.JoinColumn;
import jakarta.persistence.Lob;
import jakarta.persistence.ManyToOne;
import jakarta.persistence.NamedQuery;

@Entity
@NamedQuery(name="Dipendente.findAll", query="SELECT d FROM Dipendente d")
public class Dipendente implements Serializable {
    private static final long serialVersionUID = 1L;

    @Id
    private int id;

    @Lob
    private String cognome;

    @Lob
    private String nome;

    // 多对一关联角色，明确指定数据库列名idRuolo
    @ManyToOne
    @JoinColumn(name="idRuolo")
    private Ruolo ruolo;

    public Dipendente() {
    }

    // 仅保留必要的getter/setter
    public int getId() { return this.id; }
    public void setId(int id) { this.id = id; }
    public String getCognome() { return this.cognome; }
    public void setCognome(String cognome) { this.cognome = cognome; }
    public String getNome() { return this.nome; }
    public void setNome(String nome) { this.nome = nome; }
    public Ruolo getRuolo() { return this.ruolo; }
    public void setRuolo(Ruolo ruolo) { this.ruolo = ruolo; }
}

Ruolo实体（角色）

保留一对多关联到员工，删除多余的多对一关联属性：

package com.negozio.model;

import java.io.Serializable;
import java.util.List;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.Lob;
import jakarta.persistence.NamedQuery;
import jakarta.persistence.OneToMany;

@Entity
@NamedQuery(name="Ruolo.findAll", query="SELECT r FROM Ruolo r")
public class Ruolo implements Serializable {
    private static final long serialVersionUID = 1L;

    @Id
    private int id;

    @Lob
    private String ruolo;

    // 一对多关联员工，关联字段对应Dipendente中的ruolo属性
    @OneToMany(mappedBy="ruolo")
    private List<Dipendente> dipendentes;

    public Ruolo() {
    }

    // 仅保留必要的getter/setter
    public int getId() { return this.id; }
    public void setId(int id) { this.id = id; }
    public String getRuolo() { return this.ruolo; }
    public void setRuolo(String ruolo) { this.ruolo = ruolo; }
    public List<Dipendente> getDipendentes() { return this.dipendentes; }
    public void setDipendentes(List<Dipendente> dipendentes) { this.dipendentes = dipendentes; }

    public Dipendente addDipendente(Dipendente dipendente) {
        getDipendentes().add(dipendente);
        dipendente.setRuolo(this);
        return dipendente;
    }

    public Dipendente removeDipendente(Dipendente dipendente) {
        getDipendentes().remove(dipendente);
        dipendente.setRuolo(null);
        return dipendente;
    }
}

3. 可选：修正JPA命名策略（不修改表结构时使用） #

如果暂时无法调整数据库结构，可以通过配置强制JPA使用指定的列名，避免自动转换驼峰为下划线：
在Spring Boot的application.properties中添加：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

验证 #

修改完成后重新运行查询员工列表的方法，JPA会生成正确的SQL语句，使用数据库中实际存在的idRuolo列，报错即可解决。

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