Getter返回类型设为Optional的困境：外部REST服务JSON映射问题

看起来你在对接外部REST服务时，因为返回JSON里的date是可选字段，导致DTO的date属性可能为null，进而遇到了一些困扰。我来分享几个实用的解决方案，覆盖反序列化配置、业务逻辑处理和常见问题排查：

一、确保反序列化时可选Date字段正确映射为null #

假设你用的是Spring Boot默认的Jackson库，其实默认情况下，当JSON里没有date字段时，DTO的date会自动设为null，但如果遇到报错或者不符合预期的情况，可以这么调整：

1. 基础配置容错 #

在DTO类上添加@JsonIgnoreProperties(ignoreUnknown = true)注解，既能忽略JSON里DTO没有的额外字段，也能允许指定字段缺失，避免反序列化时抛出异常：

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import lombok.Data;
import java.util.Date;

@Data
@JsonIgnoreProperties(ignoreUnknown = true)
public class PublicationDto {
    private String title;
    private String tag;
    private Date date; // 可选字段，缺失时自动为null
}

2. 兼容多种Date格式 #

如果外部服务返回的date格式不固定（比如有时是时间戳，有时是字符串），可以用@JsonFormat注解做兼容，同时开启宽松模式，保证字段缺失时仍为null：

import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.OptBoolean;

// 示例：兼容时间戳和指定字符串格式，缺失时设为null
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss", lenient = OptBoolean.TRUE)
private Date date;

二、业务逻辑中优雅处理null的Date属性 #

直接在代码里写一堆if (date != null)会很繁琐，试试这些更优雅的方式：

1. 用Optional明确标记可选字段 #

修改DTO，把date包装成Optional<Date>，一眼就能看出这个字段是可选的，还能利用Optional的链式调用避免null判断：

import java.util.Optional;
import java.util.Date;
import lombok.Data;

@Data
public class PublicationDto {
    private String title;
    private String tag;
    private Optional<Date> date;
}

业务代码里这么用：

// 示例：如果date存在就格式化，否则返回默认文本
String displayDate = publicationDto.getDate()
    .map(date -> new SimpleDateFormat("yyyy-MM-dd").format(date))
    .orElse("未提供发布日期");

2. 给null的Date设置默认值 #

如果业务上允许，当date为null时可以设置默认值（比如当前时间），可以在DTO的构造方法或者业务层处理：

// DTO里加个自定义构造方法（配合Lombok的@NoArgsConstructor和@AllArgsConstructor）
@Data
@NoArgsConstructor
@AllArgsConstructor
public class PublicationDto {
    private String title;
    private String tag;
    private Date date;

    public PublicationDto(String title, String tag) {
        this.title = title;
        this.tag = tag;
        this.date = new Date(); // 没有date时用当前时间
    }
}

或者在业务服务里处理：

public Publication convertToEntity(PublicationDto dto) {
    Publication entity = new Publication();
    entity.setTitle(dto.getTitle());
    entity.setTag(dto.getTag());
    // Java 8+原生方法：如果date为null，用当前时间替代
    entity.setDate(Objects.requireNonNullElse(dto.getDate(), new Date()));
    return entity;
}

3. 用工具类避免空指针 #

如果不想改DTO，用工具类处理null也很方便，比如Java 8的Objects或者Apache Commons Lang的DateUtils：

// Java 8原生
Date safeDate = Objects.requireNonNullElse(dto.getDate(), new Date());

// Apache Commons Lang
Date safeDate = DateUtils.defaultIfNull(dto.getDate(), new Date());

三、常见问题排查 #

如果遇到“JSON里没有date，但DTO的date不是null”的情况，检查这两点：

• 有没有给DTO的date字段初始化值（比如private Date date = new Date();，这样就算JSON里没这个字段，也会有默认值）
• 检查Jackson的配置是否开启了严格模式，比如FAIL_ON_MISSING_CREATOR_PROPERTIES，如果开启了会在缺少字段时报错，需要在配置文件里关闭：

# Spring Boot application.yml
spring:
  jackson:
    deserialization:
      fail-on-missing-creator-properties: false

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