Feign踩坑源码分析 -- 请求参数分号变逗号

源码仓库:Gitee·GitHub

一.案例

1.1.Post请求:

http://localhost:8250/xx/task/test json格式参数: { "string": "a;b;c;d" }

1.2.controller代码:

@Autowired DataSourceClientService dataSourceClientService; @RequestMapping("/test") @ResponseBody public void test(@RequestBody String string) { System.out.println(string); String result = dataSourceClientService.test(string); System.out.println(result); }

1.3.feign代码:

@FeignClient( value = "zz") public interface DataSourceClientService { @RequestMapping(value = "/dataSource/test",method = RequestMethod.POST,produces = "text/plain;charset=UTF-8") String test(@RequestParam("str") String str); }

1.4服务提供方代码:

@RequestMapping("/test") @ResponseBody public String test(@RequestParam String str) { System.out.println(str); String result = "success;"; return result; }

1.5发起请求后控制台打印结果:

请求方控制台: 用户[null]开始调用web接口:http://localhost:8250/xx/task/test { "string": "a;b;c;d" } 服务提供方控制台: 用户[null]开始调用web接口:http://localhost:8247/zz/dataSource/test { "string": "a,b,c,d" }

二.解决办法

2.1.在请求方对参数进行编码:

string = UriUtils.encode(string, StandardCharsets.UTF_8); String test = dataSourceClientService.test(string);

2.2.服务提供方@RequestParam改成@RequestBody;

三.分析

3.1.需求

服务提供方需要的字符串是包含“;”而不是“,”,因为实际传递的是一个JSONObject的字符串,导致JSONUtil.parse转换成对象失败,导致业务失败;

3.2请求方法参数@RequestParam而传参不加密

3.2.1 请求方源码探究

通过一步步debug代码调试,发现调用 dataSourceClientService.test(string) 是jdk动态代理,调用链接到

feign.ReflectiveFeign.FeignInvocationHandler#invoke

-->feign.SynchronousMethodHandler#invoke

-->feign.ReflectiveFeign.BuildTemplateByResolvingArgs#create

-->feign.ReflectiveFeign.BuildTemplateByResolvingArgs#resolve

-->feign.RequestTemplate#resolve(java.util.Map<java.lang.String,?>)

-->feign.template.QueryTemplate#expand

-->feign.template.QueryTemplate#queryString

static final String COLLECTION_DELIMITER = ";"; private String queryString(String name, String values) { if (this.pure) { return name; } /* covert the comma separated values into a value query string */ List<String> resolved = Arrays.stream(values.split(COLLECTION_DELIMITER)) .filter(Objects::nonNull) .filter(s -> !UNDEF.equalsIgnoreCase(s)) .collect(Collectors.toList()); if (!resolved.isEmpty()) { return this.collectionFormat.join(name, resolved, this.getCharset()).toString(); } /* nothing to return, all values are unresolved */ return null; }

从上面可以看到,一个参数字符串“a;b;c;d”被分割处理成了一个数组,然后重新组合成字符串(Collection)传递给服务提供方,服务提供方接收参数是一个string字符串,会用逗号给拼接成字符串。

也就是说,feign预设了使用者如果是用传参带了分号过来的,会认为你传的是Collection,而不是String。

3.2.1 服务提供方源码探究

下面是服务提供方接收的参数详情:

org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver#resolveArgument

从上面可以看出,请求解析出来是一个字符串数组,在

org.springframework.core.convert.support.CollectionToStringConverter#convert 中用逗号拼接起来:

3.2.1 调用服务提供方方法前参数编码:

当没有编码前,org.springframework.core.convert.support.GenericConversionService#convert(java.lang.Object, org.springframework.core.convert.TypeDescriptor, org.springframework.core.convert.TypeDescriptor) 调用链进入的是org.springframework.core.convert.support.CollectionToStringConverter#convert 中用逗号拼接起来,因为参数类型是字符串数组

当编码后,进入的是org.springframework.core.convert.support.GenericConversionService.NoOpConverter#convert,直接返回字符串:

参数值的获取在org.springframework.web.method.annotation.RequestParamMethodArgumentResolver#resolveName 中

参数的解码方法在org.apache.tomcat.util.http.Parameters#processParameters(byte[], int, int, java.nio.charset.Charset)中进入

在org.apache.tomcat.util.http.Parameters#urlDecode进行解码

前面的是参数进行编码后解码,因为编码成一个字符串,所以解码的也是字符串,当没有进行编码,传递的会认为是一个collection,所以会遍历解码:

然后加入到数组中:

3.3请求方法参数改成@RequestBody

3.3.1服务提供方

当请求方法是@RequestBody时,获取参数在org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyMethodProcessor#resolveArgument:

直接从httprequest请求中获取body参数值:org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodArgumentResolver#readWithMessageConverters(org.springframework.http.HttpInputMessage, org.springframework.core.MethodParameter, java.lang.reflect.Type)

3.3.2请求方

参数直接封装到body中:

feign.ReflectiveFeign.BuildTemplateByResolvingArgs#create

--> feign.ReflectiveFeign.BuildEncodedTemplateFromArgs#resolve

对比3.2.1流程会发现,body不会进行字符串的切割,当然拉,也跟参数的请求类型不一致有关,一个是query,一个是body,下面是3.2.1流程

-->feign.ReflectiveFeign.BuildTemplateByResolvingArgs#create

-->feign.ReflectiveFeign.BuildTemplateByResolvingArgs#resolve

-->feign.RequestTemplate#resolve(java.util.Map<java.lang.String,?>)

-->feign.template.QueryTemplate#expand

-->feign.template.QueryTemplate#queryString

四.扩展

