在 java 中定义 validationexception 需要继承 runtimeexception，并保留标准构造函数以支持消息和原因传递。通常建议添加一个包含字段名和错误信息的专用构造函数，以便调用者能精准定位校验失败的具体位置。
如何设计构造函数以区分通用错误与字段级错误
通过重载构造函数，可以分别处理全局校验失败和特定字段的校验失败。全局异常使用单字符串消息，字段级异常则同时携带字段名和具体错误描述，便于上层业务逻辑进行差异化处理。
public class ValidationException extends RuntimeException {
private final String fieldName;
public ValidationException(String message) {
super(message);
this.fieldName = null;
}
public ValidationException(String message, Throwable cause) {
super(message, cause);
this.fieldName = null;
}
public ValidationException(String fieldName, String message) {
super(message);
this.fieldName = fieldName;
}
public ValidationException(String fieldName, String message, Throwable cause) {
super(message, cause);
this.fieldName = fieldName;
}
public String getFieldName() {
return fieldName;
}
}
上述代码定义了四个构造函数。前两个用于非字段相关的通用校验错误，后两个专门针对字段校验。通过 getFieldName() 方法，调用者可以判断异常是否由特定字段引起。若返回 null，则为全局错误；若返回具体字段名，则可结合错误信息进行前端提示或日志记录。
立即学习“Java免费学习笔记（深入）”；
如何在业务层抛出并捕获该异常
在业务逻辑中，当检测到数据不合法时，应直接抛出 ValidationException。捕获方可以根据 getFieldName() 的值决定是返回局部字段错误还是整体请求失败，从而实现细粒度的错误反馈。
// 业务层抛出示例
if (age < 0 || age > 150) {
throw new ValidationException("age", "年龄必须在0到150之间");
}
// 捕获层处理示例
try {
userService.createUser(userDto);
} catch (ValidationException e) {
if (e.getFieldName() != null) {
// 处理字段级错误，例如返回 JSON: {"field": "age", "error": "..."}
System.out.println("Field Error: " + e.getFieldName() + " - " + e.getMessage());
} else {
// 处理全局错误
System.out.println("Global Error: " + e.getMessage());
}
}
在实际使用中，userService.createUser 内部会进行参数校验。如果年龄超出范围，抛出带字段名的异常。捕获块中通过检查 fieldName 是否为空，区分错误类型。这种设计使得 API 响应能够精确指向出错字段，提升用户体验和调试效率。
基于 fieldName 为 null 时的行为差异问题
当 ValidationException 的 fieldName 为 null 时，表示该异常不属于任何特定字段，而是涉及整个对象或业务流程的全局校验失败。此时，错误信息通常描述的是整体约束条件，如“用户已存在”或“权限不足”，而非某个输入字段的格式问题。
