Java常见异常全面梳理(含分类+含义+典型场景)

java 异常体系核心分为 运行时异常（runtimeexception，非受检） 和 编译时异常（checked exception 受检），前者编译期无需强制捕获，由程序逻辑错误导致；后者编译期必须显式捕获/抛出，由外部环境（如io、网络、输入）异常导致。此外，还有错误（error） 属于jvm层面严重问题，通常无需程序处理。

区分「运行时异常（预防为主）、受检异常（强制处理）、jvm错误（提前规避）」

一、运行时异常（runtimeexception）—— 逻辑错误主导，预防优先，捕获兜底

继承自java.lang.runtimeexception，编译期无需强制处理，多由代码逻辑不严谨导致，核心处理原则是通过严谨的代码逻辑从根源避免，仅对无法预防的场景做捕获兜底。

1. nullpointerexception（npe）—— 开发最高频异常

• 核心含义：调用空对象的方法/属性、对空对象执行集合/数组操作，或自动拆箱空包装类
• 典型场景：object obj = null; obj.tostring();、integer num = null; int n = num;、方法返回null未判空直接使用
• 标准处理方式（按优雅度排序，从基础到高级）
  1. 基础方案：显式判空，对所有可能为null的对象执行非空校验；
  2. 优雅方案：java 8+ optional类，包装可能为null的对象，避免手动判空；
  3. 校验方案：使用objects.requirenonnull()做参数/对象非空校验，快速定位空指针源头；
  4. 开发规范：方法返回值尽量返回空集合/空对象（如collections.emptylist()），而非null，减少调用方判空成本。
• 核心代码示例

// 1. 显式判空
object obj = getobj();
if (obj != null) {
    obj.tostring();
}

// 2. optional优雅处理（推荐，无嵌套判空）
optional.ofnullable(getobj()).ifpresent(o -> o.tostring()); // 仅当非空时执行
string res = optional.ofnullable(getstr()).orelse("默认值"); // 空则返回默认值

// 3. 非空校验（参数/方法内对象，快速定位问题）
public void dowork(user user) {
    objects.requirenonnull(user, "用户对象不能为空");
    objects.requirenonnull(user.getname(), "用户名不能为空");
}

• 避坑点：切勿仅用if (obj != null)做多层嵌套判空（会导致代码臃肿），优先使用optional。

2. arrayindexoutofboundsexception —— 数组操作专属

• 核心含义：访问数组的索引超出有效范围（索引<0 或 索引>=数组长度）
• 典型场景：int[] arr = new int[3]; arr[3] = 10;、循环遍历数组时条件写为i <= arr.length
• 标准处理方式
  1. 核心原则：遍历数组始终以arr.length为边界，循环条件用i < arr.length；
  2. 根源规避：使用增强for循环遍历数组，无需手动操作索引，从源头避免越界；
  3. 前置校验：手动操作索引时，先校验索引合法性（index >= 0 && index < arr.length）。
• 核心代码示例

int[] arr = {1,2,3};
// 1. 增强for循环（推荐，无索引操作）
for (int num : arr) {
    system.out.println(num);
}

// 2. 手动索引操作（前置校验）
int index = 3;
if (index >= 0 && index < arr.length) {
    system.out.println(arr[index]);
} else {
    system.err.println("索引越界，合法索引0-" + (arr.length-1));
}

3. indexoutofboundsexception（含子类stringindexoutofboundsexception）

• 核心含义：访问集合/字符串的索引超出有效范围，是数组越界的「集合/字符串版」
• 典型场景：list<string> list = new arraylist<>(); list.get(0);、"java".substring(5)
• 标准处理方式
  1. 集合操作：遍历用增强for循环，手动获取元素前校验index < list.size()+集合非空（!list.isempty()）；
  2. 字符串操作：截取/获取字符前校验index < str.length()+字符串非空（!str.isblank()）；
  3. 工具辅助：使用org.apache.commons.lang3.stringutils/collectionutils，避免原生方法的越界问题。
• 核心代码示例

list<string> list = arrays.aslist("a", "b");
string str = "java";
int index = 4;

