@Pattern不适用于具有path变量的控制器方法

@Pattern 注解通常用于验证请求参数或请求体中的字段是否符合特定的正则表达式模式。然而，当涉及到具有路径变量的控制器方法时，@Pattern 注解可能不会按预期工作，因为路径变量通常在 URL 路径中定义，而不是作为请求参数或请求体的一部分。

基础概念

路径变量：在 RESTful API 中，路径变量是 URL 路径的一部分，用于标识资源的特定实例。例如，在 /users/{userId} 中，{userId} 是一个路径变量。
@Pattern：这是一个 Java Bean Validation 注解，用于验证字符串字段是否符合指定的正则表达式模式。

类型与应用场景

类型：@Pattern 是一个注解，通常应用于 Java 类的字段上。
应用场景：适用于需要对用户输入进行复杂模式匹配的场景，如电子邮件地址、电话号码等。

问题原因

@Pattern 注解不适用于路径变量的主要原因在于它的设计初衷是验证请求参数或请求体中的字段，而不是 URL 路径的一部分。路径变量通常由框架自动解析并绑定到方法参数上，而不会触发 Bean Validation 机制。

解决方案

方案一：手动验证路径变量

可以在控制器方法内部手动验证路径变量是否符合预期的正则表达式模式。

import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping("/{userId}")
    public ResponseEntity<User> getUserById(@PathVariable String userId) {
        if (!userId.matches("\\d+")) { // 假设 userId 应该是数字
            return ResponseEntity.badRequest().build();
        }
        // 继续处理逻辑
        return ResponseEntity.ok(new User(userId));
    }
}

方案二：自定义注解和验证器

可以创建一个自定义注解和相应的验证器来处理路径变量的验证。

自定义注解：

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = PathVariableValidator.class)
@Target({ ElementType.PARAMETER })
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidPathVariable {
    String message() default "Invalid path variable";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

验证器实现：

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class PathVariableValidator implements ConstraintValidator<ValidPathVariable, String> {

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        return value.matches("\\d+"); // 自定义验证逻辑
    }
}

在控制器中使用自定义注解：

import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping("/{userId}")
    public ResponseEntity<User> getUserById(@ValidPathVariable @PathVariable String userId) {
        // 继续处理逻辑
        return ResponseEntity.ok(new User(userId));
    }
}