在java中配置支持租户隔离和审计的数据库连接池,核心在于通过自定义拦截器或过滤器捕获sql执行上下文,并将租户标识注入到连接属性中,同时记录关键操作日志。以hikaricp为例,可以通过实现`connectioncustomizer`接口来在连接获取时设置租户schema或session变量,并结合aop或日志框架对sql语句进行审计记录。

如何配置HikariCP以支持多租户Schema切换
HikariCP本身不直接提供多租户支持,但可以通过`ConnectionCustomizer`接口在连接从池中借出和归还时执行自定义逻辑。具体做法是实现该接口,在`beforeConnect`方法中根据当前线程的租户上下文(如ThreadLocal)执行`SET SCHEMA`或类似命令,从而确保每个连接都绑定到正确的租户数据空间。

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import com.zaxxer.hikari.pool.ConnectionCustomizer;
public class TenantHikariConfig {
public static HikariDataSource createTenantDataSource() {
HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/mydb");
config.setUsername("user");
config.setPassword("pass");
// 注册自定义连接定制器
config.addDataSourceProperty("connectionCustomizerClassName",
"com.example.TenantConnectionCustomizer");
return new HikariDataSource(config);
}
}
import com.zaxxer.hikari.pool.ConnectionCustomizer;
import java.sql.Connection;
public class TenantConnectionCustomizer implements ConnectionCustomizer {
@Override
public void beforeConnect(Connection connection, String poolName) throws SQLException {
String tenantId = TenantContext.getCurrentTenantId();
if (tenantId != null) {
// 假设使用MySQL,切换到对应租户schema
connection.createStatement().execute("USE " + tenantId);
}
}
@Override
public void afterConnect(Connection connection, String poolName) {
// 连接已建立,无需额外操作
}
@Override
public void afterExecute(Connection connection) {
// 连接即将返回池中,无需清理,因为每次使用前都会重置
}
@Override
public void afterRollback(Connection connection) {
// 事务回滚后,可选:重置会话状态
}
}
上述代码展示了如何配置HikariCP并实现一个基本的租户切换逻辑。当应用请求获取连接时,`beforeConnect`会被调用,此时可以根据当前线程中的租户ID执行SQL来切换Schema。这种方式简单直接,适用于基于Schema隔离的多租户架构。需要注意的是,如果租户数量巨大,频繁执行`USE`语句可能会带来性能开销,此时可考虑使用表前缀或独立数据库等其他隔离策略。
如何实现SQL执行的审计日志记录
为了实现SQL审计,可以在连接池层面或通过MyBatis等ORM框架的拦截器来捕获SQL语句。这里展示一种基于HikariCP和SLF4J日志框架的简单审计方案,通过在`afterExecute`或`afterRollback`中记录SQL执行信息,或者更推荐的方式是使用MyBatis的Interceptor。以下是一个基于MyBatis Interceptor的示例,它可以在SQL执行前后记录租户ID和SQL语句。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import org.apache.ibatis.executor.statement.StatementHandler;
import org.apache.ibatis.plugin.*;
import java.sql.Statement;
import java.util.Properties;
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Statement.class, Integer.class})})
public class AuditInterceptor implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
long startTime = System.currentTimeMillis();
StatementHandler handler = (StatementHandler) invocation.getTarget();
String sql = handler.getBoundSql().getSql();
String tenantId = TenantContext.getCurrentTenantId();
// 记录审计日志
System.out.println("[AUDIT] Tenant: " + tenantId + ", SQL: " + sql);
Object result = invocation.proceed();
long endTime = System.currentTimeMillis();
System.out.println("[AUDIT] Duration: " + (endTime - startTime) + "ms");
return result;
}
@Override
public Object plugin(Object target) {
return Plugin.wrap(target, this);
}
@Override
public void setProperties(Properties properties) {
// 可以在此处读取配置属性
}
}
这个MyBatis拦截器会在SQL执行前捕获SQL语句和当前租户ID,并记录到控制台(实际项目中应使用日志框架)。这种方式比在连接池层面做审计更灵活,因为它可以直接访问MyBatis的元数据,包括参数、SQL类型等。结合之前的HikariCP配置,可以实现完整的租户隔离和审计功能。
当租户ID为空时连接池如何处理
当`TenantContext.getCurrentTenantId()`返回空值时,上述`TenantConnectionCustomizer`中的`beforeConnect`方法会跳过`USE`语句的执行,这意味着连接将保持默认Schema。这种行为是安全的,因为不会尝试执行无效的SQL。然而,这可能导致数据访问错误,如果应用期望所有查询都在特定租户Schema下执行。因此,建议在`beforeConnect`中添加校验逻辑,如果租户ID为空且系统要求强制租户隔离,则抛出异常阻止连接获取,从而避免潜在的数据泄露风险。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