// 集合安全获取
if (!collectionutils.isempty(list) && index < list.size()) {
    system.out.println(list.get(index));
}

// 字符串安全截取（apache工具类，越界会返回空/原字符串，无异常）
string sub = stringutils.substring(str, 0, index); 

4. classcastexception —— 类型转换高频异常

• 核心含义：将对象强制转换为其实际运行时类型并非所属的类/接口（无继承/实现关系）
• 典型场景：object obj = new integer(10); string str = (string) obj;、泛型擦除后集合强转元素
• 标准处理方式
  1. 前置判断：转换前用instanceof校验对象实际运行时类型，再执行强转；
  2. 简化方案：java 14+ 模式匹配，一步完成「类型判断+强制转换」，简化代码；
  3. 根源规避：集合操作强制指定泛型（如list<string> list = new arraylist<>()），编译期拦截非目标类型元素。
• 核心代码示例

object obj = new integer(10);
// 1. 传统方式：instanceof判断+强转
if (obj instanceof string) {
    string str = (string) obj;
}

// 2. java14+ 模式匹配（推荐，少一层代码）
if (obj instanceof string str) {
    system.out.println(str.length());
}

// 3. 泛型规避（从根源避免）
list<string> list = new arraylist<>();
list.add("java");
// list.add(10); // 编译期直接报错，无法添加非string类型

5. inputmismatchexception —— scanner输入专属

• 核心含义：java.util.scanner读取数据时，输入数据类型与预期读取类型不兼容
• 典型场景：用scanner.nextint()读整数，用户输入字符串（“abc”）、小数（3.14）
• 标准处理方式（核心：清空输入缓冲区，避免死循环）
  1. 推荐方案：先判断再读取，使用scanner的hasnextxxx()系列方法匹配读取方法（hasnextint()对应nextint()）；
  2. 兜底方案：捕获异常后，必须调用scanner.next()清空缓冲区的无效数据；
  3. 万能方案：先读取原始字符串，再通过包装类手动转换，配合try-catch处理。
• 核心代码示例（推荐方案，无异常）

scanner scanner = new scanner(system.in);
int num = 0;
while (true) {
    system.out.print("请输入整数：");
    if (scanner.hasnextint()) {
        num = scanner.nextint();
        break; // 输入合法，退出循环
    } else {
        system.err.println("输入错误，仅支持整数！");
        scanner.next(); // 关键：清空缓冲区的无效数据，避免死循环
    }
}

6. arithmeticexception —— 数值计算错误

• 核心含义：算术运算中出现非法操作，整数除零/取模模数为0是最典型场景
• 典型场景：int a = 10 / 0;、10 % 0（注：浮点数除零结果为infinity，不会触发此异常）
• 标准处理方式
  1. 前置校验：对除法/取模的除数/模数做非零校验，从根源避免；
  2. 异常兜底：捕获异常后，根据业务返回默认值或抛出自定义提示，避免程序崩溃。
• 核心代码示例

int a = 10, b = 0;
int res = 0;
// 前置校验（推荐）
if (b != 0) {
    res = a / b;
} else {
    system.err.println("除数不能为零");
    res = 0; // 业务默认值
}

// 异常兜底（无法提前校验的场景）
try {
    res = a / b;
} catch (arithmeticexception e) {
    system.err.println("计算失败：除数不能为零");
    res = 0;
}

7. illegalargumentexception —— 参数非法通用异常

• 核心含义：方法接收到不符合业务要求的非法参数，是自定义方法参数校验的标准异常
• 典型场景：方法要求参数>0却传入-1、要求非空字符串却传入空串、collections.sort(null)
• 标准处理方式
  1. 主动抛出：方法入口处做参数校验，参数不合法时主动抛出该异常，并携带明确的错误提示；
  2. 工具辅助：使用objects/apache commons工具类简化参数校验，避免重复代码；
  3. 框架适配：spring项目可使用@valid/@notblank等注解做参数自动校验，无需手动判断。
• 核心代码示例

// 手动参数校验+主动抛出异常（推荐，语义清晰）
public void setage(int age) {
    if (age < 0 || age > 150) {
        throw new illegalargumentexception("年龄必须在0-150之间，当前值：" + age);
    }
    this.age = age;
}

