Spring Boot Feign Client插入含斜杠ID到Elasticsearch报错解决方案

问题核心是ID中的斜杠被URL解析器当成了路径分隔符，导致请求路径被错误拆分。以下是两种可行的解决方式：

1. 利用Feign的自动URL编码（推荐） #

Spring Cloud OpenFeign默认会对@PathVariable参数进行URL编码，但如果你的配置或版本存在异常，可以通过以下方式确保编码生效：

方式1：显式开启PathVariable编码 #

在Feign接口的@PathVariable注解中添加encoded = true属性（适用于部分旧版本Feign）：

@FeignClient(name = "esClient", url = "${es.host}")
public interface EsFeignClient {
    @PostMapping("/{index}/{id}")
    void insertDocument(
        @PathVariable("index") String index,
        @PathVariable(value = "id", encoded = true) String id,
        @RequestBody Object document
    );
}

方式2：检查Feign全局配置 #

确保你的配置文件中没有禁用路径编码，避免以下配置：

# 禁止配置此项，会导致斜杠不被编码
feign.client.config.default.decode-slash=true

2. 手动对ID进行URL编码 #

如果自动编码不生效，可在调用Feign接口前手动编码ID：

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;

// 调用前处理ID
String rawId = "ee5z4d5/54zd15zd/5zd45";
String encodedId = URLEncoder.encode(rawId, StandardCharsets.UTF_8);

// 传入Feign接口调用
esFeignClient.insertDocument("your-index", encodedId, yourDocument);

Elasticsearch会自动将编码后的%2F解码回斜杠，最终存储的ID仍为原始的带斜杠字符串。

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