REST Assured中的Filter接口是什么？是否用于传递请求参数及求示例

1. Filter接口定义 #

Filter是REST Assured提供的钩子接口，支持在HTTP请求发送到服务器前、服务器响应返回给客户端后两个节点插入自定义处理逻辑，属于面向切面的扩展能力。

2. 关于「作用是否为在请求中传递参数」的说明 #

该说法不准确，给请求传递参数只是Filter可实现的能力之一，它的核心作用是对请求、响应做全局/局部的统一拦截处理，常见适用场景包括：

• 统一添加请求头、请求参数、Cookie
• 打印请求/响应全链路日志用于调试
• 统一处理鉴权逻辑，自动填充请求身份凭证
• 对返回的响应结果做统一预处理
• 统计接口请求耗时、上报接口调用结果

3. 实际使用示例 #

示例1：自定义全链路日志打印Filter #

首先实现Filter接口，重写filter方法：

import io.restassured.filter.Filter;
import io.restassured.filter.FilterContext;
import io.restassured.response.Response;
import io.restassured.specification.FilterableRequestSpecification;
import io.restassured.specification.FilterableResponseSpecification;

public class CustomLogFilter implements Filter {
    @Override
    public Response filter(FilterableRequestSpecification requestSpec, FilterableResponseSpecification responseSpec, FilterContext ctx) {
        // 请求发送前的处理逻辑：打印请求详情
        System.out.println("=== 请求信息 ===");
        System.out.println("请求方法：" + requestSpec.getMethod());
        System.out.println("请求地址：" + requestSpec.getURI());
        System.out.println("请求头：" + requestSpec.getHeaders());
        System.out.println("请求体：" + requestSpec.getBody());
        
        // 执行后续过滤器链，发送请求拿到响应
        Response response = ctx.next(requestSpec, responseSpec);
        
        // 响应返回后的处理逻辑：打印响应详情
        System.out.println("=== 响应信息 ===");
        System.out.println("响应状态码：" + response.getStatusCode());
        System.out.println("响应体：" + response.getBody().asString());
        
        return response;
    }
}

调用方式：

// 仅单次请求生效
given().filter(new CustomLogFilter())
        .when().get("/api/user/1")
        .then().statusCode(200);

// 全局生效，所有请求都会经过该Filter
RestAssured.filters(new CustomLogFilter());

示例2：统一添加鉴权凭证的Filter #

public class AuthTokenFilter implements Filter {
    private String accessToken;

    public AuthTokenFilter(String accessToken) {
        this.accessToken = accessToken;
    }

    @Override
    public Response filter(FilterableRequestSpecification requestSpec, FilterableResponseSpecification responseSpec, FilterContext ctx) {
        // 给所有请求统一添加鉴权请求头，无需逐个请求配置
        requestSpec.header("Authorization", "Bearer " + accessToken);
        return ctx.next(requestSpec, responseSpec);
    }
}

调用方式：

// 全局配置后后续所有请求自动带上鉴权头
RestAssured.filters(new AuthTokenFilter("登录接口返回的有效token"));
given().when().get("/api/auth/queryInfo").then().statusCode(200);

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