dismiss404=true时，OpenFeign如何返回Optional<?>而非null？

核心结论 #

可以使用 Optional<?> 作为Feign客户端的返回类型，但默认解码器不会自动将服务返回的null转换为Optional.empty()，需要通过自定义解码器实现该逻辑。

问题原因 #

OpenFeign默认的解码器（如Spring环境下的SpringMvcDecoder）在处理返回值时，若服务返回null，会直接返回null而非包装成空Optional，导致声明Optional<AcmeDto>类型的方法实际返回null。

解决方案：自定义Optional感知解码器 #

通过实现一个解码器装饰器，对Optional类型的返回值做特殊处理，将null转为Optional.empty()，其他类型保持原有解码逻辑。

1. 实现自定义解码器

import feign.Response;
import feign.codec.Decoder;
import java.io.IOException;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.util.Optional;

public class OptionalAwareDecoder implements Decoder {

    private final Decoder delegate;

    public OptionalAwareDecoder(Decoder delegate) {
        this.delegate = delegate;
    }

    @Override
    public Object decode(Response response, Type type) throws IOException {
        // 判断返回类型是否为Optional
        if (type instanceof ParameterizedType) {
            ParameterizedType parameterizedType = (ParameterizedType) type;
            if (parameterizedType.getRawType().equals(Optional.class)) {
                // 解码泛型参数对应的实际类型
                Object decodedValue = delegate.decode(response, parameterizedType.getActualTypeArguments()[0]);
                // 空值转为Optional.empty()，非空值包装为Optional
                return decodedValue == null ? Optional.empty() : Optional.of(decodedValue);
            }
        }
        // 非Optional类型直接使用原解码器处理
        return delegate.decode(response, type);
    }
}

2. 配置Feign客户端使用自定义解码器

根据需求选择全局配置或单个客户端配置：

方式一：全局配置（所有Feign客户端生效）

创建Spring配置类注册自定义解码器：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import feign.codec.Decoder;
import org.springframework.cloud.openfeign.support.SpringMvcDecoder;
import org.springframework.web.client.RestTemplate;

@Configuration
public class FeignGlobalConfig {

    @Bean
    public Decoder feignDecoder(RestTemplate restTemplate) {
        return new OptionalAwareDecoder(new SpringMvcDecoder(() -> restTemplate.getMessageConverters()));
    }
}

方式二：单个客户端配置（仅目标Feign客户端生效）

在@FeignClient注解中指定专属配置类：

@FeignClient(
    name = "acme-service",
    url = "http://the-url",
    path = "/acme/",
    dismiss404 = true,
    configuration = AcmeFeignConfig.class
)
public interface AcmeServiceClient {
    @GetMapping("/{article}")
    Optional<AcmeDto> getArticle(@PathVariable final String article);
}

// 专属配置类
class AcmeFeignConfig {
    @Bean
    public Decoder feignDecoder(RestTemplate restTemplate) {
        return new OptionalAwareDecoder(new SpringMvcDecoder(() -> restTemplate.getMessageConverters()));
    }
}

3. 额外说明

• OpenFeign 13.5版本完全支持该自定义方案，无需升级版本。
• 配合dismiss404 = true配置时，服务返回404会被Feign转为null，自定义解码器会进一步将其转为Optional.empty()，符合预期行为。
• Optional<?>作为返回类型合法，只要泛型参数是可被解码器处理的DTO类型即可。

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