Spring Boot集成PostgreSQL用户新增POST请求500错误求助

使用Spring Boot和PostgreSQL开发Web应用，文章、黑胶记录模块的表单录入和Thymeleaf展示功能正常，但用户新增功能触发500错误，报错信息显示PostgreSQL中不存在my_user_seq序列。已为User实体添加@Table(name = "my_user")注解指定表名，且数据库字段类型与名称均核对正确，问题仍未解决。

错误栈 #

There was an unexpected error (type=Internal Server Error, status=500).
could not extract ResultSet; SQL [n/a]
org.springframework.dao.InvalidDataAccessResourceUsageException: could not extract ResultSet; SQL [n/a]
...
Caused by: org.postgresql.util.PSQLException: ERROR: relation"my_user_seq" does not exist
  Position: 16
...

相关代码 #

User实体类 #

package com.example.work.models;

import jakarta.persistence.*;

/**
 * @author Ivan 22.12.2022
 */

@Entity
@Table(name = "my_user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    private String name;
    private String surname;
    private String number;
    private String plate;

    public User(String name, String surname, String number, String plate) {
        this.name = name;
        this.surname = surname;
        this.number = number;
        this.plate = plate;
    }

    public User(){}

    // getter和setter方法
}

UserRepository #

package com.example.work.repositories;

import com.example.work.models.User;
import org.springframework.data.repository.CrudRepository;

/**
 * @author Ivan 22.12.2022
 */
public interface UserRepository extends CrudRepository<User, Long> {
}

UserController #

package com.example.work.controllers;

import com.example.work.models.User;
import com.example.work.repositories.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * @author Ivan 22.12.2022
 */

@Controller
public class UserController {
    @Autowired
    private UserRepository userRepository;

    @GetMapping("/userlist")
    public String userList(Model model){
        Iterable<User> users = userRepository.findAll();
        model.addAttribute("users", users);
        return "userlist";

    }

    @GetMapping("/user")
    public String user(){
        return "user";
    }

    @PostMapping("/adduser")
    public String newUser(@RequestParam String name, @RequestParam String surname, @RequestParam String number, @RequestParam String plate){
        User newUser = new User(name, surname, number, plate);
        userRepository.save(newUser);
        return "redirect:/userlist";
    }
}

解决方案 #

核心原因 #

GenerationType.AUTO在PostgreSQL环境下默认采用序列生成主键，JPA会自动将序列命名为[表名]_seq（即my_user_seq），但数据库中未创建该序列，或序列名称与JPA预期不匹配，导致报错。

具体解决方法 #

1. 手动创建序列
   登录PostgreSQL数据库，执行以下SQL创建对应序列并关联表主键：

   -- 创建序列
   CREATE SEQUENCE my_user_seq START 1 INCREMENT 1;
   -- 设置主键默认值为序列下一个值
   ALTER TABLE my_user ALTER COLUMN id SET DEFAULT nextval('my_user_seq');
   

2. 实体类中明确指定序列（推荐）
   修改User实体的主键注解，显式指定序列名称，避免JPA自动命名的不确定性：

   @Id
   @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "my_user_seq")
   @SequenceGenerator(name = "my_user_seq", sequenceName = "my_user_seq", allocationSize = 1)
   private Long id;
   

3. 检查数据库表主键类型
   确认my_user表的id字段类型为bigserial（PostgreSQL中该类型会自动生成对应序列），若之前手动建表时用了普通bigint类型，可修改字段类型：

   ALTER TABLE my_user ALTER COLUMN id TYPE bigserial;
   

4. 开发环境启用Hibernate自动建表
   在application.properties中添加配置，让Hibernate自动维护表结构和序列（仅开发环境使用）：

   spring.jpa.hibernate.ddl-auto=update
   

   注意：生产环境禁止使用update或create，防止数据丢失。

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