Spring JPA是否存在直接执行UPSERT的内置方法？

Spring Data JPA本身没有提供开箱即用的UPSERT方法（即直接发送单条UPSERT语句到数据库的方法），但可以通过以下几种方式实现需求：

1. 自定义原生SQL查询（推荐） #

利用@Query注解结合原生SQL编写UPSERT语句，不同数据库的UPSERT语法略有差异，以下是常见数据库的示例：

示例：MySQL（ON DUPLICATE KEY UPDATE） #

假设你有一个User实体，主键为id：

@Entity
public class User {
    @Id
    private Long id;
    private String username;
    private String email;
    // getter、setter、构造方法
}

在Repository接口中添加自定义UPSERT方法：

public interface UserRepository extends JpaRepository<User, Long> {

    @Modifying
    @Query(value = "INSERT INTO user (id, username, email) VALUES (:id, :username, :email) " +
                   "ON DUPLICATE KEY UPDATE username = :username, email = :email",
           nativeQuery = true)
    void upsertUser(@Param("id") Long id, 
                    @Param("username") String username, 
                    @Param("email") String email);
}

示例：PostgreSQL（ON CONFLICT DO UPDATE） #

@Modifying
@Query(value = "INSERT INTO user (id, username, email) VALUES (:id, :username, :email) " +
               "ON CONFLICT (id) DO UPDATE SET username = :username, email = :email",
       nativeQuery = true)
void upsertUser(@Param("id") Long id, 
                @Param("username") String username, 
                @Param("email") String email);

调用该方法时，会直接向数据库发送单条UPSERT语句，无需先执行查询。

2. 使用EntityManager执行原生SQL #

如果需要更灵活的控制，可以通过EntityManager手动执行原生UPSERT语句：

@Autowired
private EntityManager entityManager;

public void upsertUser(Long id, String username, String email) {
    String sql = "INSERT INTO user (id, username, email) VALUES (?, ?, ?) " +
                 "ON DUPLICATE KEY UPDATE username = ?, email = ?";
    entityManager.createNativeQuery(sql)
                 .setParameter(1, id)
                 .setParameter(2, username)
                 .setParameter(3, email)
                 .setParameter(4, username)
                 .setParameter(5, email)
                 .executeUpdate();
}

注意事项 #

• 不同数据库的UPSERT语法不同，需要根据使用的数据库调整SQL语句；
• 使用@Modifying注解时，需要确保方法所在的类被Spring管理，且如果在事务外调用，可能需要手动开启事务；
• Spring Data JDBC（区别于JPA）在2.0+版本提供了@Upsert注解，但该特性不属于Spring Data JPA范畴。

内容的提问来源于stack exchange，提问作者Sk Monjurul Haque