Spring Controller无法处理含斜杠的加密参数URL问题求助

你的问题核心是加密后的用户信息包含斜杠，Spring默认会把斜杠解析为路径分隔符，导致@PathVariable只能获取到第一个斜杠前的部分。下面是几种可行的解决方法：

方法一：给PathVariable添加正则匹配规则 #

直接修改@GetMapping的路径规则，用正则表达式指定key匹配所有字符（包括斜杠），这样Spring就会把/verify/后面的全部内容作为完整的key参数。

修改后的Controller代码：

@RestController
@RequestMapping("/api/v1/auth")
@RequiredArgsConstructor
public class AuthenticationController {
    // 用:.+正则匹配任意非空字符，包括斜杠
    @GetMapping("/verify/{key:.+}")
    public ResponseEntity<?> verify(@PathVariable String key){
        // 这里拿到的key就是完整的加密字符串，包含所有斜杠
        return ResponseEntity.ok(key);
    }
}

方法二：对加密字符串做URL编码 #

在生成验证URL的时候，先把加密后的用户信息做URL编码，斜杠会被转换成%2F，这样Spring就能正确识别为单个PathVariable参数。

比如在Java中生成编码后的字符串：

String encryptedKey = "v1WKKvOWLcLeQepiZ3c0xj9tnPFlW3eOeajASdMhRx1kvhHrdBqDLFlzxE/aLIlo26hh6Q74iPVTjWvDJUVVSM8zEqMxTqBLRjbJaFH3RNnXsNpcRhJSsOSYSOAL0eE/WPiEYwdKmg5zg1VNCo1JFQ==";
String encodedKey = URLEncoder.encode(encryptedKey, StandardCharsets.UTF_8);
// 生成的URL就是：https://MyWebsite.io/api/v1/auth/verify/[编码后的字符串]

前端发起请求时，也可以用encodeURIComponent()方法对key进行编码，确保传递的是合法的URL格式。

方法三：改用请求参数传递key #

如果不想修改路径匹配规则，也可以把加密信息放在请求参数里，避免路径分隔符的问题：

修改后的Controller代码：

@RestController
@RequestMapping("/api/v1/auth")
@RequiredArgsConstructor
public class AuthenticationController {
    @GetMapping("/verify")
    public ResponseEntity<?> verify(@RequestParam String key){
        return ResponseEntity.ok(key);
    }
}

对应的请求URL格式变为：
https://MyWebsite.io/api/v1/auth/verify?key=v1WKKvOWLcLeQepiZ3c0xj9tnPFlW3eOeajASdMhRx1kvhHrdBqDLFlzxE/aLIlo26hh6Q74iPVTjWvDJUVVSM8zEqMxTqBLRjbJaFH3RNnXsNpcRhJSsOSYSOAL0eE/WPiEYwdKmg5zg1VNCo1JFQ==

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