Java中如何规范处理IOException？异常处理代码优化求助

嗨，你的老师说得很对——直接用System.out.println打印异常确实是个坏毛病：不仅错误信息模糊到没法定位问题（比如是文件找不到？权限不够？还是读取中途出错？），还会悄悄把异常吞掉，上层调用者拿到空列表时，可能误以为读取成功了，进而引发后续逻辑的bug。下面给你几个实用的改进方案，你可以根据自己的场景选择：

1. 抛出自定义异常（最推荐） #

这种方式能让上层代码明确感知到错误，并且可以根据异常类型做针对性处理（比如提示用户重新输入文件名，或者重试读取）。同时我们还可以用try-with-resources语法自动关闭流，避免手动关闭时可能出现的资源泄漏。

首先定义一个专门的自定义异常：

public class HighscoreReadException extends Exception {
    // 带错误信息和原始异常的构造方法，保留异常栈轨迹方便排查
    public HighscoreReadException(String message, Throwable cause) {
        super(message, cause);
    }
}

然后修改你的读取方法：

import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class HighscoreHandler {
    public static List<Highscore> readHighScoreTable(String fileName) throws HighscoreReadException {
        List<Highscore> result = new ArrayList<>();
        
        // try-with-resources：自动关闭BufferedReader，不管是否发生异常
        try (BufferedReader reader = new BufferedReader(new FileReader(fileName))) {
            String line;
            while ((line = reader.readLine()) != null) {
                // 这里放你原来的行解析代码
            }
        } catch (IOException ioe) {
            // 把原始IOException包装成自定义异常抛出，带上具体的文件名和错误信息
            throw new HighscoreReadException("读取高分表文件 '" + fileName + "' 失败", ioe);
        }
        
        return result;
    }
}

调用这个方法时，上层代码就可以通过try-catch捕获HighscoreReadException，给用户清晰的提示，或者做其他处理。

2. 记录详细日志（适合不想抛出异常的场景） #

如果你的业务逻辑允许读取失败时返回空列表，那至少要把异常的详细信息记录到日志里，而不是只打印一句没用的话。日志会包含异常的栈轨迹，方便你排查问题。

这里以Java自带的java.util.logging为例：

import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import java.util.logging.Logger;

public class HighscoreHandler {
    // 初始化日志记录器，绑定当前类
    private static final Logger logger = Logger.getLogger(HighscoreHandler.class.getName());

    public static List<Highscore> readHighScoreTable(String fileName) {
        List<Highscore> result = new ArrayList<>();
        
        try (BufferedReader reader = new BufferedReader(new FileReader(fileName))) {
            String line;
            while ((line = reader.readLine()) != null) {
                // 行解析代码
            }
        } catch (IOException ioe) {
            // 记录详细的错误信息，包括文件名和异常栈
            logger.severe(String.format("读取高分表文件 '%s' 失败: %s", fileName, ioe.getMessage()));
            // 打印完整的异常栈轨迹
            logger.severe("异常详情:", ioe);
        }
        
        return result;
    }
}

3. 返回包含状态的结果对象（兼顾灵活性） #

如果你不想抛出异常，又想让上层代码知道是否读取成功，可以定义一个通用的Result类，把数据、错误信息和异常都封装进去：

// 通用结果类，用来包装返回数据和错误信息
public class Result<T> {
    private T data;
    private String errorMessage;
    private Throwable error;

    // 私有构造方法，用静态方法创建实例
    private Result() {}

    // 创建成功结果
    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.data = data;
        return result;
    }

    // 创建失败结果
    public static <T> Result<T> failure(String message, Throwable error) {
        Result<T> result = new Result<>();
        result.errorMessage = message;
        result.error = error;
        return result;
    }

    // getter方法
    public T getData() { return data; }
    public String getErrorMessage() { return errorMessage; }
    public Throwable getError() { return error; }
    public boolean isSuccess() { return data != null && errorMessage == null; }
}

然后修改读取方法：

public static Result<List<Highscore>> readHighScoreTable(String fileName) {
    List<Highscore> result = new ArrayList<>();
    
    try (BufferedReader reader = new BufferedReader(new FileReader(fileName))) {
        String line;
        while ((line = reader.readLine()) != null) {
            // 行解析代码
        }
        return Result.success(result);
    } catch (IOException ioe) {
        String message = String.format("读取高分表文件 '%s' 失败", fileName);
        return Result.failure(message, ioe);
    }
}

调用时，上层代码可以通过isSuccess()判断是否读取成功，再分别处理：

Result<List<Highscore>> readResult = HighscoreHandler.readHighScoreTable("highscores.txt");
if (readResult.isSuccess()) {
    // 处理高分数据
} else {
    // 处理错误，比如提示用户
    System.out.println(readResult.getErrorMessage());
    // 也可以记录日志
    logger.severe(readResult.getErrorMessage(), readResult.getError());
}

内容的提问来源于stack exchange，提问作者STG