Spring Boot注册用户至MySQL失败：自动分配USER角色无数据存入

1. 先确认请求是否到达后端 #

• 检查注册表单的提交路径：如果是HTML表单，确认action属性（Thymeleaf用th:action="@{/register}"）和Controller的@PostMapping路径完全匹配，大小写、斜杠都不能错；同时确保表单的method是POST。
• 在Controller的注册方法第一行加硬编码日志：

  System.out.println("===== 收到注册请求，用户信息：" + user.getUsername());
  

  启动项目测试，如果控制台没输出，说明请求根本没到后端，重点排查路径匹配、表单提交方式。

2. 验证角色分配逻辑 #

• 确认角色对象正确关联到用户：如果Role是独立实体，不要每次注册都新建Role实例（会导致重复插入角色记录），应该先从数据库查询已存在的USER角色，再关联给用户：

  // Service层代码示例
  Role userRole = roleRepository.findByName("USER")
      .orElseGet(() -> {
          Role newRole = new Role();
          newRole.setName("USER");
          return roleRepository.save(newRole);
      });
  user.setRoles(Collections.singleton(userRole));
  

• 检查用户实体的roles集合是否正确映射（比如JPA的@ManyToMany注解配置是否完整，有没有加fetch策略、关联表设置）。

3. 排查数据库事务与保存逻辑 #

• 给Service层的注册方法添加@Transactional注解，确保数据库操作在事务中执行，避免数据未提交。
• 在Repository的save()调用前后加日志，确认方法是否执行：

  System.out.println("===== 准备保存用户：" + user.getUsername());
  User savedUser = userRepository.save(user);
  System.out.println("===== 保存完成，用户ID：" + savedUser.getId());
  

  如果只输出前一句，说明save()执行时抛出了异常但被吞掉了，继续往下查异常。

4. 捕获隐性异常 #

• 添加全局异常处理器，打印所有未处理异常的栈信息：

  @ControllerAdvice
  public class GlobalExceptionHandler {
      @ExceptionHandler(Exception.class)
      public String handleAllExceptions(Exception e) {
          e.printStackTrace();
          return "redirect:/register"; // 异常时跳回注册页，方便排查
      }
  }
  

• 调高高相关包的日志级别，在application.properties中添加：

  logging.level.org.springframework.web=DEBUG
  logging.level.org.hibernate=DEBUG
  logging.level.com.yourpackage=DEBUG # 替换成你的项目包名
  

  这样能看到Spring请求处理、Hibernate SQL执行的详细日志，比如SQL语句是否生成、参数是否正确。

5. 数据库基础配置检查 #

• 确认application.properties中的数据库配置正确：

  spring.datasource.url=jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC
  spring.datasource.username=root
  spring.datasource.password=your_pwd
  spring.jpa.hibernate.ddl-auto=update # 首次运行可以用create，之后改update
  

  启动日志中找HikariPool-1 - Start completed.，确认数据库连接池初始化成功；如果表没创建，检查ddl-auto是否设为none。

6. 跳转逻辑验证 #

• 检查Controller注册方法的返回值，确保是保存成功后才跳转到登录页：

  @PostMapping("/register")
  public String register(User user) {
      userService.registerUser(user); // 先执行保存逻辑
      return "redirect:/login"; // 保存成功再跳转
  }
  

  如果保存逻辑抛出异常但没有被捕获，代码依然会执行跳转，就会出现跳登录页但数据库无数据的情况。

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