Servlet中addCookie无法添加Cookie问题求助

问题描述 #

作为Servlet新手，在实现记录最后访问时间功能时，发现Cookie始终无法成功添加。无论刷新页面、更换浏览器，页面均显示Your first visit.，浏览器Cookie列表中也找不到名为lastAccess的Cookie，怀疑问题出在resp.addCookie(cookie);语句。

代码示例 #

import jakarta.servlet.ServletException;
import jakarta.servlet.http.Cookie;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.io.PrintWriter;
import java.text.SimpleDateFormat;
import java.util.Date;

public class LastAccessServlet extends HttpServlet {

    private static final long serialVersionUID = 1L;

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.setContentType("text/html;charset=utf-8");
        String lastAccessTime = null;
        Cookie[] cookies = req.getCookies();
        PrintWriter writer = resp.getWriter();
        for (int i = 0; cookies != null && i < cookies.length; ++i){
            if ("lastAccess".equals(cookies[i].getName())) {
                lastAccessTime = cookies[i].getValue();
                break;
            }
        }
        if (lastAccessTime == null){
            writer.println("Your first visit.");
        } else {
            writer.println("Last time" + lastAccessTime);
        }
        String currentTime = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss").format(new Date());
        Cookie cookie = new Cookie("lastAccess", currentTime);
        cookie.setMaxAge(999999999);
        cookie.setPath("/");
        resp.addCookie(cookie);
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        this.doGet(req, resp);
    }
}

问题排查与解决方法 #

1. 调整Cookie添加与响应输出的顺序 #

Servlet中，响应头（包含Cookie）必须在响应体内容发送前发送到客户端。如果先调用writer.println()输出内容，当输出内容超过服务器响应缓冲区大小（默认通常为8KB）时，响应会被提前提交，此时再调用resp.addCookie()无法将Cookie写入响应头，导致浏览器无法接收Cookie。

修复代码：将添加Cookie的逻辑移到输出页面内容之前：

@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    resp.setContentType("text/html;charset=utf-8");
    String lastAccessTime = null;
    Cookie[] cookies = req.getCookies();
    
    // 先处理Cookie的添加逻辑
    String currentTime = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss").format(new Date());
    Cookie cookie = new Cookie("lastAccess", currentTime);
    cookie.setMaxAge(604800); // 设置为7天（60*60*24*7），避免过大数值可能的兼容性问题
    cookie.setPath("/");
    resp.addCookie(cookie);
    
    // 再读取已有Cookie并输出内容
    PrintWriter writer = resp.getWriter();
    for (int i = 0; cookies != null && i < cookies.length; ++i){
        if ("lastAccess".equals(cookies[i].getName())) {
            lastAccessTime = cookies[i].getValue();
            break;
        }
    }
    if (lastAccessTime == null){
        writer.println("Your first visit.");
    } else {
        writer.println("Last time: " + lastAccessTime);
    }
}

2. 对Cookie值进行URL编码 #

Cookie的value不能包含空格、逗号、分号等特殊字符，你的日期格式yyyy-MM-dd hh:mm:ss中包含空格，会导致Cookie无法被正确解析。需要使用URLEncoder对值进行编码，读取时用URLDecoder解码。

修复代码：

// 编码Cookie值
String currentTime = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss").format(new Date());
String encodedTime = URLEncoder.encode(currentTime, "UTF-8");
Cookie cookie = new Cookie("lastAccess", encodedTime);

// 读取Cookie时解码
if ("lastAccess".equals(cookies[i].getName())) {
    lastAccessTime = URLDecoder.decode(cookies[i].getValue(), "UTF-8");
    break;
}

3. 合理设置MaxAge值 #

虽然999999999小于int类型最大值（2147483647），但部分浏览器对过大的有效期数值可能存在兼容性问题。建议设置为合理的数值，比如7天（604800秒）或30天（2592000秒）。

4. 检查Servlet映射配置 #

确保你的Servlet在web.xml或注解中正确映射，比如使用@WebServlet("/lastAccess")，这样访问路径与Cookie的path="/"匹配，Cookie能被正确携带。

5. 检查浏览器Cookie设置 #

确认浏览器未禁用Cookie，未开启隐私模式，这些都会导致Cookie无法被保存。

内容的提问来源于stack exchange，提问作者SCUTVK