Spring JPA save方法无法将数据存入数据库问题求助

问题描述 #

使用Spring JPA时调用save方法始终无法将数据存入数据库，严格按照书籍步骤开发但未得到预期结果，需要排查问题原因并解决。

代码实现 #

User实体类 #

@Data
@NoArgsConstructor(access=AccessLevel.PUBLIC, force=true)
@RequiredArgsConstructor
@Entity
@Table(name="user")
public class User implements UserDetails {

    @Id
    @GeneratedValue(strategy=GenerationType.AUTO)
    private Long id;
    
    @Column(name="username")
    private final String username;
    
    @Column(name="password")
    private final String password;
    
    
    @Override
    public Collection<? extends GrantedAuthority> getAuthorities() {
        return Arrays.asList(new SimpleGrantedAuthority("ROLE_USER"));
    }
    @Override
    public boolean isAccountNonExpired() {
        return true;
    }
    @Override
    public boolean isAccountNonLocked() {
        return true;
    }
    @Override
    public boolean isCredentialsNonExpired() {
        return true;
    }
    @Override
    public boolean isEnabled() {
        return true;
    }
    
}

Repository接口 #

public interface UserRepository extends JpaRepository<User,Long>{
}

注册接口实现 #

@PostMapping
@Transactional
public String registerprocess(@ModelAttribute Register reg,Model model,User user) {
    userRepo.save(reg.toUser(passwordEncoder));
    return "redirect:/login";
}

排查方向与解决办法 #

• 事务有效性检查：

  1. 确认控制器类已添加@Controller或@RestController注解，被Spring容器扫描管理；
  2. 建议将业务逻辑迁移至Service层，在Service方法上添加@Transactional注解，控制器层的事务管理可靠性低于Service层；
  3. 检查事务回滚规则：@Transactional默认仅在抛出RuntimeException时回滚，若代码中抛出非RuntimeException异常，需手动指定rollbackFor = Exception.class。

• 实体类与数据映射检查：

  1. 确认reg.toUser(passwordEncoder)方法是否正确调用User的带参构造器（由@RequiredArgsConstructor生成），传入有效的username和加密后的password；
  2. 检查数据库中user表是否存在，可通过设置spring.jpa.hibernate.ddl-auto=update让Hibernate自动更新表结构，避免因表不存在导致插入失败。

• 数据库配置检查：

  1. 核对application.properties/application.yml中的数据库URL、用户名、密码是否正确，确保应用能正常连接数据库；
  2. 确认数据库用户具备插入数据的权限。

• 日志排查：
  开启Spring Data JPA和Hibernate的DEBUG日志，查看是否生成并执行了插入SQL，是否有报错信息：

  logging.level.org.springframework.data.jpa=DEBUG
  logging.level.org.hibernate=DEBUG
  

• Repository实例检查：
  确认UserRepository被Spring正确实例化，可通过在控制器中注入时打印日志或调试断点验证，若未实例化需检查包扫描路径是否包含Repository所在包。

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