在 javafx 应用中，应避免长期持有单个 `connection` 实例，而应在每次数据库操作时按需创建、使用并自动关闭连接（推荐 try-with-resources）；所有耗时的数据库操作必须在后台线程（如 `task
JavaFX 是单线程 GUI 框架，主线程（JavaFX Application Thread）专用于渲染界面和处理用户事件。若将数据库操作（如查询、增删改）直接放在主线程中执行，会导致界面卡顿甚至无响应。因此，连接管理 + 异步执行是 JavaFX 数据库开发的两大核心原则。
✅ 正确的连接管理方式：按需创建，自动释放
不推荐全局共享单一 Connection 实例，原因如下：
- JDBC Connection 不是线程安全的，多线程并发访问易引发状态混乱或异常；
- 长期空闲连接可能被数据库服务器主动断开（如 MySQL 的 wait_timeout），导致后续操作抛出 SQLException；
- 连接池（如 HikariCP）才是生产环境的标配，但即便使用连接池，也应遵循“获取→使用→归还”模式，而非跨方法/控制器长期持有。
✅ 推荐做法：封装连接获取逻辑，并结合 try-with-resources 确保资源自动释放：
public class Database {
private static final String URL = "jdbc:mysql://localhost:3306/myapp";
private static final String USER = "root";
private static final String PASS = "password";
public static Connection getConnection() throws SQLException {
return DriverManager.getConnection(URL, USER, PASS);
}
}在业务方法中，始终在 try-with-resources 中使用连接：
立即学习“Java免费学习笔记（深入）”；
public void loadUsers() {
Task<List<User>> task = new Task<>() {
@Override
protected List<User> call() throws Exception {
List<User> users = new ArrayList<>();
String sql = "SELECT id, name, email FROM users";
// 自动管理 Connection、Statement、ResultSet 生命周期
try (Connection conn = Database.getConnection();
PreparedStatement stmt = conn.prepareStatement(sql);
ResultSet rs = stmt.executeQuery()) {
while (rs.next()) {
users.add(new User(
rs.getLong("id"),
rs.getString("name"),
rs.getString("email")
));
}
}
return users;
}
};
// 绑定结果到 UI（必须在 JavaFX 线程中）
task.setOnSucceeded(e -> {
ObservableList<User> data = FXCollections.observableArrayList(task.getValue());
tableView.setItems(data);
});
task.setOnFailed(e -> {
Throwable error = task.getException();
Alert alert = new Alert(Alert.AlertType.ERROR, "加载用户失败: " + error.getMessage());
alert.showAndWait();
});
new Thread(task).start();
}⚠️ 注意事项与最佳实践
- 绝不手动调用 connection.close() 后再复用：一旦关闭，该连接对象即失效，再次使用会抛出异常；
- 避免静态 Connection 字段：如 private static Connection conn —— 这是典型反模式，极易引发线程安全与连接泄漏问题；
- 事务控制需显式管理：若多个 SQL 操作需原子性（如转账），应在同一 Connection 中开启事务（conn.setAutoCommit(false)）、统一提交/回滚，并确保 finally 或 try-with-resources 外显式关闭；
-
生产环境务必引入连接池：例如 HikariCP，可显著提升性能与稳定性。初始化示例：
HikariConfig config = new HikariConfig(); config.setJdbcUrl(URL); config.setUsername(USER); config.setPassword(PASS); config.setMaximumPoolSize(10); config.setConnectionTimeout(3000); public static final HikariDataSource dataSource = new HikariDataSource(config); // 使用时：try (Connection conn = dataSource.getConnection()) { ... } - ResultSet 数据需及时提取：ResultSet 依赖底层连接，不可跨 try-with-resources 块传递；务必在资源块内完成数据映射（如转为 User 对象列表），再返回给 UI 层。
综上，JavaFX 数据库开发的黄金法则是：短生命周期连接 + 后台线程执行 + 资源自动管理。这既符合 JDBC 规范，也契合 JavaFX 的线程模型，是构建健壮、响应迅速桌面应用的基础保障。
