升级到 Tomcat 8 后 Cookie 可能出现的问题

Tomcat 8 （ or later） 版本进了很多改进，其中的 Cookie 处理也升级到 RFC6265 规范，可能导致在 Tomcat 8 以前版本中运行无问题的Web项目在 Tomcat 8 中报下面错误：

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

上面的 [34] 也可能包的是别的 [xx]，主要因为 RFC6265 规范了 Cookie 值中可用的字符，使用了规范定义之外的字符 Tomcat 会报上面的错误。

问题原因

Tomcat 8 更换默认的 CookieProcessor 实现为 Rfc6265CookieProcessor ，之前的实现为 LegacyCookieProcessor 。前者是基于 RFC6265 ，而后者基于 RFC6265、RFC2109、RFC2616 。

解决方式

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

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

SpringBoot 的解决方式

在 springboot 启动类中增加内嵌 Tomcat 的配置 Bean，如下代码：

@SpringBootApplication
public class Application extends SpringBootServletInitializer {

	public static void main(String[] args) {
		SpringApplication.run(Application.class, args);
	}

    // Tomcat Cookie 处理配置 Bean
    @Bean
    public WebServerFactoryCustomizer<TomcatServletWebServerFactory> cookieProcessorCustomizer() {
        return (factory) -> factory.addContextCustomizers(
            (context) -> context.setCookieProcessor(new LegacyCookieProcessor()));
    }
}

参考资料：

Tomcat 8 CookieProcessor实现变化