Spring读取含邮箱的Cookie时内容被截断问题求助

这个问题我之前做Spring Security项目时也踩过坑！核心原因和Tomcat的Cookie解析规则以及Cookie值的字符编码规范直接相关，结合你的技术栈，具体拆解如下：

一、为什么会截断@及后续内容？ #

1. Tomcat默认的Cookie处理器限制 #

Tomcat早期版本（比如7.x）默认使用LegacyCookieProcessor，这个处理器遵循旧版的Cookie规范（RFC 2109），会把@、:这类字符当作Cookie值的分隔符，导致解析时从@位置直接截断，只保留前面的部分。

即使是Tomcat 8.5+，虽然默认换成了符合RFC 6265的Rfc6265CookieProcessor，但如果你的项目有自定义的Cookie解析配置，也可能出现这个问题。

2. Spring Security未对特殊字符编码 #

Spring Security在生成Cookie时，默认不会自动对包含特殊字符的内容（比如邮箱里的@）做URL编码。如果直接把原始邮箱写入Cookie，就会触发Tomcat的截断逻辑。

二、解决方法 #

方案1：切换Tomcat的Cookie处理器（推荐容器层面解决） #

如果你的Tomcat版本是7.x，或者8.x但被修改过默认配置，直接切换到RFC 6265标准的处理器即可支持@这类字符：

1. 打开Tomcat的conf/context.xml文件
2. 在<Context>标签内添加以下配置：

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

重启Tomcat后，再测试Cookie的读取，邮箱应该能完整获取了。

方案2：在Spring Security中手动编码/解码Cookie值（通用跨容器方案） #

不管容器配置如何，对Cookie值做URL编码是更稳妥的做法，避免不同容器的解析差异：

设置Cookie时编码

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletResponse;

// 示例：设置邮箱Cookie
public void setEmailCookie(HttpServletResponse response, String email) {
    String encodedEmail = URLEncoder.encode(email, StandardCharsets.UTF_8);
    Cookie emailCookie = new Cookie("user_email", encodedEmail);
    emailCookie.setPath("/");
    // 按需设置过期时间、域名等
    response.addCookie(emailCookie);
}

读取Cookie时解码

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletRequest;

// 示例：读取邮箱Cookie
public String getEmailFromCookie(HttpServletRequest request) {
    Cookie[] cookies = request.getCookies();
    if (cookies == null) return null;
    for (Cookie cookie : cookies) {
        if ("user_email".equals(cookie.getName())) {
            return URLDecoder.decode(cookie.getValue(), StandardCharsets.UTF_8);
        }
    }
    return null;
}

结合Spring Security的CookieSerializer配置

如果是用Spring Security的Remember-Me或者自定义Cookie认证，可以通过CookieSerializer统一处理编码：

import org.springframework.security.web.authentication.rememberme.PersistentTokenBasedRememberMeServices;
import org.springframework.security.web.savedrequest.DefaultCookieSerializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.nio.charset.StandardCharsets;

@Configuration
public class SecurityConfig {

    @Bean
    public CookieSerializer cookieSerializer() {
        DefaultCookieSerializer serializer = new DefaultCookieSerializer();
        serializer.setCookieName("remember-me"); // 替换成你的Cookie名称
        serializer.setCookiePath("/");
        // 开启URL编码，支持特殊字符
        serializer.setUseBase64Encoding(false); // 如果偏好Base64编码也可以设为true
        serializer.setEncodingScheme(StandardCharsets.UTF_8.name());
        return serializer;
    }

    // 如果你用PersistentTokenBasedRememberMeServices，注入上面的CookieSerializer
    @Bean
    public PersistentTokenBasedRememberMeServices rememberMeServices(...) {
        PersistentTokenBasedRememberMeServices services = new PersistentTokenBasedRememberMeServices(...);
        services.setCookieSerializer(cookieSerializer());
        return services;
    }
}

三、验证建议 #

设置Cookie后，打开浏览器的开发者工具（F12），切换到Application标签，找到对应的Cookie，查看Value字段：

• 如果显示的是编码后的值（比如mymail%40test.com），说明编码生效，读取时解码即可拿到完整邮箱；
• 如果显示的是原始邮箱mymail@test.com，则需要检查Tomcat的Cookie处理器配置是否生效。

内容的提问来源于stack exchange，提问作者L. Schilling