Tomcat 出现Control character in cookie value or attribute异常解决方法-优快云博客

当Tomcat出现'Control character in cookie value or attribute'异常时，通常是由于Cookie中的中文或特殊符号导致编码不一致。该问题在Tomcat 8.5以下版本尤为常见。解决方法是对涉及的中文或特殊符号进行URLEncoder转码处理，以确保与服务器的编码兼容。在排查过程中，通过对比不同版本的Tomcat和Spring Boot，确认了问题与Tomcat版本的关联性。

【错误描述】
java.lang.IllegalArgumentException: Control character in cookie value or attribute.
at org.apache.tomcat.util.http.LegacyCookieProcessor.isV0Separator(LegacyCookieProcessor.java:748)
at org.apache.tomcat.util.http.LegacyCookieProcessor.processCookieHeader(LegacyCookieProcessor.java:545)
at org.apache.tomcat.util.http.LegacyCookieProcessor.parseCookieHeader(LegacyCookieProcessor.java:273)
at org.apache.catalina.connector.Request.parseCookies(Request.java:2995)
at org.apache.catalina.connector.Request.getServerCookies(Request.java:2010)
at org.apache.catalina.connector.CoyoteAdapter.parseSessionCookiesId(CoyoteAdapter.java:1208)
at org.apache.catalina.connector.CoyoteAdapter.postParseRequest(CoyoteAdapter.java:917)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:516)
at org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1096)
at org.apache.coyote.AbstractProtocol $A b s t r a c t C o n n e c t i o n H a n d l e r . p r o c e s s (A b s t r a c t P r o t o c o l . j a v a : 674) a t o r g . a p a c h e . t o m c a t . u t i l . n e t . N i o E n d p o i n t$ SocketProcessor.doRun(NioEndpoint.java:1500)
at org.apache.tomcat.util.net.NioEndpoint $S o c k e t P r o c e s s o r . r u n (N i o E n d p o i n t . j a v a : 1456) a t j a v a . u t i l . c o n c u r r e n t . T h r e a d P o o l E x e c u t o r . r u n W o r k e r (T h r e a d P o o l E x e c u t o r . j a v a : 1142) a t j a v a . u t i l . c o n c u r r e n t . T h r e a d P o o l E x e c u t o r$ Worker.run(ThreadPoolExecutor.java:617)
at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
at java.lang.Thread.run(Thread.java:745)

【原因分析】

Cookie中存在中文或特殊符号造成编码不一致，低版本tomcat（8.5以下）不支持

【解决方法】

对中文或特殊符号进行URLEncoder转码处理

【总结】

客户端反馈某账号调用接口出现500异常，其他账号正常，查看日志发现出现java.lang.IllegalArgumentException: Control character in cookie value or attribute异常，排查线上容器Tomcat版本为8.0.30，基本确定tomcat版本问题。本地测试使用springboot版本2.0.5.RELEASE，cookie传入中文正常，查看~/.m2/repository/org/springframework/boot/spring-boot-dependencies/2.0.5.RELEASE/spring-boot-dependencies-2.0.5.RELEASE.pom文件，tomcat版本为8.5.34，所以不存在异常。