// spring项目注解校验（简化代码）
public void adduser(@valid user user) {
    // user类中：@notblank(message = "用户名不能为空") private string name;
}

8. numberformatexception —— 数值格式转换错误

• 核心含义：将非数值格式的字符串转换为int/double/long等数值类型时触发
• 典型场景：integer.parseint("123a");、double.parsedouble("3.14.5");、前端传参非数值字符串后端直接转换
• 标准处理方式
  1. 异常捕获：转换时通过try-catch捕获异常，返回业务默认值或提示格式错误；
  2. 工具辅助：使用org.apache.commons.lang3.math.numberutils，转换失败返回默认值，无需手动捕获；
  3. 前置校验：转换前通过正则表达式校验字符串是否为合法数值（如^\\d+$匹配整数）。
• 核心代码示例

string str = "123a";
// 1. try-catch兜底
int num1 = 0;
try {
    num1 = integer.parseint(str);
} catch (numberformatexception e) {
    system.err.println("数值格式错误，默认值为0");
}

// 2. numberutils工具类（推荐，简化代码）
int num2 = numberutils.toint(str, 0); // 转换失败返回默认值0
double num3 = numberutils.todouble(str, 0.0);

9. concurrentmodificationexception —— 集合并发修改错误

• 核心含义：单/多线程中，遍历集合的同时执行结构性修改（增/删/修改集合容量）
• 典型场景：增强for循环遍历list时调用list.remove()、多线程同时操作非线程安全集合（arraylist/hashmap）
• 标准处理方式（分单/多线程场景）
  1. 单线程：使用迭代器（iterator） 遍历并修改，调用it.remove()，这是集合遍历修改的标准方式；
  2. 多线程：替换为线程安全集合（copyonwritearraylist替代arraylist、concurrenthashmap替代hashmap）；
  3. 兜底方案：遍历前将集合转为数组，或遍历过程中收集需要修改的元素，遍历完成后统一处理。
• 核心代码示例

list<string> list = new arraylist<>();
list.add("a"); list.add("b"); list.add("c");

// 1. 单线程安全修改（迭代器）
iterator<string> it = list.iterator();
while (it.hasnext()) {
    if ("a".equals(it.next())) {
        it.remove(); // 无异常，标准方式
    }
}

// 2. 多线程安全集合（直接替换，无需修改业务代码）
list<string> safelist = new copyonwritearraylist<>();
map<string, string> safemap = new concurrenthashmap<>();

10. unsupportedoperationexception —— 不支持的操作

• 核心含义：调用了对象未实现/不支持的方法，多为只读/固定长度对象的修改操作
• 典型场景：arrays.aslist(arr).add(1);（该list为固定长度）、对collections.unmodifiablelist()执行增删
• 标准处理方式
  1. 根源规避：若需修改数组转换的list，重新创建可修改集合（new arraylist<>(arrays.aslist(arr))）；
  2. 开发规范：使用集合前确认其类型，避免对只读集合执行修改操作；
  3. 前置判断：通过集合的class判断是否为可修改类型（兜底方案）。
• 核心代码示例

string[] arr = {"a", "b"};
// 错误：固定长度list，无法修改
// list<string> list = arrays.aslist(arr);
// 正确：重新创建可修改arraylist
list<string> list = new arraylist<>(arrays.aslist(arr));
list.add("c"); // 正常执行

二、受检异常（checked exception）—— 外部环境异常，强制处理，资源释放

继承自java.lang.exception（非runtimeexception子类），编译期必须通过try-catch捕获或throws声明抛出，多由程序外部环境异常导致（如文件不存在、网络断开），核心处理原则是强制捕获处理，核心操作是「释放资源+业务兜底」。

1. ioexception（及子类）—— io操作核心异常（最常用）

