Spring Boot中@Transactional无法持久化数据至表的问题

常见排查方向及解决方案 #

1. 实体类字段访问权限或Getter/Setter配置错误 #

• 实体类private字段必须配套Getter/Setter方法，JPA默认通过反射调用这些方法读写字段值；
• 也可以用@Access(AccessType.FIELD)注解指定字段级访问，无需Getter/Setter（更推荐字段级映射）。

示例修正后的实体类：

import javax.persistence.*;

@Entity
@Table(name = "user")
@Access(AccessType.FIELD) // 直接操作字段，无需Getter/Setter
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String username;
    private Integer age;
    
    // 若不用@Access，必须添加以下Getter/Setter
    // public String getUsername() { return username; }
    // public void setUsername(String username) { this.username = username; }
}

2. 请求参数与实体类字段名不匹配 #

• 检查Postman请求参数名和实体类字段名是否完全一致（区分大小写），不一致的话用@JsonProperty做映射。

示例：

import com.fasterxml.jackson.annotation.JsonProperty;

@Entity
public class User {
    // ...
    @JsonProperty("user_name") // 对应Postman中传入的user_name参数
    private String username;
}

3. 实体类与数据库列映射错误 #

• 确认@Column注解是否正确指定了列名，数据库列名和字段名不同时必须显式配置；
• 检查字段类型和数据库列类型是否匹配（比如Java String对应VARCHAR，Integer对应INT）。

示例：

@Column(name = "user_age", nullable = false)
private Integer age;

4. 事务配置细节问题 #

• @Transactional必须加在public方法上（Spring事务默认不作用于非public方法）；
• 确保Spring配置类上添加了@EnableTransactionManagement开启事务管理。

5. 请求数据未正确绑定到实体类 #

• 在Controller层打印接收的实体对象，确认参数是否正确传入：

@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;
    
    @PostMapping("/save")
    public ResponseEntity<?> saveUser(@RequestBody User user) {
        System.out.println("接收的用户数据：" + user); // 打印验证数据是否正确
        userService.save(user);
        return ResponseEntity.ok("保存成功");
    }
}

6. 查看JPA执行的SQL语句 #

• 开启SQL日志，确认INSERT语句是否携带字段值：
  在application.properties中添加：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

如果日志里的INSERT语句VALUES全是NULL，说明数据在进入JPA前就为空；如果有值但数据库没更新，大概率是字段映射问题。

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