使用Feign Client调用Outlook邮件接口时如何正确传递请求参数？

问题原因 #

你当前的Feign接口把$filter和$expand拼接成单个字符串作为filter参数的值，Feign会将整个字符串当做单个请求参数处理，因此URL里出现filter=编码后的完整字符串的格式，而非期望的多个独立参数。手动编码/解码无效的核心原因：Feign会自动对@RequestParam的参数值做URL编码，手动编码会引发双重编码；解码后Feign依然会把整个字符串作为单个参数值编码，无法拆分出多参数结构。

解决方案 #

方案1：拆分独立参数（推荐） #

将$filter和$expand拆分为两个独立的@RequestParam参数，Feign会自动处理参数编码并生成正确URL：

修改Feign接口：

@FeignClient(name = "email", url = "${BASE.URI}")
public interface EmailClient {

    @GetMapping("/mailfolders/Inbox/messages")
    EmailRequestNew getMessages(@RequestHeader HashMap<String, Object> headers,
                                @RequestParam("$filter") String filter,
                                @RequestParam("$expand") String expand);
}

调用时分别构造参数内容：

// 构造$filter的具体规则
String filterContent = "receivedDateTime ge " + from + " and receivedDateTime lt " + to;
// 构造$expand的具体规则
String expandContent = "singleValueExtendedProperties($filter=id+eq+'String+0x0070')";

// 调用Feign客户端
emailClient.getMessages(headers, filterContent, expandContent);

方案2：使用Map传递多参数 #

如果需要动态传递可变数量的参数，可以用Map<String, String>接收请求参数，Feign会自动将Map键值对解析为独立URL参数：

修改Feign接口：

@FeignClient(name = "email", url = "${BASE.URI}")
public interface EmailClient {

    @GetMapping("/mailfolders/Inbox/messages")
    EmailRequestNew getMessages(@RequestHeader HashMap<String, Object> headers,
                                @RequestParam Map<String, String> params);
}

调用时填充参数Map：

Map<String, String> params = new HashMap<>();
params.put("$filter", "receivedDateTime ge " + from + " and receivedDateTime lt " + to);
params.put("$expand", "singleValueExtendedProperties($filter=id+eq+'String+0x0070')");

// 调用Feign客户端
emailClient.getMessages(headers, params);

方案3：使用@QueryMap（OpenFeign原生注解） #

如果基于OpenFeign开发，可以用@QueryMap注解传递参数对象，需确保参数类字段名与URL参数名一致：

先定义参数类：

public class EmailParams {
    @JsonProperty("$filter")
    private String filter;
    @JsonProperty("$expand")
    private String expand;

    // 构造方法、getter、setter
}

修改Feign接口：

@FeignClient(name = "email", url = "${BASE.URI}")
public interface EmailClient {

    @GetMapping("/mailfolders/Inbox/messages")
    EmailRequestNew getMessages(@RequestHeader HashMap<String, Object> headers,
                                @QueryMap EmailParams params);
}

调用时实例化参数对象：

EmailParams params = new EmailParams();
params.setFilter("receivedDateTime ge " + from + " and receivedDateTime lt " + to);
params.setExpand("singleValueExtendedProperties($filter=id+eq+'String+0x0070')");

// 调用Feign客户端
emailClient.getMessages(headers, params);

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