JPA关联报错：@OneToOne/@ManyToOne引用非实体接口User的解决办法

问题根源 #

JPA的@OneToOne/@ManyToOne注解仅支持关联标注了@Entity的实体类，无法直接识别接口类型。你的Instrument类关联了User接口，而JPA找不到对应的映射实体，因此抛出报错：

@OneToOne or @ManyToOne on Instrument.created references an unknown entity: user.User

可行解决办法 #

办法1：修改Instrument依赖具体实体类CommonUser #

这是最直接且符合JPA规范的方案，把Instrument中关联字段的类型从User替换为CommonUser，示例代码：

@Entity
public class Instrument {
    // 将原User类型改为CommonUser
    @ManyToOne
    private CommonUser created;
    
    // 其他字段与业务方法
}

这种方式无需额外配置，直接解决实体识别问题，代码逻辑清晰。

办法2：自定义属性转换器（需保留接口依赖时使用） #

如果业务上必须保留对User接口的依赖，可以通过JPA的@Convert注解实现接口到实体类的转换。由于你当前只有CommonUser一个实现类，这种方式可行：

1. 编写转换器类：

@Converter(autoApply = true)
public class UserConverter implements AttributeConverter<User, CommonUser> {
    @Override
    public CommonUser convertToDatabaseColumn(User user) {
        // 强制转换为唯一实现类
        return (CommonUser) user;
    }

    @Override
    public User convertToEntityAttribute(CommonUser dbEntity) {
        return dbEntity;
    }
}

2. 在Instrument类中关联User接口并指定转换器：

@Entity
public class Instrument {
    @ManyToOne
    @Convert(converter = UserConverter.class)
    private User created;
    
    // 其他字段与业务方法
}

注意：如果后续新增User接口的其他实现类，此方案会出现类型转换异常，需额外扩展逻辑。

结论 #

若无强制业务要求必须依赖User接口，优先选择办法1；若必须保留接口依赖，再考虑办法2的自定义转换器实现。

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