基于AMD64镜像的Spring Cloud Gateway URL编码路径400错误排查请求

环境与路由配置 #

基于Spring Boot 3.3.6的应用，使用Spring Cloud Gateway实现路由，核心路由配置Bean如下：

@Bean
fun myRoutes(builder: RouteLocatorBuilder, openApiMap: Map<String, Map<HttpMethod, List<String>>>): RouteLocator {
    val openApiMap = <map of routes. key is the path>
    val routes =  builder.routes()
        .route { p: PredicateSpec ->
            p
                .path(*openApiMap.keys.toTypedArray())
                .uri("https://sample-base-uri")
        }
        .build()

    return routes
}

问题现象 #

• 本地arm64架构JDK镜像部署：所有请求（含URL编码路径）路由正常
• 远程amd64架构JDK镜像部署：请求路径包含URL编码字符时返回BAD_REQUEST
• 示例场景：原路径/user/1/file/-3CxBi2Z0t3GPhFXPKCnBw==编码为/user/1/file/-3CxBi2Z0t3GPhFXPKCnBw%253D%253D发送至网关，路由规则/user/{userId}/file/{fileId}匹配失败，返回400
• Spring Boot 2.7.6版本时，两种架构下均无此问题

相关版本信息 #

• Spring Boot：3.3.6
• Spring依赖管理版本：1.1.6
• Java：17

错误日志 #

[6b71b82c] Completed 400 BAD_REQUEST

排查方向与解决方案 #

1. 调整路径匹配的解码策略 #

Spring Cloud Gateway 3.x（对应Spring Boot 3.x）可能调整了路径解码的默认行为，可显式配置路径匹配时的解码规则：
在application.yml中添加：

spring:
  cloud:
    gateway:
      route:
        predicate:
          path:
            decode-slash: true
            match-trailing-slash: true

该配置强制网关在匹配路径前对URL编码的内容进行解码，确保路径变量能被正确识别。

2. 对比不同架构下的路径解码结果 #

不同架构的JDK镜像可能在URL解码实现上存在差异，可添加全局过滤器打印路径信息，对比两种环境的输出：

@Bean
fun pathLoggingFilter(): GlobalFilter {
    return GlobalFilter { exchange, chain ->
        val originalPath = exchange.request.path.value()
        val decodedPath = URLDecoder.decode(originalPath, StandardCharsets.UTF_8)
        println("Original Path: $originalPath | Decoded Path: $decodedPath")
        chain.filter(exchange)
    }
}

若amd64环境下解码后的路径与arm64不一致，需排查JDK镜像的URL处理逻辑差异。

3. 切换路径匹配器实现 #

Spring Boot 3.x默认使用PathPatternMatcher替代了旧版的AntPathMatcher，前者对路径格式的校验更严格。可尝试切换回AntPathMatcher：
在application.yml中添加：

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

注意：需确保Spring Cloud Gateway兼容该配置，若不生效可尝试在路由定义中显式指定匹配器。

4. 启用详细日志定位匹配失败原因 #

调整日志级别，打印网关路由匹配的详细过程：

logging:
  level:
    org.springframework.cloud.gateway: DEBUG
    org.springframework.web: DEBUG

通过日志可查看请求到达后，网关如何解析路径、执行匹配逻辑，明确是路径解码失败还是匹配规则不兼容导致的400错误。

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