• 核心含义：所有io操作的通用异常父类，子类覆盖具体场景：filenotfoundexception（文件不存在）、socketexception（网络断开）、eofexception（文件提前结束）
• 典型场景：文件读写、流的打开/关闭、网络数据传输、控制台输入流操作
• 标准处理方式（核心：保证io资源100%释放）
  1. 优雅方案：java 7+ try-with-resources 语法（自动关闭实现autocloseable接口的资源，替代finally，推荐）；
  2. 传统方案：try-catch-finally，在finally块中手动关闭资源（需判空，避免空指针）；
  3. 业务兜底：捕获异常后记录日志，返回友好的业务提示（如“文件读取失败”），避免暴露底层异常。
• 核心代码示例（try-with-resources 自动释放资源，推荐）

// 流对象实现autocloseable，try代码块结束后自动关闭，无需手动finally
try (filereader fr = new filereader("test.txt");
     bufferedreader br = new bufferedreader(fr)) {
    string line;
    while ((line = br.readline()) != null) {
        system.out.println(line);
    }
} catch (filenotfoundexception e) {
    system.err.println("业务提示：文件不存在，请检查路径");
    log.error("文件读取失败，路径：test.txt", e); // 记录详细日志（含堆栈）
} catch (ioexception e) {
    system.err.println("业务提示：文件读取失败");
    log.error("文件读写异常", e);
}

• 关键子类：filenotfoundexception（优先捕获，精准定位文件问题）、socketexception（网络io，需增加重连逻辑）。

2. interruptedexception —— 线程中断协作异常

• 核心含义：线程处于可中断阻塞状态时，被其他线程调用interrupt()中断，是线程间的「协作中断信号」（非错误异常）
• 典型场景：线程执行thread.sleep()/object.wait()/countdownlatch.await()/thread.join()时被中断
• 关键特性：异常触发后，jvm会自动清除线程的中断状态（isinterrupted()返回false），切勿空catch吞掉异常（并发编程大忌）
• 标准处理方式（核心三原则：恢复状态/释放资源/优雅终止，分3种场景）
  1. 工具方法场景：捕获异常后恢复中断状态（thread.currentthread().interrupt()）+ 向上抛出异常，让上层调用方处理；
  2. 线程入口场景：捕获异常后立即释放资源（关闭流/释放锁）+ 直接终止线程（return）；
  3. 批量任务场景：恢复中断状态 + 跳过当前任务，让后续代码检测到中断并处理。
• 核心代码示例（工具方法+线程入口，最常用）

// 场景1：工具方法（不负责线程生命周期，向上抛出）
public void doblockingwork() throws interruptedexception {
    try {
        thread.sleep(5000);
    } catch (interruptedexception e) {
        thread.currentthread().interrupt(); // 恢复中断状态，让上层感知
        throw e; // 向上抛出
    }
}

// 场景2：线程入口（最终处理，释放资源+终止）
thread worker = new thread(() -> {
    filewriter writer = null;
    try {
        writer = new filewriter("log.txt");
        doblockingwork(); // 调用工具方法
    } catch (interruptedexception e) {
        system.out.println("收到中断请求，开始优雅终止");
        // 步骤1：释放资源
        if (writer != null) {
            try { writer.close(); } catch (ioexception ex) { log.error("资源释放失败", ex); }
        }
        // 步骤2：终止线程
        return;
    } catch (ioexception e) {
        log.error("io异常", e);
    }
});
worker.start();
worker.interrupt(); // 主线程触发中断

3. sqlexception —— 数据库jdbc操作专属

• 核心含义：执行数据库操作（增删改查、连接、关闭）时触发，覆盖连接失败、sql语法错误、表/字段不存在等场景
• 典型场景：数据库地址/账号密码错误、sql语句拼写错误、操作不存在的表、连接池耗尽
• 标准处理方式（核心：资源释放+事务回滚+隐藏敏感信息）
  1. 资源管理：使用try-with-resources自动关闭connection/statement/resultset（均实现autocloseable），避免数据库连接泄漏；
  2. 事务处理：异常时执行事务回滚（conn.rollback()），避免数据不一致；
  3. 日志与提示：记录详细日志（含sql语句、参数），返回通用业务提示（如“数据库操作失败”），避免暴露数据库地址/账号等敏感信息；
  4. 重试机制：对连接超时、网络抖动等临时异常，增加重试逻辑（配合guava retryer/spring retry）。
• 核心代码示例

string sql = "insert into user (name) values (?)";
// try-with-resources 自动关闭数据库资源
try (connection conn = dbutil.getconnection();
     preparedstatement pstmt = conn.preparestatement(sql)) {
    conn.setautocommit(false); // 关闭自动提交，开启事务
    pstmt.setstring(1, "test");
    pstmt.executeupdate();
    conn.commit(); // 提交事务
} catch (sqlexception e) {
    // 事务回滚
    if (conn != null) {
        try { conn.rollback(); } catch (sqlexception ex) { log.error("事务回滚失败", ex); }
    }
    log.error("sql执行失败，sql：{}", sql, e); // 记录详细日志
    system.err.println("业务提示：数据保存失败，请稍后重试"); // 通用提示
}

4. classnotfoundexception —— 类加载异常

• 核心含义：jvm在类加载过程中，无法找到指定全限定名的类文件（包名+类名）
• 典型场景：反射加载类时类名写错（class.forname("com.test.user")）、项目依赖缺失、classpath未包含该类
• 标准处理方式
  1. 基础排查：检查类的全限定名是否拼写正确（包名、类名大小写）；
  2. 环境检查：确认项目运行时的classpath包含该类的class文件/依赖包；
  3. 异常处理：捕获异常后记录详细日志（类名、classpath信息），返回明确的排查提示。
• 核心代码示例

try {
    class<?> cls = class.forname("com.test.user");
    object obj = cls.newinstance();
} catch (classnotfoundexception e) {
    log.error("类加载失败，类名：com.test.user，请检查类名/依赖", e);
    system.err.println("系统异常：类加载失败，请联系开发人员");
} catch (instantiationexception | illegalaccessexception e) {
    log.error("类实例化失败", e);
}

5. parseexception —— 日期/字符串解析异常

• 核心含义：对日期、自定义格式字符串进行解析/格式化时，输入格式与指定格式不匹配
• 典型场景：simpledateformat sdf = new simpledateformat("yyyy-mm-dd"); sdf.parse("2026/02/05")
• 标准处理方式
  1. 根源规避：统一数据格式，前端传参做格式限制（如日期仅允许yyyy-mm-dd）；
  2. 优雅方案：使用java 8+ 新日期时间api（localdate/datetimeformatter），线程安全且抛出更友好的datetimeparseexception（运行时异常）；
  3. 异常捕获：解析前校验输入格式，捕获异常后返回默认值或友好提示。
• 核心代码示例（推荐新日期api，替代传统simpledateformat）

string datestr = "2026/02/05";
// 传统方式（simpledateformat，非线程安全）
simpledateformat sdf = new simpledateformat("yyyy-mm-dd");
try {
    date date = sdf.parse(datestr);
} catch (parseexception e) {
    system.err.println("日期格式错误，请按yyyy-mm-dd输入");
}

// java8+ 新日期api（推荐，线程安全，异常更友好）
datetimeformatter formatter = datetimeformatter.ofpattern("yyyy-mm-dd");
try {
    localdate date = localdate.parse(datestr, formatter);
} catch (datetimeparseexception e) { // 运行时异常，无需强制捕获
    system.err.println("日期格式错误，请按yyyy-mm-dd输入");
}

三、jvm错误（error）—— 系统层面严重问题，提前规避，无需处理

继承自java.lang.error，属于jvm/系统层面的严重异常，程序无法捕获和恢复，一旦发生通常导致程序崩溃，核心处理原则是提前规避，通过代码优化/jvm调优/环境配置防止发生，无需在代码中手动捕获。

1. outofmemoryerror（oom）—— 内存溢出

• 核心含义：jvm堆内存、方法区、元空间等内存区域耗尽，无法为新对象分配内存
• 典型场景：无限循环创建大对象、集合存储大量数据未清理（内存泄漏）、jvm堆内存设置过小（-xmx配置不合理）、静态集合持有大量对象引用
• 标准规避方式
  1. 代码优化：及时释放无用对象引用（如集合使用后清空、避免静态集合存储业务数据），排查内存泄漏（使用mat/jprofiler工具）；
  2. jvm调优：合理设置堆内存参数（-xms初始堆 = -xmx最大堆，避免内存频繁扩容，如-xms2g -xmx2g），调整元空间大小（-xx:metaspacesize=256m）；
  3. 业务优化：采用分页查询/流式处理替代全量加载数据，避免一次性将大量数据加载到内存。

2. stackoverflowerror —— 栈溢出

• 核心含义：jvm方法调用栈的深度超过最大值，无限递归是最典型、最常见的场景
• 典型场景：无限递归调用方法（public void test() { test(); }）、方法调用链过长（多层级业务方法嵌套）
• 标准规避方式
  1. 代码优化：杜绝无限递归，检查递归方法的终止条件，确保能正常退出；若递归层级过深，改为循环实现（根本解决方案）；
  2. 调优辅助：调整jvm栈大小参数（-xss，如-xss1m），增大方法调用栈深度（谨慎使用，治标不治本）；
  3. 代码重构：将过长的方法调用链拆分为多个独立方法，减少嵌套层级。
• 避坑点：切勿依赖调整-xss解决问题，无限递归即使增大栈大小，最终仍会触发栈溢出。

3. noclassdeffounderror —— 类定义未找到

• 核心含义：编译期能找到类，但运行期jvm无法找到该类的字节码文件（与classnotfoundexception的核心区别：前者是运行期类加载失败，后者是编译/反射时类不存在）
• 典型场景：编译后删除了类的class文件、依赖的第三方包编译期存在但运行期缺失、maven/gradle依赖包版本冲突
• 标准规避方式
  1. 环境检查：确认项目运行时的classpath包含所有依赖包，编译后的class文件完整无缺失；
  2. 依赖管理：使用maven/gradle统一管理依赖，执行clean install清理并重新编译项目，避免依赖包缺失/冲突；
  3. 类加载器排查：避免自定义类加载器的加载范围冲突，确保类被jvm正确加载。

四、java 常见异常速查表（含核心处理方式，快速查阅）

五、java 异常处理通用最佳实践（所有场景均适用）

1. 切勿空catch吞掉异常：尤其是interruptedexception、io异常、sql异常，空catch会导致问题无法定位、资源泄漏、程序逻辑混乱；
2. 异常处理粒度适中：不要用一个try-catch捕获所有异常（如catch (exception e)），按异常类型细分处理，便于精准定位问题；
3. 资源释放是核心：涉及io、数据库、网络连接等资源的操作，必须保证资源释放（优先使用try-with-resources）；
4. 日志记录要完整：捕获异常时记录异常堆栈+业务上下文（如参数、sql语句），避免仅打印e.printstacktrace()；
5. 前端/用户提示要友好：隐藏底层异常细节（如数据库地址、sql语句），返回通用的业务提示（如“操作失败，请稍后重试”）；
6. 运行时异常以预防为主：通过判空、参数校验、索引检查等逻辑从根源避免，而非依赖try-catch；
7. 自定义异常语义清晰：复杂业务中自定义异常（继承exception/runtimeexception），让异常更贴合业务场景（如usernotexistexception），便于统一处理。
8. 运行时异常：重点在「预防」，通过严谨的代码逻辑（判空、参数校验、索引检查、泛型使用）避免，是日常bug排查的主要对象；
9. 受检异常：重点在「处理」，编译期强制捕获/抛出，需根据业务场景做兜底（如io异常关闭流、sql异常回滚事务）；
10. error：重点在「规避」，通过合理的jvm参数配置（如调整堆内存）、优化代码（避免无限递归）防止，程序无法处理；
11. 异常处理原则：切勿空catch吞掉异常（尤其是interruptedexception），异常处理的核心是「恢复状态、释放资源、优雅提示/终止」。

掌握以上异常的处理方式和通用原则，能大幅提升java代码的健壮性和可维护性，快速定位并解决开发中的各类异常问题，同时避免因异常处理不当导致的资源泄漏、程序崩溃、数据不一致等严重问题。

总结

到此这篇关于java常见异常全面梳理的文章就介绍到这了,更多相关java常见异常内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！