如何重命名JSESSIONIDVERSION Cookie？使用JAX-RS/Payara Micro等技术遇阻

JSESSIONIDVERSION是Payara（继承自GlassFish）的专属Cookie，用于追踪会话版本，配合JSESSIONID处理会话更新、失效的校验逻辑。你之前用JAX-RS过滤器找不到它，是因为这个Cookie是由Servlet容器（Payara）在JAX-RS响应处理之后才添加到响应中的，所以JAX-RS过滤器无法捕获到。下面是两种可行的解决方法：

方法1：直接通过Payara配置修改 #

Payara支持通过配置参数直接指定会话版本Cookie的名称，无需编写代码：

• 启动参数方式：启动Payara Micro时添加JVM参数

  java -jar payara-micro.jar --addJvmOptions "-Dfish.payara.session.version.cookie.name=YOUR_CUSTOM_VERSION_COOKIE"
  

• domain.xml配置方式：如果使用自定义domain.xml（Payara Micro也可加载自定义域配置），在<session-manager>节点下添加属性：

  <session-manager session-id-length="29">
    <property name="versionCookieName" value="YOUR_CUSTOM_VERSION_COOKIE"/>
  </session-manager>
  

方法2：用Servlet Filter拦截修改 #

如果需要动态控制或者不想修改容器配置，可以编写Servlet Filter拦截响应，在Cookie被添加到响应前修改名称。Servlet Filter的执行时机晚于JAX-RS处理，能捕获到容器设置的JSESSIONIDVERSION：

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebFilter(filterName = "SessionVersionCookieRenameFilter", urlPatterns = "/*")
public class SessionVersionCookieRenameFilter implements Filter {

    private static final String OLD_COOKIE_NAME = "JSESSIONIDVERSION";
    private static final String NEW_COOKIE_NAME = "YOUR_CUSTOM_VERSION_COOKIE";

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        CookieModifyingResponseWrapper wrappedResponse = new CookieModifyingResponseWrapper(httpResponse);
        chain.doFilter(request, wrappedResponse);
    }

    private static class CookieModifyingResponseWrapper extends HttpServletResponseWrapper {
        public CookieModifyingResponseWrapper(HttpServletResponse response) {
            super(response);
        }

        @Override
        public void addCookie(Cookie cookie) {
            if (OLD_COOKIE_NAME.equals(cookie.getName())) {
                cookie.setName(NEW_COOKIE_NAME);
            }
            super.addCookie(cookie);
        }
    }

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {}
    @Override
    public void destroy() {}
}

额外注意事项 #

• 若使用NGINX反向代理，需确保NGINX不会篡改该Cookie。如果需要统一Cookie的安全属性，可配置：

  proxy_cookie_path / "/; secure; HttpOnly; SameSite=Strict";
  

• 确认Payara的会话版本功能处于开启状态（默认开启，用于会话失效时的版本校验），避免配置无效。

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