当前位置：首页 > 文章列表 > 文章 > java教程 > SpringBoot请求校验方法全解析

SpringBoot请求校验方法全解析

2025-07-14 17:30:28 0浏览收藏

还在为 Spring Boot 应用中如何校验直接接收的字符串类型请求体而烦恼吗？本文为你提供了一套完整的解决方案！本文将详细讲解如何在 Spring Boot 中，通过自定义注解和验证器，实现对请求体字符串的有效性验证，保证数据的合法性和安全性。文章通过示例代码，一步步教你创建自定义注解 `MyValidator` 和验证器 `JsonSyntaxValidator`，并在 Controller 中巧妙运用 `@Valid` 注解，轻松实现对 JSON 字符串等复杂格式的校验。掌握本文内容，告别繁琐的手动校验，提升 Spring Boot 应用的健壮性！

使用自定义验证器校验 Spring Boot 请求体字符串

本文介绍了如何在 Spring Boot 应用中，针对直接接收字符串类型的请求体，应用自定义验证器进行数据校验。通过示例代码，详细展示了自定义注解、验证器以及如何在 Controller 中正确使用 @Valid 注解，实现对请求体字符串的有效性验证。

在 Spring Boot 应用开发中，我们经常需要对请求体中的数据进行校验，以保证数据的合法性和安全性。通常情况下，我们会使用 JSR-303 提供的标准注解，例如 @NotNull、@Size 等，来对 POJO 对象的属性进行校验。但有时，我们可能需要直接接收字符串类型的请求体，例如 JSON 字符串，并对其进行自定义的校验。本文将介绍如何实现这一需求。

1. 创建自定义注解

首先，我们需要创建一个自定义注解，用于标识需要进行校验的字符串。

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;

import static java.lang.annotation.RetentionPolicy.RUNTIME;

@Target({ ElementType.PARAMETER })
@Retention(RUNTIME)
@Constraint(validatedBy = { JsonSyntaxValidator.class })
@Documented
public @interface MyValidator {

    String message() default "{Token is not in Json syntax}";

    Class<?>[] groups() default {};

    Class<? extends Payload>[] payload() default {};

}

@Target({ ElementType.PARAMETER }): 指定注解可以应用的目标类型，这里是方法参数。
@Retention(RUNTIME): 指定注解的保留策略，这里是运行时保留。
@Constraint(validatedBy = { JsonSyntaxValidator.class }): 指定处理该注解的验证器类。
message(): 定义验证失败时的默认消息。
groups(): 定义分组，用于分组验证。
payload(): 定义负载，用于传递验证信息。

2. 创建自定义验证器

接下来，我们需要创建一个自定义验证器，用于实现具体的校验逻辑。

import com.google.gson.JsonParser;
import com.google.gson.JsonSyntaxException;
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class JsonSyntaxValidator implements ConstraintValidator<MyValidator, String> {

    @Override
    public void initialize(MyValidator constraintAnnotation) {

    }

    /**
     * It returns true if the Google Pay or Apple Pay token is in Json format.
     */
    @Override
    public boolean isValid(String token, ConstraintValidatorContext constraintValidatorContext) {

        boolean isValid = true;

        try {
            JsonParser.parseString(token);
        } catch (JsonSyntaxException e) {
            isValid = false;
        }
        return isValid;
    }
}

ConstraintValidator: 指定验证器处理的注解类型和数据类型。
initialize(MyValidator constraintAnnotation): 用于初始化验证器，可以获取注解中的属性值。
isValid(String token, ConstraintValidatorContext constraintValidatorContext): 实现具体的校验逻辑，返回 true 表示验证通过，false 表示验证失败。

3. 在 Controller 中使用

最后，我们需要在 Controller 中使用自定义注解，并启用验证功能。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;

@RestController
public class MyController {

    @RequestMapping(value = "/endpoint", method = { RequestMethod.POST })
    @ResponseBody
    public ResponseEntity<String> authorize(@Valid @RequestBody String token) {

        // logic
        return ResponseEntity.ok("Success");
    }
}

关键点：