数据异常处理

在 Java 中,"数据异常"通常指数据不符合预期导致的程序错误或业务异常,涵盖从底层数据类型错误到上层业务逻辑校验失败的各种情况。以下是常见场景及处理方案:

一、常见数据异常类型及示例

  1. 基础数据类型/转换异常

异常类型 原因 示例代码

"NullPointerException" 对

"null" 数据进行操作(如调用方法、访问属性)

"String s = null; s.length();"

"NumberFormatException" 字符串转数字失败(格式错误)

"Integer.parseInt("abc");"

"ClassCastException" 强制类型转换不匹配

"Object o = "str"; Integer i = (Integer) o;"

"ArithmeticException" 数学运算错误(如除零)

"int a = 10 / 0;"

  1. 集合/数组数据异常

异常类型 原因 示例代码

"IndexOutOfBoundsException" 索引越界(数组/List)

"List list = new ArrayList<>(); list.get(0);"

"ConcurrentModificationException" 迭代集合时修改结构(非线程安全集合)

"for (String s : list) { list.add("a"); }"

  1. 业务数据异常(自定义)

数据不符合业务规则(如参数为空、范围超限、状态冲突):

// 例:用户年龄非法(<0 或 >150)

if (age < 0 || age > 150) {

throw new IllegalArgumentException("年龄必须在 0-150 之间");

}

  1. 外部数据异常(数据库/接口)

场景 常见异常

数据库操作

"SQLException"(连接失败、SQL语法错误、约束冲突)

JSON解析

"JsonParseException"(格式错误)、

"JsonMappingException"(字段映射失败)

文件读取

"IOException"(文件不存在、权限不足)

二、数据处理最佳实践

  1. 防御性编程(提前校验数据)

// 1. 判空(避免 NPE)

public void process(String data) {

if (data == null || data.trim().isEmpty()) {

throw new IllegalArgumentException("数据不能为空");

}

// 处理逻辑

}

// 2. 使用 Optional 优雅处理 null

Optional.ofNullable(data)

.filter(s -> !s.isEmpty())

.orElseThrow(() -> new IllegalStateException("数据为空"));

  1. 安全转换(避免转换异常)

// 字符串转数字(安全方式)

public static Integer safeParseInt(String str, Integer defaultValue) {

try {

return Integer.parseInt(str);

} catch (NumberFormatException e) {

return defaultValue; // 或记录日志后返回默认值

}

}

  1. 自定义业务异常(明确异常语义)

// 定义业务异常类

public class DataValidationException extends RuntimeException {

private final String errorCode;

public DataValidationException(String message, String errorCode) {

super(message);

this.errorCode = errorCode;

}

}

// 使用

if (order.getAmount() <= 0) {

throw new DataValidationException("订单金额必须大于0", "ORDER_AMOUNT_INVALID");

}

  1. 统一异常处理(Spring 项目)

@RestControllerAdvice

public class GlobalExceptionHandler {

@ExceptionHandler(DataValidationException.class)

public ResponseEntity<?> handleDataValidation(DataValidationException e) {

return ResponseEntity.badRequest()

.body(Map.of("code", e.getErrorCode(), "msg", e.getMessage()));

}

@ExceptionHandler(NullPointerException.class)

public ResponseEntity<?> handleNPE(NullPointerException e) {

log.error("空指针异常", e); // 记录详细日志

return ResponseEntity.status(500).body("系统内部错误");

}

}

  1. 数据库/外部接口异常处理

// 数据库操作(Spring JDBC)

try {

jdbcTemplate.update("INSERT INTO user(name) VALUES(?)", name);

} catch (DataIntegrityViolationException e) {

// 唯一键冲突、非空约束等

throw new DataValidationException("用户名已存在", "USER_NAME_DUPLICATE");

} catch (SQLException e) {

// 数据库连接失败等

log.error("数据库操作失败", e);

throw new RuntimeException("系统繁忙,请稍后再试");

}

三、关键注意事项

  1. 异常粒度:避免捕获
    "Exception" 后不处理(至少记录日志),区分可恢复异常(如参数错误)和不可恢复异常(如数据库连接失败)。
  2. 日志规范:异常日志需包含上下文信息(如用户ID、请求参数),方便排查:
    log.error("处理用户{}的数据失败,参数:{}", userId, params, e); // 第三个参数是异常对象
  3. 避免"吞异常":不要只捕获异常而不处理(如
    "catch (Exception e) {}"),至少记录日志或向上抛出。
  4. 数据校验前置:在 Controller 层用
    "@Validated" 注解校验参数(如
    "@NotNull"、
    "@Min"),减少 Service 层冗余校验:
    @PostMapping("/user")
    public void createUser(@RequestBody @Validated UserDTO userDTO)

public class UserDTO {

@NotNull(message = "用户名不能为空")

@Size(min = 2, max = 20, message = "用户名长度2-20位")

private String username;

}

四、典型场景解决方案

场景 解决方案

批量数据处理(如Excel导入) 逐条校验,记录失败行号+原因,返回汇总结果

分布式系统数据一致性 用事务(

"@Transactional")+ 重试机制(如 Spring Retry)

大数量查询(避免OOM) 分页查询(

"LIMIT")、流式处理(

"ResultSet" 游标)

如果需要针对具体场景(如 JSON 解析、数据库约束、并发数据冲突)进一步分析,可以补充说明你的具体问题哦! 😊