Spring Boot中如何通过PUT请求将字段值更新为Null？

你遇到的核心问题是MapStruct默认会忽略DTO中的null值，不会覆盖实体的已有字段，所以即使你在请求体里传"classID": null，映射后实体的classID依然保持原来的2，导致更新无效。以下是具体解决步骤：

1. 配置MapStruct允许null值覆盖实体字段 #

在你的MapStruct映射器接口中，针对updateFromDTO方法添加nullValuePropertyMappingStrategy配置，强制将DTO中的null值同步到实体：

@Mapper(componentModel = "spring")
public interface StudentMapper {

    // 全局配置：所有字段都允许null覆盖
    @Mapping(nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.SET_TO_NULL)
    void updateFromDTO(StudentDTO studentDTO, @MappingTarget Student student);
}

如果只需要针对classID字段单独配置，可以这样写：

@Mapper(componentModel = "spring")
public interface StudentMapper {

    @Mapping(target = "classID", nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.SET_TO_NULL)
    void updateFromDTO(StudentDTO studentDTO, @MappingTarget Student student);
}

注意：MapStruct版本不同，枚举值可能有差异，旧版本可能用NullValueMappingStrategy.NULL，请根据你的依赖版本调整。

2. 确保DTO的classID是包装类型 #

检查StudentDTO中的classID字段类型，必须是包装类（如Integer），不能是基本类型（int）。因为基本类型无法存储null，会被自动转换为默认值0，导致映射时无法识别为null：

// 正确写法
public record StudentDTO(Integer id, Integer classID) {}

// 错误写法（基本类型无法存null）
public record StudentDTO(int id, int classID) {}

3. 验证MySQL表结构 #

确认你的student表中classID字段允许为NULL，若字段设置了NOT NULL约束，即使代码层设置了null，数据库也会拒绝更新。可以用SQL查看或修改：

-- 查看表结构
DESCRIBE student;

-- 修改字段允许为NULL（如果需要）
ALTER TABLE student MODIFY COLUMN classID INT NULL;

4. 测试请求体 #

确保PUT请求的JSON体正确传递null：

{
  "id": 1,
  "classID": null
}

不要传空字符串""，因为空字符串会被解析为空字符串（如果DTO字段是String类型）或转换为0（如果是数值类型），无法触发null值映射。

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