Java Throws最佳实践是什么

在 Java 中，throws 用于方法声明上，表示该方法可能抛出哪些受检异常（checked exception），交给调用者处理。合理使用 throws 是写出健壮、可维护代码的重要一环。下面从原则、常见误区和最佳实践三个层面来说明。

一、核心原则（先记住这 3 条）

1. 只 throws 你“处理不了”的异常
2. 不要滥用 throws Exception
3. 异常是方法签名的一部分，要稳定、清晰

二、最佳实践详解

✅ 1. 只抛出调用者“需要知道”的异常

如果一个异常在当前方法中无法合理处理，才使用 throws。

public void saveUser(User user) throws IOException {
    Files.write(path, user.toString().getBytes());
}

✅ 合理：IO 异常不是 saveUser 能处理的

❌ 不合理：

public void saveUser(User user) throws Exception {
    ...
}

✅ 2. 避免 throws Exception（非常关键）

throws Exception 的问题：

• 掩盖真实问题
• 调用者无法判断该处理什么
• 破坏 API 可读性

❌ 不推荐：

public void process() throws Exception {
    ...
}

✅ 推荐：

public void process() throws IOException, SQLException {
    ...
}

✅ 3. 受检异常 vs 运行时异常（重点）

✅ 示例：

public void divide(int a, int b) {
    if (b == 0) {
        throw new IllegalArgumentException("除数不能为 0");
    }
}

✅ 不需要 throws

✅ 4. 高层统一处理异常（分层架构）

底层 throws，高层 catch

// DAO
public User findById(Long id) throws SQLException {
    ...
}

// Service
public User getUser(Long id) {
    try {
        return dao.findById(id);
    } catch (SQLException e) {
        throw new ServiceException("查询用户失败", e);
    }
}

✅ 好处：

• 业务层不关心底层技术细节
• 异常可被统一包装

✅ 5. 不要吞掉异常（非常常见错误）

❌ 错误示例：

public void read() throws IOException {
    try {
        ...
    } catch (IOException e) {
        // 什么都不做
    }
}

✅ 正确做法：

• 重新抛出
• 或包装后抛出
• 或记录日志

✅ 6. 异常包装（Exception Wrapping）

当底层异常不适合暴露给上层时：

throw new BusinessException("用户保存失败", e);

✅ 保留原始异常（cause） ✅ 提高可读性

✅ 7. 方法签名要稳定

throws 是 API 的一部分：

• 一旦公开，修改成本很高
• 新增受检异常是破坏性变更

✅ 建议：

• 公共 API 尽量使用运行时异常
• 或自定义业务异常

三、常见误区总结

四、一句话总结

throws 不是用来“甩锅”的，而是用来“明确责任边界”的。

如果你愿意，我可以：

• ✅ 帮你判断某个方法该不该 throws
• ✅ 对比 throws vs try-catch
• ✅ 给你一个真实项目中的异常设计示例