卫语句是网关层在请求抵达业务服务前拦截非法参数的轻量机制，位于GlobalFilter开头，基于原始请求信息快速校验路径、Header、Query等基础要素，不处理业务逻辑。
非法参数异常本身不是“非法”的，而是系统对不合规输入的合理反馈。关键在于网关层能否在请求真正抵达业务服务前，就识别并拦截这类问题——卫语句（Guard Clause）正是实现这一目标的轻量、高效手段。
卫语句在网关过滤器中的定位逻辑
卫语句不是独立组件，而是写在全局过滤器（GlobalFilter）最前端的一组快速判断逻辑。它不处理业务，只做“守门人”：检查路径、Header、Query、Body预解析结果等基础要素是否满足最低准入条件。一旦不满足，立即终止链路，不放行、不转发。
- 必须在 filter 方法开头执行，避免后续无意义处理
- 优先检查高危项：空 token、非法 Content-Type、超长 URI、明显 SQL 片段（如
select * from）、JSON 解析失败标志 - 不依赖下游服务响应，所有判断基于 exchange.getRequest() 可直接获取的原始信息
典型非法参数场景与卫语句写法
以下代码片段基于 Spring Cloud Gateway 3.x（Reactor 模型），放在自定义 GlobalFilter 的 filter() 方法起始处：
-
空或无效 Authorization：
if (!exchange.getRequest().getHeaders().containsKey("Authorization")) { return errorResponse(exchange, 401, "missing_authorization"); } -
非法 JSON Body（已预解析为 Map 失败）：
Object bodyAttr = exchange.getAttribute("cachedRequestBodyObject"); if (bodyAttr instanceof String && ((String) bodyAttr).trim().isEmpty()) { return errorResponse(exchange, 400, "empty_request_body"); } -
危险 Query 参数（含注入关键词）：
MultivaluedMap<string string> queries = exchange.getRequest().getQueryParams(); if (queries.containsKey("q") && queries.get("q").stream().anyMatch(v -> v.toLowerCase().contains("union select") || v.contains("' OR '1'='1"))) { return errorResponse(exchange, 400, "suspicious_query_parameter"); }</string>
与非法参数异常（IllegalArgumentException）的配合机制
网关本身不主动抛 IllegalArgumentException，但需识别并接管**下游服务抛出的该异常**。当微服务 Controller 层因 @Valid 失败、DTO 构造异常等抛出此类异常时，网关的 ErrorWebExceptionHandler 应捕获它，并映射为标准错误码：
- 将
IllegalArgumentException统一转为 HTTP 400 状态 - 提取异常 message 中的关键字段（如 “age must be between 0 and 150” → 错误码
PARAM_AGE_OUT_OF_RANGE） - 响应体严格遵循项目约定格式（如
{"code":"PARAM_AGE_OUT_OF_RANGE","message":"年龄必须在0-150之间"}），不暴露栈信息
避免常见陷阱
卫语句易被误用为“全量校验”，反而拖慢性能。务必守住边界：
- 不做 DTO 绑定或复杂 Bean Validation（那是下游服务职责）
- 不解析完整 JSON Body（避免阻塞式 IO），可用 Netty 的
AdaptCachedBodyGlobalFilter预缓存 + 轻量正则扫描 - 不校验业务规则（如“用户名不能重复”），只拦技术性非法（格式、长度、结构、明显恶意字符）
- 所有拦截响应必须带明确、可本地化（i18n）的错误码，方便前端统一提示
