Jersey过滤器无法获取请求头值问题求助

我之前也碰到过类似的Jersey过滤器拿不到请求头的问题，结合你的场景，大概率是这几个常见原因导致的，咱们一步步来排查解决：

1. 过滤器未正确注册 #

Jersey 2的ContainerRequestFilter必须被正确注册才能生效，否则过滤器根本不会被调用，自然拿不到任何请求头。

• 确保你的过滤器类上添加了@Provider注解：

@Provider
public class AuthRequestFilter implements ContainerRequestFilter {
    // ... 你的过滤逻辑
}

• 或者在你的ResourceConfig子类中手动注册过滤器：

public class RestApplication extends ResourceConfig {
    public RestApplication() {
        // 扫描包含@Provider注解的包
        packages("com.your.package.filters");
        // 或者直接注册单个过滤器
        register(AuthRequestFilter.class);
    }
}

2. 请求头获取方式错误 #

检查你在过滤器中获取请求头的代码是否正确，Jersey提供了两种常用方式：

• 单个值获取：使用getHeaderString()方法（推荐，直接返回头的第一个值）
• 多值获取：使用getHeaders().getFirst()方法

正确示例：

@Override
public void filter(ContainerRequestContext requestContext) throws IOException {
    // 获取Authorization头
    String token = requestContext.getHeaderString("authorization");
    // 获取X-API-Secret头
    String secret = requestContext.getHeaderString("x-api-secret");
    
    // 可以先打印日志确认是否拿到值
    System.out.println("Authorization: " + token);
    System.out.println("X-API-Secret: " + secret);
}

注意：HTTP请求头是大小写不敏感的，但建议和Postman中发送的头名称保持一致（比如全小写），避免不必要的问题。

3. 过滤器执行顺序问题 #

如果你的项目中有多个过滤器，可能因为优先级问题导致你的过滤器在其他修改请求的过滤器之后执行，拿不到原始请求头。

可以通过@Priority注解指定过滤器的执行顺序，比如认证类过滤器优先执行：

@Provider
@Priority(Priorities.AUTHENTICATION) // 优先级高于默认的USER优先级
public class AuthRequestFilter implements ContainerRequestFilter {
    // ... 你的过滤逻辑
}

4. 容器/服务器层面的拦截 #

部分应用服务器（如Tomcat）可能会对某些敏感请求头做默认处理，或者你配置了额外的安全拦截器，导致请求头被过滤。

可以检查服务器的配置文件（比如Tomcat的web.xml），看看是否有类似<security-constraint>或者自定义的Valve拦截了请求头；另外也可以临时换用Jetty等其他服务器测试，排除容器层面的问题。

5. 确认请求头确实被发送 #

虽然你说Postman能看到完整请求头，但可以再仔细检查：

• Postman的环境变量是否正确替换（比如{{token}}是否有实际值）
• 有没有开启Postman的"SSL证书验证"导致请求被拦截
• 可以用curl命令重新发送请求，确认请求头是否真的被携带：

curl -H "authorization: bearer <your-token>" -H "x-api-secret: <your-secret>" http://localhost:8080/your-api-path

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