Java中try-with-resources标准写法要求资源实现AutoCloseable接口、声明在try括号内、多资源用分号分隔、按依赖顺序声明（底层资源在前），关闭顺序相反，异常被抑制可获知，自定义资源需幂等且不抛受检异常。
Java 中 try-with-resources 的标准写法，核心是让资源自动关闭、避免手动调用 close()，同时保证可读性、异常处理得当、资源声明清晰。关键在于：资源必须实现 AutoCloseable 接口；资源声明写在 try 括号内；多个资源用分号分隔；异常传播逻辑要明确。
资源声明必须在 try 括号内，且类型明确
不能把变量声明放在 try 外再传入，也不能用泛型擦除后的原始类型（如 InputStream 而非具体子类）掩盖实际类型。推荐显式写出具体类型或使用 var（Java 10+），但需确保上下文清晰。
✅ 正确示例：
try (FileInputStream fis = new FileInputStream("a.txt");
BufferedInputStream bis = new BufferedInputStream(fis);
InputStreamReader isr = new InputStreamReader(bis, StandardCharsets.UTF_8)) {
// 使用 isr 读取
}
❌ 错误示例（声明在外部）：
FileInputStream fis = new FileInputStream("a.txt"); // 手动管理，违背规范
try {
// ...
} finally {
fis.close(); // 容易遗漏或异常干扰
}
多个资源按依赖顺序声明，从外到内或按创建顺序
资源关闭顺序与声明顺序相反（后声明的先关闭），因此要确保依赖关系不被破坏。例如，BufferedInputStream 包裹 FileInputStream，应先声明 FileInputStream，再声明包装它的流。
✅ 推荐顺序（底层资源在前）：
-
FileInputStream（最底层，持有文件句柄） -
BufferedInputStream（包装它，依赖前者） -
InputStreamReader（再包装，依赖缓冲流）
这样关闭时：ISR → BufferedIS → FileInputStream，符合资源释放逻辑。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
异常处理要区分“业务异常”和“关闭异常”
try-with-resources 中，如果 try 块抛出异常，且资源关闭也抛出异常，后者会被抑制（suppressed），主异常仍被抛出。可通过 exception.getSuppressed() 获取被抑制的异常。
✅ 必要时记录或处理抑制异常：
try (InputStream is = Files.newInputStream(Paths.get("data.txt"))) {
// 读取逻辑
} catch (IOException e) {
for (Throwable suppressed : e.getSuppressed()) {
System.err.println("Suppressed during close: " + suppressed);
}
throw e; // 重新抛出主异常
}
⚠️ 注意：不要在 catch 块中直接吞掉异常，也不要在 finally 里重复 close（会报错或空指针）。
自定义资源需正确实现 AutoCloseable，并在 close() 中处理幂等与异常
若封装了非标准资源（如数据库连接池租借的连接、本地内存句柄），需自行实现 AutoCloseable，并确保 close() 方法满足：
- 幂等：多次调用不报错、不重复释放
- 不抛出受检异常（最好也不抛运行时异常，或至少文档说明）
- 释放所有关联资源（如内部持有的流、锁、句柄）
✅ 示例片段：
public class ManagedResource implements AutoCloseable {
private boolean closed = false;
@Override
public void close() {
if (!closed) {
// 执行释放逻辑（如释放 native handle）
closed = true;
}
}
}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
