在 spring boot 中校验版本号格式,最直接的办法是使用 @pattern 注解配合正则表达式。你需要在 dto 的字段上添加该注解,并编写一个匹配语义化版本(如 1.0.0)或任意数字加点号的正则。这样当请求参数不符合格式时,框架会自动抛出 methodargumentnotvalidexception,你可以通过全局异常处理器统一返回错误信息。

如何配置正则以支持常见的版本号格式
要支持类似 1.2.3 或 v1.0.0 的格式,可以使用 @Pattern(regexp = "^v?\d+\.\d+\.\d+$")。这个正则允许前缀 v,且必须包含三个由点分隔的数字段。如果只需要严格的 X.Y.Z 格式,可以去掉 v? 部分。配置完成后,Spring Validation 会在绑定数据后自动触发校验逻辑。

import javax.validation.constraints.Pattern;
public class VersionRequest {
@Pattern(regexp = "^\d+\.\d+\.\d+$", message = "版本号格式必须为 X.Y.Z")
private String version;
// getter and setter
}
上述代码定义了一个简单的 DTO。当传入 version=1.0.0 时校验通过;传入 version=1.0 或 version=abc 时校验失败。开发者只需确保正则表达式覆盖了业务所需的所有合法变体即可。
如何处理校验失败后的全局异常响应
当校验失败时,Spring Boot 会抛出 MethodArgumentNotValidException。为了给用户友好的反馈,需要创建一个全局异常处理器来捕获该异常并提取具体的错误字段和消息。通常使用 @RestControllerAdvice 结合 @ExceptionHandler 来实现。这样可以避免在每个 Controller 方法中手动处理校验结果,保持代码整洁。

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.validation.MethodArgumentNotValidException;
import org.springframework.http.ResponseEntity;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<map object>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<string object> errors = new HashMap();
ex.getBindingResult().getFieldErrors().forEach(error ->
errors.put(error.getField(), error.getDefaultMessage())
);
return ResponseEntity.badRequest().body(errors);
}
}</string></map>
这段代码将所有的校验错误收集到一个 Map 中,并以 JSON 形式返回。例如,如果 version 字段校验失败,返回的 JSON 可能为 {"version": "版本号格式必须为 X.Y.Z"}。这种处理方式确保了 API 响应的一致性,方便前端解析和处理。
版本号字段为空时会发生什么
如果 version 字段在请求中缺失或为空字符串,@Pattern 注解默认不会触发校验,因为空值被视为无效输入而非格式错误。如果需要强制要求版本号必填,必须同时添加 @NotBlank 或 @NotNull 注解。只有当字段非空时,@Pattern 才会检查其内容是否符合正则表达式。若未添加非空约束,空值将通过校验,可能导致后续业务逻辑出现 NullPointerException 或其他意外行为。











