快捷導(dǎo)航

SpringBoot校驗(yàn)前端傳遞的參數(shù)的流程步驟

更新時(shí)間：2025年10月09日 10:24:31 作者：jovanz

在日常項(xiàng)目開(kāi)發(fā)中,我們都知道參數(shù)驗(yàn)證是必不可少的一環(huán),但是有時(shí)候?yàn)榱送祽?把參數(shù)校驗(yàn)交給前端開(kāi)發(fā)人員去處理,這樣很容易影響系統(tǒng)穩(wěn)定性和安全性,所以本文給大家介紹了SpringBoot校驗(yàn)前端傳遞的參數(shù)的流程步驟,需要的朋友可以參考下

Spring Boot 參數(shù)校驗(yàn)（基于 Hibernate Validator）

1. 簡(jiǎn)介與依賴(lài)

作用：對(duì) Controller 接收的參數(shù)進(jìn)行合法性校驗(yàn)，提升接口健壯性。
底層實(shí)現(xiàn)：Hibernate Validator（Bean Validation 規(guī)范的參考實(shí)現(xiàn)）。
推薦依賴(lài)

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

自動(dòng)引入 hibernate-validator + javax.validation-api，無(wú)需手動(dòng)管理版本。

2. 使用方式

校驗(yàn) @RequestBody（JSON 對(duì)象）

在參數(shù)前加 @Valid，無(wú)需 @Validated。

@PostMapping("/user")
public Result createUser(@Valid @RequestBody User user) { ... }

校驗(yàn) @RequestParam / @PathVariable 等

必須在 Controller 類(lèi)（或方法）上加 @Validated。

@RestController
@Validated // ← 關(guān)鍵！
public class UserController {
    @GetMapping("/user/{id}")
    public Result getUser(@Min(1) @PathVariable Long id) { ... }
}

最佳實(shí)踐：Controller 類(lèi)統(tǒng)一加 @Validated，覆蓋所有校驗(yàn)場(chǎng)景。

3. 常用注解

非空校驗(yàn)

@NotNull：驗(yàn)證對(duì)象不為null，但允許空字符串或空白字符
@NotEmpty：驗(yàn)證字符串/集合/數(shù)組非null且長(zhǎng)度/大小>0（不檢查空白字符）
@NotBlank：驗(yàn)證字符串非null且至少包含一個(gè)非空白字符

范圍校驗(yàn)

@Size(min=, max=)：限制字符串/集合/數(shù)組的長(zhǎng)度/大小范圍
@Min：驗(yàn)證數(shù)字最小值（含邊界值）
@Max：驗(yàn)證數(shù)字最大值（含邊界值）

格式校驗(yàn)

@Email：驗(yàn)證字符串是否符合郵箱格式
@Pattern(regexp = “…”)：通過(guò)正則表達(dá)式自定義校驗(yàn)規(guī)則

時(shí)間校驗(yàn)

@Past：驗(yàn)證日期是否在當(dāng)前時(shí)間之前
@Future：驗(yàn)證日期是否在當(dāng)前時(shí)間之后

4. 全局異常處理器

統(tǒng)一處理校驗(yàn)失敗異常，返回結(jié)構(gòu)化錯(cuò)誤信息。有了全局異常處理器，前端可以收到規(guī)范化的錯(cuò)誤信息

@RestControllerAdvice
public class GlobalValidationExceptionHandler {

    // 處理 @RequestBody 校驗(yàn)失敗
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ApiResult<Map<String, String>> handleRequestBody(
            MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getFieldErrors()
          .forEach(e -> errors.put(e.getField(), e.getDefaultMessage()));
        return ApiResult.error(400, "參數(shù)校驗(yàn)失敗").data(errors);
    }

    // 處理 @RequestParam / @PathVariable 校驗(yàn)失敗
    @ExceptionHandler(ConstraintViolationException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ApiResult<Map<String, String>> handleParams(
            ConstraintViolationException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getConstraintViolations().forEach(v ->
            errors.put(v.getPropertyPath().toString(), v.getMessage()));
        return ApiResult.error(400, "參數(shù)校驗(yàn)失敗").data(errors);
    }
}

返回示例：

{ "code": 400, "message": "參數(shù)校驗(yàn)失敗", "data": { "name": "姓名不能為空" } }

到此這篇關(guān)于SpringBoot校驗(yàn)前端傳遞的參數(shù)的流程步驟的文章就介紹到這了,更多相關(guān)SpringBoot校驗(yàn)前端傳遞參數(shù)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: