@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 {
    /**
     * 驗證失敗時的錯誤消息，默認為“無效的手機號碼格式”。
     * 可以通過將此屬性設置為自定義錯誤消息來更改默認消息。
     *
     * @return 驗證失敗時的錯誤消息。
     */
    String message() default "無效的手機號碼格式";
    /**
     * 定義驗證的分組，默認為空組。
     * 可以通過將此屬性設置為一個或多個分組類來指定字段應在哪些分組中進行驗證。
     *
     * @return 驗證的分組類數(shù)組。
     */
    Class<?>[] groups() default {};
    /**
     * 定義驗證的負載信息，默認為空負載。
     * 可以通過將此屬性設置為一個或多個負載類來攜帶額外的驗證信息。
     *
     * @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;