异常体系与分类

// ❌ 错误示范：捕获 OutOfMemoryError
try {
    byte[] huge = new byte[Integer.MAX_VALUE];
} catch (OutOfMemoryError e) {
    // OOM 后 JVM 状态不确定，继续运行更危险
    System.out.println("内存不够了，但程序继续...");
}
// 这段代码不仅无法真正解决问题，还可能让程序在不可预测的状态下继续执行

// ✅ 正确做法：预防而非治疗
// 1. 合理设置 JVM 参数（-Xmx, -Xms）
// 2. 避免内存泄漏（及时解除引用）
// 3. 使用软引用/弱引用
// 4. 如果真的 OOM，让程序崩溃并重启是更安全的选择

// 受检异常：编译器强制处理
public void importStudents(String filePath) {
    // 编译错误！未处理 IOException
    FileReader reader = new FileReader(filePath);  // FileNotFoundException
}

// 必须处理：
// 方式一：try-catch
public void importStudents(String filePath) {
    try {
        FileReader reader = new FileReader(filePath);
        // 读取文件逻辑...
    } catch (FileNotFoundException e) {
        System.err.println("文件不存在: " + filePath);
    }
}

// 方式二：throws 声明
public void importStudents(String filePath) throws IOException {
    FileReader reader = new FileReader(filePath);
    // 读取文件逻辑...
}

// 编译器不强制处理，但运行时可能炸
public double calculateAvgScore(int[] scores) {
    int sum = 0;
    for (int i = 0; i <= scores.length; i++) {  // 注意：<=
        sum += scores[i];  // 最后一次循环：ArrayIndexOutOfBoundsException
    }
    return (double) sum / scores.length;
}

public void readStudentFile(String path) {
    try {
        FileReader reader = new FileReader(path);   // ①
        BufferedReader br = new BufferedReader(reader);  // ②
        String line = br.readLine();   // ③
        System.out.println(line);      // ④
    } catch (FileNotFoundException e) {   // ⑤
        System.err.println("文件不存在");
    } catch (IOException e) {              // ⑥
        System.err.println("读取失败");
    }
}

public class StudentImporter {

    /**
     * 导入学生数据
     * @param filePath Excel 文件路径
     * @throws StudentImportException 导入失败的自定义异常
     */
    public void importStudentFromExcel(String filePath) throws StudentImportException {
        // === 可能的异常分类 ===

        // ① 受检异常：文件不存在 → 必须处理
        File file = new File(filePath);
        if (!file.exists()) {
            throw new StudentImportException("文件不存在: " + filePath,
                new FileNotFoundException(filePath));
        }

        // ② 受检异常：数据库连接失败 → 必须处理
        try (Connection conn = DataSource.getConnection()) {
            // ③ 非受检异常：空指针 → 代码逻辑问题
            List<String> rows = ExcelParser.parse(filePath);
            for (String row : rows) {
                Student student = parseRow(row);
                // ④ 非受检异常：参数不合法 → 提前校验
                if (student.getName() == null || student.getName().isEmpty()) {
                    throw new IllegalArgumentException("学生姓名不能为空");
                }
                saveToDatabase(conn, student);
            }
        } catch (SQLException e) {
            throw new StudentImportException("数据库操作失败", e);
        }
    }
}

// ❌ 错误：捕获所有异常，掩盖了真实的错误类型
try {
    studentDao.save(student);
    emailService.sendNotification(student);
    fileService.exportReport(student);
} catch (Exception e) {
    // 简单打印，无法区分是数据库错误、邮件错误还是文件错误
    e.printStackTrace();
}

// ✅ 正确：分别处理不同类型的异常
try {
    studentDao.save(student);
    emailService.sendNotification(student);
    fileService.exportReport(student);
} catch (SQLException e) {
    // 数据库异常：记录日志，通知 DBA
    logger.error("数据库保存学生失败: {}", student.getId(), e);
    throw new StudentServiceException("保存学生信息失败", e);
} catch (MessagingException e) {
    // 邮件异常：降级处理，不影响主流程
    logger.warn("邮件通知发送失败，学生已保存: {}", student.getId(), e);
} catch (IOException e) {
    // 文件异常：记录日志，稍后重试
    logger.error("导出报告失败: {}", student.getId(), e);
    retryQueue.add(new ExportTask(student));
}

// ❌ 错误：不应该捕获 Error
try {
    recursiveMethod(0);  // 可能 StackOverflowError
} catch (Error e) {      // 捕获 Error 是极其危险的行为
    System.out.println("继续运行");
}

// ✅ 正确：不要捕获 Error，让 JVM 处理
// 如果确实需要捕获，只能作为最后的防线（如记录日志后重新抛出）
try {
    recursiveMethod(0);
} catch (Error e) {
    logger.fatal("JVM 发生严重错误，即将退出", e);
    throw e;  // 必须重新抛出！
}

// ❌ 错误：对所有异常都用 try-catch 包起来
public String getStudentName(int id) {
    try {
        return studentDao.findById(id).getName();
    } catch (NullPointerException e) {  // 应该提前判空，而不是捕获 NPE
        return "未知";
    }
}

// ✅ 正确：用代码逻辑防御非受检异常
public String getStudentName(int id) {
    Student student = studentDao.findById(id);
    return student != null ? student.getName() : "未知";
}