快捷導(dǎo)航

Mybatis-Plus updateById方法更新無效及空值處理過程

更新時(shí)間：2025年07月15日 09:41:18 作者：秋分的秋刀魚

MyBatis-Plus的updateById默認(rèn)不更新null值以防止誤操作,可通過UpdateWrapper/LambdaUpdateWrapper顯式設(shè)置,或全局配置、注解@TableField允許字段更新為空,需根據(jù)業(yè)務(wù)場(chǎng)景選擇合適方式

1. 使用UpdateWrapper并設(shè)置setSqlSelect

通過 UpdateWrapper 可以靈活地控制更新的字段，包括允許更新為 null。

import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;

// 假設(shè)有一個(gè)實(shí)體類 User
User user = new User();
user.setId(1); // 需要更新的記錄ID
user.setName(null); // 需要更新為空的字段
user.setAge(30);

UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", user.getId())
             .set("name", user.getName()) // 允許 name 字段更新為 null
             .set("age", user.getAge());

int rows = userMapper.update(null, updateWrapper);
System.out.println("受影響的行數(shù): " + rows);

2. 使用LambdaUpdateWrapper并調(diào)用set方法

LambdaUpdateWrapper 提供了類型安全的更新方式，同樣可以設(shè)置字段為 null。

import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;

User user = new User();
user.setId(1);
user.setName(null); // 需要更新為空的字段
user.setAge(30);

LambdaUpdateWrapper<User> lambdaUpdate = new LambdaUpdateWrapper<>();
lambdaUpdate.eq(User::getId, user.getId())
           .set(User::getName, user.getName()) // 允許 name 字段更新為 null
           .set(User::getAge, user.getAge());

int rows = userMapper.update(null, lambdaUpdate);
System.out.println("受影響的行數(shù): " + rows);

3. 全局配置允許更新空值

如果項(xiàng)目中多處需要更新空值，可以在 Mybatis-Plus 的全局配置中開啟 updateStrategy，允許字段更新為 null。

mybatis-plus:
  global-config:
    db-config:
      update-strategy: not_null # 默認(rèn)值，可以設(shè)置為 'ignore' 以允許更新 null

或者在代碼中進(jìn)行配置：

import com.baomidou.mybatisplus.annotation.DbConfig;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 其他攔截器配置
        return interceptor;
    }

    @Bean
    public DbConfig dbConfig() {
        return new DbConfig();
    }
}

注意：全局配置會(huì)影響所有的更新操作，需謹(jǐn)慎使用。

4. 使用UpdateStrategy注解

在實(shí)體類的字段上使用 @TableField 注解，并設(shè)置 updateStrategy 為 FieldStrategy.IGNORED，以允許該字段在更新時(shí)接受 null 值。

import com.baomidou.mybatisplus.annotation.FieldStrategy;
import com.baomidou.mybatisplus.annotation.TableField;

public class User {
    
    private Long id;
    
    @TableField(updateStrategy = FieldStrategy.IGNORED)
    private String name; // 允許更新為 null
    
    private Integer age;

    // getters and setters
}

5. 檢查實(shí)體類的屬性和數(shù)據(jù)庫字段映射

確保實(shí)體類中的屬性名稱與數(shù)據(jù)庫表中的字段名稱一致，且類型匹配。

如果存在不一致，可能導(dǎo)致更新無效。

6. 確認(rèn)事務(wù)是否生效

如果在一個(gè)事務(wù)中進(jìn)行更新操作，確保事務(wù)已正確提交。

未提交的事務(wù)不會(huì)對(duì)數(shù)據(jù)庫產(chǎn)生影響。

import org.springframework.transaction.annotation.Transactional;

@Service
public class UserService {

    @Transactional
    public void updateUser(User user) {
        userMapper.updateById(user);
    }
}