使用createShared创建的Vert.x JDBCClient是否线程安全？

是的，通过JDBCClient.createShared(vertx, config)创建的JDBCClient实例（即JDBCClientImpl）具备线程安全性，多个线程可以无影响地共用同一个实例。

核心原因： #

• createShared方法创建的实例依赖共享数据源，JDBCClientImpl本身不存储线程相关的状态，所有操作都通过底层共享数据源处理。
• 底层的数据源（如常用的HikariCP连接池实现）本身是线程安全的，负责连接的分配、回收和池化管理，能安全处理多线程的连接请求。

需要注意的细节： #

虽然JDBCClient实例是线程安全的，但从客户端获取的SQLConnection实例并非线程安全。每个SQLConnection应该由单个线程（或Vert.x的单个事件循环）使用，避免跨线程操作同一个连接——这会导致不可预期的并发问题。在Vert.x的异步模型中，通常推荐在获取连接后，在同一个回调线程内完成所有数据库操作并释放连接。

示例代码： #

// 初始化共享JDBCClient实例
JDBCClient sharedClient = JDBCClient.createShared(vertx, dbConfig);

// 线程1使用同一个实例获取连接并操作
new Thread(() -> {
  sharedClient.getConnection(connRes -> {
    if (connRes.succeeded()) {
      try (SQLConnection conn = connRes.result()) {
        conn.query("SELECT * FROM users", queryRes -> {
          // 处理查询结果
        });
      }
    }
  });
}).start();

// 线程2使用同一个实例执行另一个操作
new Thread(() -> {
  sharedClient.getConnection(connRes -> {
    if (connRes.succeeded()) {
      try (SQLConnection conn = connRes.result()) {
        conn.update("INSERT INTO logs(content) VALUES(?)", List.of("user login"), updateRes -> {
          // 处理更新结果
        });
      }
    }
  });
}).start();

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