升级Spring Cloud Starter OpenFeign后is开头成员变量传参丢失问题

问题场景 #

将Spring Cloud Starter OpenFeign从2.2.9升级至3.0.2后，出现Kotlin数据类中以is开头的布尔成员变量，在Feign调用时从请求URL中消失的问题。

根因分析 #

• 2.2.9版本的Spring Cloud OpenFeign内置feign-core 10.12，默认用FieldQueryMapEncoder处理查询参数，该编码器直接读取类字段名，能完整保留isEmergency这类格式的参数名。
• 升级到3.0.2后，内置feign-core被降级到10.10.1，默认QueryMapEncoder变为PageableSpringQueryMapEncoder，最终委托给BeanQueryMapEncoder处理。
• BeanQueryMapEncoder遵循JavaBean规范，通过getter方法推断参数名：Kotlin中isEmergency字段生成的getter是isEmergency()而非getIsEmergency()，编码器会将其解析为emergency作为参数名，与预期的isEmergency不匹配，最终导致参数丢失。

复现示例 #

1. Kotlin数据类 #

data class EmergencyQuery(
    val isEmergency: Boolean,
    val keyword: String
)

2. Feign Client接口 #

@FeignClient(name = "emergency-service")
public interface EmergencyClient {
    @GetMapping("/api/emergencies")
    List<Emergency> queryEmergencies(@SpringQueryMap EmergencyQuery query);
}

3. 实际请求URL #

无论isEmergency设为true还是false，实际请求URL均为：
/api/emergencies?keyword=test
isEmergency参数完全缺失。

解决方案 #

方案一：自定义QueryMapEncoder，使用FieldQueryMapEncoder #

创建Feign配置类，指定使用原有的字段编码器：

@Configuration
public class FeignCustomConfig {
    @Bean
    public QueryMapEncoder queryMapEncoder() {
        return new FieldQueryMapEncoder();
    }
}

在Feign Client上关联该配置：

@FeignClient(name = "emergency-service", configuration = FeignCustomConfig.class)

方案二：给Kotlin字段指定JsonProperty #

通过注解强制指定参数名，让编码器正确识别：

import com.fasterxml.jackson.annotation.JsonProperty

data class EmergencyQuery(
    @JsonProperty("isEmergency")
    val isEmergency: Boolean,
    val keyword: String
)

方案三：手动升级feign-core版本 #

在pom.xml中显式指定feign-core版本为10.12+，覆盖Spring Cloud内置的降级版本（需注意版本兼容性）：

<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-core</artifactId>
    <version>10.12</version>
</dependency>

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