Java参数校验不通过时抛出自定义异常的核心是：定义继承RuntimeException的异常类+手动或注解校验失败时主动throw+可选@ControllerAdvice统一拦截；推荐Spring Boot中结合@Valid与全局处理器实现结构化错误响应。
Java 中实现参数校验不通过时抛出自定义异常，核心是：定义异常类 + 在校验失败处主动 throw +（可选）统一拦截处理。不需要依赖框架也能做，但结合 Spring Boot 会更简洁高效。
定义业务相关的自定义异常类
继承 RuntimeException（非检查异常，调用方无需强制 try-catch），便于在任意校验位置直接抛出：
public class ParamValidationException extends RuntimeException {
private String errorCode; // 如 "VALIDATION.MISSING_FIELD"
public ParamValidationException(String message) {
super(message);
}
public ParamValidationException(String errorCode, String message) {
super(message);
this.errorCode = errorCode;
}
// getter 省略
}
手动校验 + 主动抛出（适用于简单场景或 DTO 外部校验）
在 Controller 或 Service 方法开头，对入参逐字段判断，不满足就抛出自定义异常：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 检查 null 或空字符串：
if (str == null || str.trim().isEmpty()) throw new ParamValidationException("VALIDATION.EMPTY", "用户名不能为空"); - 检查数字范围：
if (age 150) throw new ParamValidationException("VALIDATION.INVALID_AGE", "年龄必须在 0~150 之间"); - 检查格式（如手机号）：
if (!Pattern.matches("^1[3-9]\d{9}$", phone)) throw new ParamValidationException("VALIDATION.INVALID_PHONE", "手机号格式错误");
结合 @Valid + @ControllerAdvice 统一拦截（推荐 Spring Boot 项目）
利用 Bean Validation 注解（如 @NotBlank、@Min）声明约束，再用全局异常处理器捕获 MethodArgumentNotValidException 或 ConstraintViolationException，统一转为你的自定义异常响应：
立即学习“Java免费学习笔记（深入）”；
- DTO 上加注解：
public class UserRequest { @NotBlank(message = "用户名不能为空") private String username; } - Controller 方法加
@Valid：public Result createUser(@Valid @RequestBody UserRequest req) - 写一个
@ControllerAdvice类，重写handleMethodArgumentNotValid方法，从中提取所有FieldError，拼成提示语，然后 throwParamValidationException或直接返回统一错误 JSON
注意点
不要在自定义异常里吞掉原始堆栈（除非明确要隐藏），保留 super(message, cause) 构造器；若需返回结构化错误码和消息给前端，建议异常类包含 errorCode 和 details（如字段名列表）字段，并在全局处理器中映射为标准响应体（如 {"code": "VALIDATION.MISSING_FIELD", "msg": "缺少必要字段: email", "field": "email"}）。
