Spring Entity配置关联后PostgreSQL报relation does not exist如何修复？

根因分析 #

出现该报错的核心原因是添加@ManyToOne关联后，subscriptions表创建失败，根本原因有三个：

1. PostgreSQL对标识符大小写敏感，默认会将未加双引号的表名、列名转为小写，原代码中列名使用驼峰命名userID、subscriptionID，和PostgreSQL自动转换后的userid、subscriptionid不匹配，导致创建外键约束时出错，subscriptions表创建中断，运行时就会报关系不存在的错误。
2. 原代码未显式指定外键关联的引用列，Hibernate自动匹配列名时容易出现匹配失败的问题。
3. GenerationType.AUTO在PostgreSQL中默认使用序列生成主键，部分场景下会和外键约束创建的顺序冲突。
   而删除关联后，表创建不需要外键校验，所以可以正常执行。

修复步骤 #

• 统一将表、列命名调整为小写下划线格式，适配PostgreSQL的大小写规则，同时显式指定@JoinColumn的referencedColumnName属性，明确关联的User主键列
• 主键生成策略替换为GenerationType.IDENTITY，适配PostgreSQL的自增主键逻辑
• 补全实体类的无参构造方法、Getter/Setter方法，这是JPA规范强制要求的，缺失会导致实体映射失败
• 可选：在配置文件中添加命名策略配置，自动实现驼峰转下划线命名，无需手动写全列名：

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

• 排查项：如果调整后还有问题，可添加spring.jpa.show-sql=true和spring.jpa.properties.hibernate.format_sql=true配置，打印建表SQL，定位具体的建表失败原因；同时检查连接配置是否指定了正确的schema，非public schema需要在@Table注解中显式声明schema属性。

修复后完整代码 #

User实体 #

import javax.persistence.*;

@Table(name = "users")
@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "user_id", nullable = false)
    private long userId;

    public User() {}

    public long getUserId() {
        return userId;
    }

    public void setUserId(long userId) {
        this.userId = userId;
    }
}

Subscription实体 #

import javax.persistence.*;

@Table(name = "subscriptions")
@Entity
public class Subscription {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "subscription_id", nullable = false)
    private long subscriptionId;

    @ManyToOne(optional = false)
    @JoinColumn(name = "user_id", referencedColumnName = "user_id", nullable = false)
    private User user;

    public Subscription() {}

    public long getSubscriptionId() {
        return subscriptionId;
    }

    public void setSubscriptionId(long subscriptionId) {
        this.subscriptionId = subscriptionId;
    }

    public User getUser() {
        return user;
    }

    public void setUser(User user) {
        this.user = user;
    }
}

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