Spring Boot REST API创建资源时序列负值、默认值未插入问题

我碰到了两个POST请求相关的问题，其他CRUD接口都正常：

1. 新建资源的响应中active字段为null，但我已经在schema.sql里给这个字段设置了默认值'Y'
2. 生成的ID是负值（比如-45），而不是预期的自增序列值（比如应该是4，因为已经有3条初始数据）

请求详情：

• POST端点：http://localhost:8080/client
• 请求体：

{ "clientName": "Walmart" }

• 异常响应：

{
  "clientName": "Walmart",
  "active": null, // 这里应该是'Y'
  "_links": {
    "self": {
      "href": "http://localhost:8080/client/-45" // 这里应该是4而不是-45
    },
    "client": {
      "href": "http://localhost:8080/client/-45"
    }
  }
}

相关代码 #

数据库脚本

schema.sql

CREATE SEQUENCE IF NOT EXISTS CLIENT_SEQ START WITH 1 INCREMENT BY 1;
CREATE TABLE IF NOT EXISTS CLIENT(
    CLIENT_ID BIGINT NOT NULL DEFAULT CLIENT_SEQ.NEXTVAL PRIMARY KEY,
    CLIENT_NAME VARCHAR(255) NOT NULL,
    ACTIVE CHAR(1) NOT NULL DEFAULT 'Y'
);

data.sql

INSERT INTO CLIENT(CLIENT_NAME) VALUES ('SPOTIFY');
INSERT INTO CLIENT(CLIENT_NAME) VALUES ('DAILY BURN');
INSERT INTO CLIENT(CLIENT_NAME) VALUES ('CREATIVE BUG');

JPA代码

ClientRepository.java

@RepositoryRestResource(path = "client")
public interface ClientRepository extends PagingAndSortingRepository<Client, Long> {
}

Client.java

@Entity
@Data
public class Client {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "client_id_generator")
    @SequenceGenerator(name = "client_id_generator", sequenceName = "client_seq")
    private Long clientId;
    private String clientName;
    private String active;
}

问题1：active字段为null的原因及修复 #

JPA在执行INSERT操作时，会把实体类中所有非null的字段都包含在INSERT语句里；如果字段是null，它会明确插入null，这会直接覆盖数据库字段的默认值。

你有三个修复选项：

选项1：在实体类中设置字段默认值

直接给active字段赋值默认值，新建实体时如果没有手动设置该字段，就会使用这个默认值：

private String active = "Y";

选项2：使用@PrePersist注解在保存前初始化

通过JPA的生命周期注解，在实体持久化到数据库前自动检查并设置默认值：

@Entity
@Data
public class Client {
    // ... 其他字段
    
    private String active;

    @PrePersist
    public void prePersist() {
        // 如果active为null，设置默认值'Y'
        if (this.active == null) {
            this.active = "Y";
        }
    }
}

选项3：让JPA忽略该字段的插入操作，使用数据库默认值

通过@Column注解告诉JPA不要在INSERT语句中包含active字段，这样数据库会自动应用预设的默认值：

@Column(name = "ACTIVE", insertable = false)
private String active;

问题2：序列生成负值的原因及修复 #

这个问题是因为JPA的序列生成器配置和数据库中的序列设置不匹配导致的。

Hibernate的@SequenceGenerator默认allocationSize为50（即预分配50个ID），而你的数据库序列设置的是INCREMENT BY 1。这种不匹配会导致Hibernate的ID生成逻辑混乱，甚至出现负数ID。

修复步骤：

1. 修改实体类的@SequenceGenerator，让它的参数和数据库序列完全匹配：

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "client_id_generator")
@SequenceGenerator(
    name = "client_id_generator",
    sequenceName = "client_seq",
    initialValue = 1,  // 和数据库START WITH一致
    allocationSize = 1 // 和数据库INCREMENT BY一致
)
private Long clientId;

2. 检查Spring Boot的JPA配置：
   确保spring.jpa.hibernate.ddl-auto的设置不会覆盖你的schema.sql配置。如果设置为create或update，Hibernate会根据实体类的注解自动创建/修改序列，所以必须保证注解参数和数据库脚本完全一致。

3. 重置数据库（可选）：
   如果之前的序列已经被Hibernate修改过，建议清空数据库并重新执行schema.sql和data.sql，确保序列从正确的初始值开始。

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