迁移至Jakarta 10后GAE应用部署新变更报错，需清Cookie恢复

问题定位 #

• 报错Request failed: Unexpected Error: java.io.IOException: written 54 > 0 content-length本质是响应内容长度与设置的Content-Length头不匹配。
• 根因是首次部署生成的旧会话Cookie，在新变更部署后与后端新的Cookie处理逻辑不兼容：后端处理旧Cookie时，响应生成流程出现异常，导致实际输出内容（如错误提示）长度超过了提前设置的Content-Length值（比如0）。
• 清除浏览器缓存后恢复，说明旧Cookie是触发问题的直接诱因。

解决方案 #

1. 统一Cookie处理逻辑，兼容旧Cookie #

给自定义会话Cookie添加版本标识，后端识别到旧版本Cookie时直接失效并引导重新登录：

// 定义Cookie版本常量
private static final int CURRENT_COOKIE_VERSION = 2;

public void handleSessionCookie(HttpServletRequest request, HttpServletResponse response) {
    Cookie sessionCookie = null;
    Cookie[] cookies = request.getCookies();
    if (cookies != null) {
        for (Cookie c : cookies) {
            if ("USER_SESSION".equals(c.getName())) {
                sessionCookie = c;
                break;
            }
        }
    }

    // 检查Cookie版本，旧版本直接失效
    if (sessionCookie != null && sessionCookie.getVersion() < CURRENT_COOKIE_VERSION) {
        sessionCookie.setMaxAge(0);
        sessionCookie.setPath("/");
        response.addCookie(sessionCookie);
        // 跳转登录页或返回登录提示
        response.sendRedirect("/login");
        return;
    }

    // 正常处理新Cookie逻辑
    if (sessionCookie == null) {
        // 创建新版本Cookie
        Cookie newCookie = new Cookie("USER_SESSION", generateSessionValue());
        newCookie.setVersion(CURRENT_COOKIE_VERSION);
        newCookie.setPath("/");
        newCookie.setHttpOnly(true);
        newCookie.setSecure(true);
        newCookie.setMaxAge(86400);
        response.addCookie(newCookie);
    }
}

2. 移除手动设置Content-Length的逻辑 #

避免手动设置response.setContentLength(0);这类固定长度的代码，让Jakarta EE容器自动计算响应内容长度。如果必须控制响应内容，确保实际输出的内容长度与设置的Content-Length一致：

// 错误示例：设置了Content-Length为0但又输出内容
response.setContentLength(0);
response.getWriter().write("Invalid session"); // 导致实际长度>0，触发报错

// 正确做法：要么不输出内容，要么不手动设置Content-Length
// 方式1：不输出内容
response.setStatus(HttpServletResponse.SC_UNAUTHORIZED);

// 方式2：让容器自动处理
response.getWriter().write("Invalid session");

3. 统一Cookie属性 #

确保新部署的Cookie属性（path、domain、secure、httpOnly）与首次部署的一致，若有变更，在后端主动清理旧Cookie：

// 清理所有同名旧Cookie（不管版本）
Cookie[] cookies = request.getCookies();
if (cookies != null) {
    for (Cookie c : cookies) {
        if ("USER_SESSION".equals(c.getName())) {
            c.setMaxAge(0);
            c.setPath("/"); // 匹配旧Cookie的path
            response.addCookie(c);
        }
    }
}
// 添加新属性的Cookie
Cookie newCookie = new Cookie("USER_SESSION", generateSessionValue());
newCookie.setPath("/");
newCookie.setHttpOnly(true);
newCookie.setSecure(true);
newCookie.setMaxAge(86400);
response.addCookie(newCookie);

验证方法 #

1. 用保存了旧Cookie的浏览器访问应用，检查是否自动清理旧Cookie并跳转登录，无报错。
2. 登录后生成新Cookie，再次部署代码变更，确认应用正常启动，无需清除缓存。

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