引言

在開發Web應用程序時，對客戶端傳入的參數進行有效校驗是保證系統安全性和穩定性的重要環節。Spring Boot作為一個現代化的Java開發框架，提供了多種參數校驗的方法和工具，以滿足不同場景下的需求。本文將深入探討Spring Boot中實現各種參數校驗的技術手段，包括JSR 303/349 Bean Validation、Spring MVC自帶的注解校驗以及自定義校驗器，并輔以具體示例，幫助我們掌握在實際項目中如何靈活運用這些校驗機制。

一、JSR 303/349 Bean Validation

1. 簡介

JSR 303（Java Specification Request 303）提出了Java Bean屬性校驗的標準，后續的JSR 349對其進行了擴展。通過引入javax.validation包中的注解，如@NotNull、@Size、@Pattern等，開發者可以直接在實體類的屬性上聲明校驗規則。

2. 示例

import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;public class UserDto {@NotNull(message = "用戶名不能為空")@Size(min = 3, max = 20, message = "用戶名長度應在3到20個字符之間")private String username;@NotNull(message = "密碼不能為空")@Min(value = 6, message = "密碼長度至少為6個字符")private String password;// getter/setter...
}

在Spring Boot中，只需要開啟@Valid注解支持，即可自動啟用JSR 303/349校驗：

@PostMapping("/users")
public ResponseEntity<?> createUser(@Valid @RequestBody UserDto userDto) {// 如果校驗失敗，Spring MVC會自動拋出MethodArgumentNotValidException異常// 此處省略業務邏輯...
}

二、Spring MVC自帶的注解校驗

1. 簡介

Spring MVC本身也提供了一系列注解用于參數校驗，如@RequestParam、@PathVariable等可以附加@NotNull等約束條件，實現對HTTP請求參數的校驗。

2. 示例

@GetMapping("/users/{id}")
public ResponseEntity<?> getUser(@PathVariable @NotNull(message = "用戶ID不能為空") Long id) {// 校驗邏輯由Spring MVC處理// 此處省略業務邏輯...
}@PostMapping("/login")
public ResponseEntity<?> login(@RequestParam @Size(min = 3, max = 20, message = "用戶名長度應在3到20個字符之間") String username,@RequestParam @NotNull(message = "密碼不能為空") String password) {// 校驗邏輯由Spring MVC處理// 此處省略業務邏輯...
}

三、自定義校驗注解與校驗器

1. 簡介

對于復雜的業務場景，標準的注解可能無法滿足需求，這時就需要自定義校驗注解和校驗器。

2. 示例

首先，創建自定義注解：

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PasswordStrengthValidator.class)
public @interface PasswordStrength {String message() default "密碼強度不足";Class<?>[] groups() default {};Class<? extends Payload>[] payload() default {};
}

接著，編寫對應的校驗器：

public class PasswordStrengthValidator implements ConstraintValidator<PasswordStrength, String> {@Overridepublic boolean isValid(String password, ConstraintValidatorContext context) {// 自定義校驗邏輯，如判斷密碼是否包含數字、字母、特殊字符等// 這里僅為示例，實際邏輯請根據業務需求編寫return password != null && password.length() > 6 && containsNumber(password) && containsLetter(password);}// 輔助方法private boolean containsNumber(String s) {...}private boolean containsLetter(String s) {...}
}

最后，在實體類中使用自定義注解：

public class UserDto {// ...@PasswordStrengthprivate String password;// ...
}

四、全局異常處理與自定義錯誤響應

為了統一對參數校驗失敗的異常處理，可以自定義全局異常處理器，實現HandlerExceptionResolver接口，并對MethodArgumentNotValidException等異常進行捕獲和處理，返回統一格式的錯誤響應。

五、Spring Boot WebFlux 中的參數校驗

對于使用WebFlux開發的反應式應用，Spring Boot同樣支持參數校驗，只需在控制器方法參數上使用@Valid注解，結合Reactive的異常處理機制，實現對請求參數的校驗。

六、結論

在Spring Boot中實現參數校驗，既可以利用JSR 303/349提供的豐富注解，又可以結合Spring MVC自帶的注解以及自定義校驗注解與校驗器，靈活應對不同場景下的校驗需求。通過全局異常處理機制，可以實現優雅的錯誤響應，提升用戶體驗。在實際開發中，應根據項目特點選擇合適的校驗策略，確保系統的安全性與穩定性。