如何实现软删除：将deleted字段设为true而非物理删除用户数据

首先解决你当前的报错问题：你在Repository自定义的delete方法中，@Query里使用了:u作为参数名，但方法参数是userEntity且未添加@Param注解绑定参数名，导致Spring Data JPA无法匹配参数，所以抛出错误。不过更规范的软删除实现可以按以下步骤来：

1. 确保实体类中存在软删除字段 #

先在UserEntity中添加deleted字段，默认值设为false：

@Entity
@Table(name = "user") // 替换为你的实际表名
public class UserEntity {
    // 其他字段...
    
    @Column(name = "deleted", nullable = false, columnDefinition = "boolean default false")
    private Boolean deleted = false;

    // 对应的getter和setter方法
    public Boolean getDeleted() {
        return deleted;
    }

    public void setDeleted(Boolean deleted) {
        this.deleted = deleted;
    }
}

2. 优化Service层的删除逻辑（推荐方式） #

不需要在Repository中重写delete方法，直接在Service中修改实体的deleted字段后保存，逻辑更直观：

@Override
public void deleteUser(String id) {
    UserEntity userEntity = userRepository.findById(Integer.valueOf(id))
            .orElseThrow(() -> new UserNotFoundException("Id not found"));
    if (userEntity.getLastAccessDate() == null) {
        throw new ProhibitedScimTypeException("Broken policy");
    }
    // 设置软删除标记
    userEntity.setDeleted(true);
    // 保存更新后的实体
    userRepository.save(userEntity);
}

3. 自动过滤已删除数据（关键步骤） #

为了避免查询时返回已软删除的用户，在UserEntity上添加@Where注解，让JPA自动给查询语句加上过滤条件：

@Entity
@Where(clause = "deleted = false") // 全局过滤已删除数据
public class UserEntity {
    // ... 字段和方法
}

这样调用findById、findAll等默认查询方法时，都会自动排除deleted = true的数据。

4. 若需高效批量/单条软删除（可选） #

如果不想先查询实体再更新，可以在Repository中定义专门的软删除方法，注意添加@Modifying和@Param注解：

public interface UserRepository extends JpaRepository<UserEntity, Integer> {
    @Modifying
    @Query("update UserEntity u set u.deleted = true where u.id = :id")
    void softDeleteById(@Param("id") Integer id);
}

然后在Service层直接调用userRepository.softDeleteById(Integer.valueOf(id))即可，省去查询实体的步骤，性能更优。

关于你之前的报错修复 #

如果一定要保留你原来的Repository自定义delete方法，需要修正参数绑定：

@Modifying
@Query("update UserEntity u set u.deleted = true where u = :userEntity")
void delete(@Param("userEntity") UserEntity userEntity);

必须添加@Modifying注解（因为是更新操作），同时用@Param绑定参数名，让查询语句中的:userEntity和方法参数对应。

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