4.1.get请求

get请求的参数类型是query,所以走的是3.2.1流程,所以string的传参中包含“;”也会被转换成“,”;

@FeignClient( value = "zz") public interface DataSourceClientService { @RequestMapping(value = "/dataSource/testGet",method = RequestMethod.GET,produces = "text/plain;charset=UTF-8") String testGet(@RequestParam("str") String str); } @RequestMapping(value = "/testGet") @ResponseBody public String testGet(String str) { System.out.println(str); String result = "success"; return result; } 服务提供方控制台输出: 用户[null]开始调用web接口:http://localhost:8247/zz/dataSource/testGet a,b,c,d

ps:当请求参数字符串存在特殊符号比如“+”时,会被转义为空格

http://localhost:8250/xx/task/test2?string=a+b 请求方控制台输出: 用户[null]开始调用web接口:用户[null]开始调用web接口:http://localhost:8250/xx/task/test2 a b

通过debug调试发现当发起请求时在org.springframework.web.method.support.InvocableHandlerMethod#invokeForRequest中获取参数:

继续调用链:

-->org.springframework.web.method.support.HandlerMethodArgumentResolverComposite#resolveArgument

-->org.springframework.web.method.annotation.AbstractNamedValueMethodArgumentResolver#resolveArgument

-->org.springframework.web.method.annotation.RequestParamMethodArgumentResolver#resolveName

-->org.springframework.web.context.request.ServletWebRequest#getParameterValues

-->org.apache.catalina.connector.RequestFacade#getParameterValues

-->org.apache.catalina.connector.Request#getParameterValues

-->org.apache.coyote.Request#getParameters

从上面可以得知参数在parameters中,并且特殊符号已经被处理过了,那接下来找下什么时候放进来和怎么被处理的;在org.apache.catalina.connector.Request中看见了parseParameters方法,可以看出是对参数的解析方法,在里面打下断点重新跑下:

从下面可以看出这里是真正进行参数解析处理的:

org.apache.tomcat.util.http.Parameters#handleQueryParameters:

-->org.apache.tomcat.util.http.Parameters#processParameters(org.apache.tomcat.util.buf.MessageBytes, java.nio.charset.Charset)

-->org.apache.tomcat.util.http.Parameters#processParameters(byte[], int, int, java.nio.charset.Charset)

-->org.apache.tomcat.util.http.Parameters#urlDecode

从上面可以看到,是在进行解码时将“+”去除掉的;

继续debug发现在下面的代码中,可以清晰的看到对“+”替换成空格;

-->org.apache.tomcat.util.buf.UDecoder#convert(org.apache.tomcat.util.buf.ByteChunk, boolean)

解决办法为:

1)对参数“a+b”进行编码;

2)改成post请求;

4.2.header参数

在网上看见一篇文章,在这里收藏下《FeignClient传入的header中带逗号引发的401问题》

五.总结

1.@RequestParam参数的";"会被QueryTemplate#queryString进行分割组成Collection字符串;
然后在服务提供方CollectionToStringConverter#convert 中用逗号拼接起来;
2.当没有编码前进入的是CollectionToStringConverter#convert,当编码后进入的是GenericConversionService.NoOpConverter#convert;
3.参数值的获取在RequestParamMethodArgumentResolver#resolveName 中;
4.@RequestBody获取参数在RequestResponseBodyMethodProcessor#resolveArgument中,直接从body中读取然后返回;
5.请求参数字符串存在特殊符号比如“+”时,在参数编码过程中UDecoder#convert会被转义为空格;

相关新闻

MIPI D-PHY一致性测试失败排查:从CTS规范到Layout与调参的工程实践

MIPI D-PHY一致性测试失败排查:从CTS规范到Layout与调参的工程实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/19 14:43:09 阅读更多 →
UE5零基础3D平台游戏蓝图实战:从零到可玩Demo完整流程

UE5零基础3D平台游戏蓝图实战:从零到可玩Demo完整流程

Unreal Engine 5 零基础 3D 平台游戏蓝图实战&#xff1a;从零到可玩 Demo 的完整流程很多刚接触 Unreal Engine 5 的朋友&#xff0c;第一反应是打开引擎看到满屏面板就开始发懵&#xff1a;世界大纲是什么&#xff1f;关卡蓝图和角色蓝图有什么区别&#xff1f;为什么照着视频…

2026/11/19 18:52:46 阅读更多 →
数显差压变送器校验全流程:从原理到实操的工程指南

数显差压变送器校验全流程:从原理到实操的工程指南

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/18 0:24:37 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年&#xff0c;我大部分时间都在跟浏览器标签页打交道&#xff0c;直到第一次把桌面应用跑起来&#xff0c;才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词&#xff0c;最开始是在某段时间频繁出现在同事的讨论里&#xff0c;一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档&#xff0c;主要面向智能锁安装人员、终端用户及售后维护者&#xff0c;帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件&#xff0c;大小4.37MB&#xff0c;内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统&#xff0c;整车要求空载跑到8m/s&#xff0c;电机转速已经拉到额定点&#xff0c;驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令&#xff0c;转速纹丝不动&#xff0c;三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年&#xff0c;用它写过嵌入式驱动、做过游戏服务端&#xff0c;也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词&#xff0c;我其实挺感慨的——这门语言的难点从来不是语法多&#xff0c;而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书以PDF格式发布&#xff0c;适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开&#xff0c;先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能&#xff0c;再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历&#xff1a;翻开源码注释、论文摘要或者一份专业报告&#xff0c;每个字都认识&#xff0c;连在一起却像天书。想找人聊聊&#xff0c;身边要么没人懂&#xff0c;要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型&#xff0c;几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