Hibernate自动修改主键与外键引发报错，求排查解决

我正在开发一个在线投票系统，需求是根据用户提供的键查询对应数据返回客户端，同时接收客户端POST请求更新vote表及candidate表的vote_count列。但运行时Hibernate试图修改candidates表的constituency_id字段，由于该字段被外键约束candidates_ibfk_1限制，导致报错。我不希望Hibernate执行这类修改，附上相关控制器、实体类代码及错误日志，请求排查问题。

控制器代码 #

package com.onlinevoting.leadiconbackend.Controller;

import com.onlinevoting.leadiconbackend.Entity.Candidate;
import com.onlinevoting.leadiconbackend.Services.CandidateService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/candidates")
public class CandidateController {

    @Autowired
    private CandidateService candidateService;

    // 根据选区ID获取候选人列表的接口
    @GetMapping("/{constituencyId}")
    public List<Candidate> getCandidatesByConstituency(@PathVariable String constituencyId) {
        return candidateService.getCandidatesByConstituency(constituencyId);
    }
}

实体类代码 #

@Entity
@Table(name = "candidates")
@JsonIgnoreProperties({"constituency.state.constituencies"})
public class Candidate {
    @Id
    @Column(name="candidate_id")
    @JsonProperty("candidateId")
    private String candidateId;
    @Column(name="candidate_name")
    @JsonProperty("candidateName")
    private String candidateName;

    @Column(name="constituency_id")
    @JsonProperty("constituencyId")
    private String constituencyId;

}

@Entity
@Table(name = "constituencies")
public class Constituency {

    @Id
    @Column(name = "constituency_id")
    private String constituencyId;

    @Column(name = "constituency_name")
    private String constituencyName;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "state_id")
    private State state;
}

@Entity
@Table(name = "votes")
public class Vote {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "vote_id")
    private Long voteId;

    @Column(name = "voter_ip")
    private String voterIp;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "candidate_id")
    private Candidate candidate;

}

错误日志 #

plementation: [org.hibernate.engine.transaction.jta.platform.internal.NoJtaPlatform]
Hibernate: 
    alter table candidates
       modify column constituency_id  varchar(255)
2023-09-11T17:44:16.566+05:30  WARN 14708 --- [           main] o.h.t.s.i.ExceptionHandlerLoggedImpl     : GenerationTarget encountered exception accepting command : Error executing DDL "
    alter table candidates
       modify column constituency_id  varchar(255)" via JDBC [Cannot change column 'constituency_id': used in a foreign key constraint 'candidates_ibfk_1']

org.hibernate.tool.schema.spi.CommandAcceptanceException: Error executing DDL "
    alter table candidates
       modify column constituency_id  varchar(255)" via JDBC [Cannot change column 'constituency_id': used in a foreign key constraint 'candidates_ibfk_1']

问题原因及解决方法 #

原因分析 #

Hibernate尝试修改constituency_id字段的核心原因有两点：

1. DDL自动同步策略：如果spring.jpa.hibernate.ddl-auto配置为update（默认值），Hibernate启动时会对比实体类定义与数据库表结构，自动执行DDL语句同步。你的Candidate实体中constituencyId的定义（如字段长度、类型）与数据库实际字段不匹配，触发Hibernate执行修改操作。
2. 外键约束限制：constituency_id作为外键关联constituencies表，修改该字段会触发数据库外键约束检查，导致操作被拒绝。

解决步骤 #

1. 禁用Hibernate自动DDL修改

直接修改配置，禁止Hibernate自动执行DDL操作：

# application.properties
spring.jpa.hibernate.ddl-auto=none

或在application.yml中：

spring:
  jpa:
    hibernate:
      ddl-auto: none

该配置会彻底阻止Hibernate修改数据库结构，从根源解决问题，也是生产环境的推荐配置。

2. 对齐实体与数据库字段定义

如果需要保留update策略，需确保实体类字段定义与数据库完全一致：

• 查看数据库中candidates.constituency_id的类型、长度、是否可空等属性。
• 在实体类@Column注解中明确指定这些属性，例如数据库字段为VARCHAR(50)且不可空：

@Column(name="constituency_id", length = 50, nullable = false)
@JsonProperty("constituencyId")
private String constituencyId;

这样Hibernate会认为结构匹配，不再执行ALTER语句。

3. 优化实体关联关系（可选）

如果后续需要建立实体关联，可将constituencyId字段改为@ManyToOne关联，并设置禁止修改外键：

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "constituency_id", updatable = false) // 禁止Hibernate修改该外键
@JsonProperty("constituencyId")
private Constituency constituency;

注意：此调整需要同步修改业务代码中对选区ID的处理逻辑。

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