使用JPA添加用户遇SQLGrammarException，@GeneratedValue失效求解决

核心原因 #

使用@GeneratedValue(strategy = GenerationType.IDENTITY)时，JPA（以Hibernate为实现）依赖数据库自增字段机制自动生成ID值。如果以下任一条件不满足，就会触发SQL语法错误：

• 数据库表的id字段未设置自增属性
• 实体类id类型与数据库字段类型不匹配
• Hibernate的数据库方言配置错误

具体排查与解决步骤 #

1. 检查并修正数据库表结构

IDENTITY策略要求主键字段必须是自增类型：

• MySQL：id字段需设为INT AUTO_INCREMENT PRIMARY KEY
• PostgreSQL：id字段用SERIAL或GENERATED AS IDENTITY
• Oracle：通常配合序列+触发器使用（更推荐SEQUENCE策略而非IDENTITY）

若你的users表id无自增属性，执行对应SQL修改：

-- MySQL示例
ALTER TABLE users MODIFY COLUMN id INT AUTO_INCREMENT PRIMARY KEY;

2. 核对实体类与数据库字段类型

确保实体类id类型和数据库字段完全匹配：

• 若数据库用BIGINT，实体类应改为Long类型（避免int溢出）
• 你的代码中id为int，对应数据库需为INT类型

3. 确认Hibernate方言配置

在JPA配置文件（如persistence.xml）或Spring Boot的application.properties中，设置正确的数据库方言：

# Spring Boot示例 - MySQL8
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

# Spring Boot示例 - PostgreSQL
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

你的代码参考 #

User实体类

package model;

import lombok.Getter;
import lombok.Setter;

import javax.persistence.*;

@Entity
@Getter
@Setter
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;

    private String firstName;
    private String lastName;
    private String userName;
    private String password;
}

添加用户方法

public CompletionStage<Result> addUser(Http.Request request) {
    JsonNode json = request.body().asJson();
    User user = Json.fromJson(json, User.class);
    return CompletableFuture.supplyAsync(
            () -> addUser1(user));
}

private static Result addUser1(User user) {
    return jpaApi.withTransaction(entityManager -> {
        try {
            entityManager.persist(user);
            return ok("User Added Successfully");
        } catch (Exception e) {
            return internalServerError("An Error occurred while adding user: " + e.getMessage());
        }
    });
}

API请求JSON

{
    "firstName": "Robin",
    "lastName": "karachri",
    "userName": "Robin",
    "password": "4563"
}

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