正确处理IOException需精准捕获、记录上下文、合理分级、避免敏感信息泄露。应使用try-with-resources管理资源，捕获后记录操作类型、目标路径、用户ID等关键信息，并根据影响选择ERROR、WARN或DEBUG级别日志，禁止拼接敏感数据，推荐占位符方式输出。示例中加载配置失败记为ERROR并封装为IllegalStateException，下载失败则按WARN记录用户和文件名。
在Java开发中，IOException 是最常见的检查异常之一，通常发生在文件读写、网络通信等I/O操作过程中。正确处理 IOException 并记录有意义的日志，对系统稳定性与故障排查至关重要。以下是一些实用的异常处理与日志记录实践。
1. 捕获并明确处理 IOException
不要忽略 IOException，也不要简单地用 printStackTrace() 输出。应根据业务场景决定是重试、返回默认值、向上抛出，还是转换为运行时异常。
示例：
try (FileInputStream fis = new FileInputStream("config.properties")) {
Properties props = new Properties();
props.load(fis);
// 处理配置
} catch (IOException e) {
log.error("加载配置文件失败，路径：config.properties", e);
throw new IllegalStateException("无法初始化配置", e);
}
说明：使用 try-with-resources 自动关闭资源，捕获异常后记录详细上下文，并封装为更合适的异常类型重新抛出。
2. 记录有用的上下文信息
日志的价值在于能帮助快速定位问题。仅记录“发生 IOException”没有意义，必须包含操作对象、路径、参数等关键信息。
立即学习“Java免费学习笔记（深入）”；
建议在日志中包含：
- 操作类型（如“读取文件”、“连接服务器”）
- 目标资源（文件路径、URL、主机地址）
- 相关参数或配置项
- 用户ID或请求ID（用于链路追踪）
log.warn("用户 {} 下载文件 {} 失败，目标路径不可访问", userId, fileName, e);
3. 区分错误级别并合理使用日志级别
根据异常的影响范围选择合适的日志级别：
- ERROR：严重故障，影响主流程，需立即关注（如关键文件无法读取）
- WARN：可恢复的异常或非核心功能失败（如缓存写入失败但主逻辑正常）
- DEBUG：调试用途，记录详细的I/O过程（如每次文件打开路径）
避免将所有 IOException 都记为 ERROR，否则日志会失去重点。
4. 避免敏感信息泄露
记录日志时注意不要暴露密码、密钥、用户隐私等敏感数据。
不推荐：
log.error("连接 " + url + " 失败，用户名=" + username + ", 密码=" + password, e);
推荐：
log.error("连接 {} 失败，用户 {}", url, username, e);
使用占位符方式，避免拼接敏感字段，同时提升性能。
基本上就这些。关键是：捕获要精准，日志要有上下文，级别要合理，信息要安全。做到这几点，IOException 的处理和日志记录就能真正发挥作用。
