Spring Cloud Gateway MVC版查询参数+字符转义异常求助

方案一：在Rails服务端修正参数解析逻辑 #

由于Rails默认遵循application/x-www-form-urlencoded规范，会将URL中的+解析为空格，但邮箱中的+是合法字符，可针对email参数单独处理：

• 从原始查询字符串提取并修正参数：

# 在mailbox服务的对应控制器中
def your_action
  if request.query_string.present?
    # 从原始查询字符串中提取email参数值
    email_raw = request.query_string.split('&').find { |part| part.start_with?('email=') }&.split('=')&.last
    if email_raw
      # 先将+替换为%2B，再解码得到正确邮箱
      @email = URI.decode_www_form_component(email_raw.gsub('+', '%2B'))
    end
  end
  # 后续业务逻辑
end

• 或者对已解析的参数做针对性替换（仅适用于邮箱无合法空格的场景）：

def your_action
  @email = params[:email].gsub(' ', '+') if params[:email].present?
  # 后续业务逻辑
end

方案二：在Spring Cloud Gateway添加自定义全局过滤器 #

通过自定义过滤器修正网关的参数编码逻辑，将解码后的空格（原请求中的+）替换回+，再重新编码转发：

@Component
public class EmailPlusEncodingFilter implements GlobalFilter, Ordered {

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        MultiValueMap<String, String> queryParams = exchange.getRequest().getQueryParams();
        
        if (queryParams.containsKey("email")) {
            // 将网关解码后的空格替换回+
            List<String> correctedEmails = queryParams.get("email").stream()
                    .map(email -> email.replace(" ", "+"))
                    .collect(Collectors.toList());
            queryParams.put("email", correctedEmails);
            
            // 构建编码后的新URI
            URI newUri = UriComponentsBuilder.fromUri(exchange.getRequest().getURI())
                    .replaceQueryParams(queryParams)
                    .build(true) // 强制编码参数
                    .toUri();
            
            ServerHttpRequest newRequest = exchange.getRequest().mutate().uri(newUri).build();
            return chain.filter(exchange.mutate().request(newRequest).build());
        }
        
        return chain.filter(exchange);
    }

    @Override
    public int getOrder() {
        // 设置优先级高于默认编码过滤器
        return -1;
    }
}

该过滤器会在网关转发前修正email参数，确保转发到mailbox服务的参数中+被编码为%2B，Rails解码后即可得到正确的邮箱格式。

方案三：客户端双重编码+字符 #

若客户端可修改请求逻辑，对+进行双重编码：

1. 原始邮箱：bob+test@mail.com
2. 第一次编码：将+转为%2B → bob%2Btest@mail.com
3. 第二次编码：将%2B转为%252B → bob%252Btest@mail.com

网关接收后解码一次得到bob%2Btest@mail.com，转发时重新编码为bob%252Btest@mail.com，Rails服务端再对参数做一次解码即可得到正确邮箱：

def your_action
  @email = URI.decode_www_form_component(params[:email]) if params[:email].present?
  # 后续业务逻辑
end

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