@PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗", description = "嵌套參數(shù)校驗-測試")
    public CommonResult<TestDto> parameterCheck(@RequestBody TestDto dto) {
        if (dto == null){
            throw new RuntimeException("參數(shù)不能為空");
        }
        return CommonResult.SUCCESS(dto);
    }

    @PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗", description = "嵌套參數(shù)校驗-測試")
    public CommonResult<TestDto> parameterCheck(@RequestBody TestDto dto) {
        Assert.isNull(dto.getName(), "姓名不能為空");
        Assert.isNull(dto.getSex(), "性別不能為空");
        return CommonResult.SUCCESS(dto);
    }

        <!-- 如果spring-boot版本小于2.3.x，spring-boot-starter-web會自動傳入hibernate-validator依賴。如果spring-boot版本大于2.3.x，則需要手動引入依賴 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>

import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDto {

    @NotBlank(message = "姓名不能為空")
    @Schema(description = "姓名")
    private String name;

    @NotNull(message = "年齡不能為空")
    @Schema(description = "年齡")
    @Min(value = 0, message = "年齡不能小于0")
    @Max(value = 200, message = "年齡不能大于200")
    private Integer age;

    //性別只允許為男或女
    @NotBlank(message = "性別不能為空")
    @Pattern(regexp = "^(男|女)$", message = "性別必須為'男'或'女'")
    @Schema(description = "性別")
    private String sex;

    @Valid
    @Schema(description = "嵌套對象")
    private TestDtoObj testDtoObj;
}

import com.example.demo.annotation.PhoneNumber;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.URL;
import java.time.LocalDate;
import java.time.LocalDateTime;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDtoObj {

    @PhoneNumber
    @NotBlank(message = "手機號1不能為空")
    @Schema(description = "手機號1")
    private String phone1;

    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "無效的手機號碼格式")
    @NotBlank(message = "手機號不能為空")
    @Schema(description = "手機號2")
    private String phone2;

    @NotBlank(message = "密碼不能為空")
    @Size(min = 6, max = 16, message = "密碼長度必須在6到16個字符之間")
    @Schema(description = "密碼")
    private String password;

    @NotBlank(message = "郵箱不能為空")
    @Pattern(regexp = "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$", message = "郵箱格式不正確")
    @Schema(description = "郵箱")
    private String email;

    @Digits(integer = 4, fraction = 2, message = "整數(shù)位數(shù)必須在4位以內(nèi)小數(shù)位數(shù)必須在2位以內(nèi)")
    @Schema(description = "小數(shù)")
    private Double num;

    @URL(message = "url格式錯誤")
    @Schema(description = "地址")
    private String url;

    @Past(message = "日期必須為過去日期")
    @Schema(description = "過去日期")
    private LocalDate pastDate;

    @Future(message = "日期必須為將來日期")
    @Schema(description = "將來日期")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone = "GMT+8")
    private LocalDateTime futureDate;

}

/**
 * 全局異常攔截
 * 
 * @author zyw
 */
@Slf4j
@RestControllerAdvice
public class BaseExceptionHandler {

    /**
     * 攔截參數(shù)校驗異常
     * @param e
     * @param request
     * @return
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public CommonResult<?> handleGlobalException(MethodArgumentNotValidException e, HttpServletRequest request) {
        log.error("請求地址'{}',發(fā)生系統(tǒng)異常'{}'", request.getRequestURI(), e.getBindingResult().getFieldError().getDefaultMessage());
        return CommonResult.ECEPTION(ResultCode.PARAMETER_EXCEPTION, e.getBindingResult().getFieldError().getDefaultMessage());
    }

}

import com.example.demo.config.CommonResult;
import com.example.demo.model.dto.TestDto;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

@RestController
@Slf4j
@RequestMapping("knife4j")
@Tag(name = "knife4j測試控制器")
public class Knife4jController {
    @PostMapping("/parameterCheck")
    @Operation(summary = "參數(shù)校驗", description = "嵌套參數(shù)校驗-測試")
    public CommonResult<TestDto> parameterCheck(@Validated @RequestBody TestDto dto) {
        return CommonResult.SUCCESS(dto);
    }
}

import com.example.demo.uitls.validator.PhoneNumberValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

/**
 * PhoneNumber : 手機號格式驗證注解
 * 用于驗證電話號碼格式的注解。
 * 該注解可以應用于字段或參數(shù)上，以驗證其是否為有效的電話號碼格式。
 * 默認的錯誤消息是“無效的手機號碼格式”，但可以通過message屬性自定義。
 * 可以通過groups和payload屬性來支持分組驗證和負載信息。
 *
 * @Documented 標記此注解將被包含在文檔中。
 * @Constraint 標記此注解為約束注解，并指定PhoneNumberValidator類作為驗證器。
 * @Target 指定此注解可以應用于字段和參數(shù)上。
 * @Retention 指定此注解在運行時保留。
 * @author zyw
 * @create 2024-05-31  15:38
 */

@Documented
@Constraint(validatedBy = PhoneNumberValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface PhoneNumber {
    /**
     * 驗證失敗時的錯誤消息，默認為“無效的手機號碼格式”。
     * 可以通過將此屬性設(shè)置為自定義錯誤消息來更改默認消息。
     *
     * @return 驗證失敗時的錯誤消息。
     */
    String message() default "無效的手機號碼格式";
    /**
     * 定義驗證的分組，默認為空組。
     * 可以通過將此屬性設(shè)置為一個或多個分組類來指定字段應在哪些分組中進行驗證。
     *
     * @return 驗證的分組類數(shù)組。
     */
    Class<?>[] groups() default {};
    /**
     * 定義驗證的負載信息，默認為空負載。
     * 可以通過將此屬性設(shè)置為一個或多個負載類來攜帶額外的驗證信息。
     *
     * @return 驗證的負載信息類數(shù)組。
     */
    Class<? extends Payload>[] payload() default {};
}

import com.example.demo.annotation.PhoneNumber;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;

/**
 * PhoneNumberValidator : 手機號驗證器類
 *
 * @author zyw
 * @create 2024-05-31  15:39
 */

public class PhoneNumberValidator implements ConstraintValidator<PhoneNumber, String> {
    private static final String PHONE_PATTERN = "^1[3-9]\\d{9}$"; // 中國手機號碼的簡單正則表達式

    @Override
    public boolean isValid(String phoneNumber, ConstraintValidatorContext context) {
        return phoneNumber != null && phoneNumber.matches(PHONE_PATTERN);
    }
}

import com.example.demo.annotation.PhoneNumber;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.v3.oas.annotations.media.Schema;
import jakarta.validation.constraints.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.validator.constraints.URL;
import java.time.LocalDate;
import java.time.LocalDateTime;

/**
 * TestDtoObj :
 *
 * @author zyw
 * @create 2024-05-31  15:47
 */

@Data
@AllArgsConstructor
@NoArgsConstructor
public class TestDtoObj {

    @PhoneNumber
    @PhoneNumber(message = "手機號格式錯誤")
    @Schema(description = "手機號1")
    private String phone1;

    @Pattern(regexp = "^1[3-9]\\d{9}$", message = "無效的手機號碼格式")
    @NotBlank(message = "手機號不能為空")
    @Schema(description = "手機號2")
    private String phone2;

}

@PhoneNumber
@PhoneNumber(message = "手機號格式錯誤")
@Schema(description = "手機號1")
private String phone1;

@Pattern(regexp = "^1[3-9]\\d{9}$", message = "無效的手機號碼格式")
@NotBlank(message = "手機號不能為空")
@Schema(description = "手機號2")
private String phone2;