From: http://www.lichenliang.top/tomcat-8-invalid-character-cookie-value.html

問(wèn)題場(chǎng)景

之前運(yùn)行在 Tomcat 7 中的 Web 項(xiàng)目，當(dāng)把 Tomcat 從 7 升級(jí)到 8.x 及更高版本后，用戶登錄失敗，后臺(tái)報(bào)異常：

java.lang.IllegalArgumentException: An invalid character [xx] was present in the Cookie valueat org.apache.tomcat.util.http.Rfc6265CookieProcessor.validateCookieValue(Rfc6265CookieProcessor.java:162)at org.apache.tomcat.util.http.Rfc6265CookieProcessor.generateHeader(Rfc6265CookieProcessor.java:111)...

規(guī)范變化

Tomcat 8.x（ or later）版本進(jìn)了很多改進(jìn)，其中的 Cookie 處理也升級(jí)到 RFC6265 規(guī)范，這可能導(dǎo)致在 Tomcat 8 以前版本中運(yùn)行無(wú)問(wèn)題的Web項(xiàng)目在 Tomcat 8 中報(bào)下面錯(cuò)誤：

java.lang.IllegalArgumentException: An invalid character [34] was present in the Cookie value

上面的 [34] 中的 34 是指 ASCII 碼（十進(jìn)制）對(duì)應(yīng)的字符 “（雙引號(hào)）。那么在不明確知道 RFC6265 規(guī)范中 Cookie 值可用的字符時(shí)，可能在 Cookie 值使用其他字符也會(huì)出現(xiàn)上面的問(wèn)題。

那么下面就來(lái)看看到底哪些字符時(shí)不可用的。

查看源碼

private void validateCookieValue(String value) {int start = 0;int end = value.length();if (end > 1 && value.charAt(0) == '"' && value.charAt(end - 1) == '"') {start = 1;end--;}char[] chars = value.toCharArray();for (int i = start; i < end; i++) {char c = chars[i];if (c < 0x21 || c == 0x22 || c == 0x2c || c == 0x3b || c == 0x5c || c == 0x7f) {throw new IllegalArgumentException(sm.getString("rfc6265CookieProcessor.invalidCharInValue", Integer.toString(c)));}} }

Rfc6265CookieProcessor.validateCookieValue 源碼地址

通過(guò)上面這段源碼分析出 RFC6265 規(guī)范中 Cookie 值不可用的字符串，見(jiàn)下表：

十進(jìn)制十六進(jìn)制縮寫(xiě)/字符解釋

34	0x22	“	雙引號(hào)
44	0x2C	,	逗號(hào)
59	0x3B	;	分號(hào)
92	0x5C	\	反斜杠
127	0x7f	DEL (delete)	刪除（控制字符）
< 33	< 0x21	略	控制字符/通信專用字符/空格

問(wèn)題原因

Tomcat 8 更換默認(rèn)的 CookieProcessor 實(shí)現(xiàn)為 Rfc6265CookieProcessor ，之前的實(shí)現(xiàn)為 LegacyCookieProcessor 。前者是基于 RFC6265 ，而后者基于 RFC6265、RFC2109、RFC2616 。

解決方式

獨(dú)立的 Tomcat

修改配置文件 context.xml ，指定 CookieProcessor 為 org.apache.tomcat.util.http.LegacyCookieProcessor，具體配置如下：

<Context><CookieProcessor className="org.apache.tomcat.util.http.LegacyCookieProcessor" /> </Context>

SpringBoot 內(nèi)嵌 Tomcat 的解決方式

在 springboot 啟動(dòng)類中增加內(nèi)嵌 Tomcat 的配置 Bean，如下代碼：

@SpringBootApplication public class Application extends SpringBootServletInitializer {public static void main(String[] args) {SpringApplication.run(Application.class, args);}// Tomcat Cookie 處理配置 Bean@Beanpublic WebServerFactoryCustomizer<TomcatServletWebServerFactory> cookieProcessorCustomizer() {return (factory) -> factory.addContextCustomizers((context) -> context.setCookieProcessor(new LegacyCookieProcessor()));} }

參考資料：

Tomcat 8 CookieProcessor 實(shí)現(xiàn)變化
百度百科 ASCII

總結(jié)

以上是生活随笔為你收集整理的升级到 Tomcat 8 后 Cookie 可能出现的问题的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。