已捕获SqlInvalidAuthorizationSpecException仍打印堆栈追踪的解决咨询

问题根源 #

你捕获了dataSource.getConnection()的异常，但日志里的堆栈追踪并非来自你的代码，而是HikariCP连接池初始化时内部打印的——HikariCP在创建连接池时会执行checkFailFast预检查连接，这个过程中抛出的异常会被Hikari自身的日志组件输出；另外，Spring在Bean构造阶段遇到异常时，即使你调用System.exit(1)，Spring的异常处理器也可能会记录该异常。

可行解决方案 #

方案1：通过日志配置过滤特定异常（推荐） #

直接在日志配置文件中屏蔽HikariCP或DB2驱动打印的SqlInvalidAuthorizationSpecException堆栈，只保留你自定义的错误提示。

以Logback为例，修改logback.xml：

<!-- 过滤HikariCP打印的凭证无效异常 -->
<logger name="com.zaxxer.hikari" level="ERROR">
    <appender-ref ref="CONSOLE"/>
    <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
        <evaluator>
            <!-- 匹配DB2凭证无效异常 -->
            <expression>return throwable instanceof com.ibm.db2.jcc.am.SqlInvalidAuthorizationSpecException;</expression>
        </evaluator>
        <onMatch>DENY</onMatch> <!-- 匹配到则拒绝输出 -->
        <onMismatch>NEUTRAL</onMismatch> <!-- 不匹配则正常处理 -->
    </filter>
</logger>

<!-- 可选：过滤DB2驱动自身打印的异常 -->
<logger name="com.ibm.db2.jcc" level="ERROR">
    <appender-ref ref="CONSOLE"/>
    <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
        <evaluator>
            <expression>return throwable instanceof com.ibm.db2.jcc.am.SqlInvalidAuthorizationSpecException;</expression>
        </evaluator>
        <onMatch>DENY</onMatch>
        <onMismatch>NEUTRAL</onMismatch>
    </filter>
</logger>

如果用Log4j2，配置类似，使用Filter标签实现异常过滤即可。

方案2：重构验证逻辑到启动后执行（更优雅） #

把连接验证从Bean构造方法移到Spring启动完成后的阶段（比如CommandLineRunner），避免Bean创建阶段的异常被Spring或Hikari的日志捕获。

重构后的AbstractClientService：

@Service
public class AbstractClientService implements ApplicationContextAware, CommandLineRunner {
    private ApplicationContext context;
    private static final Logger LOGGER = LogManager.getLogger(AbstractClientService.class);
    private final DataSource dataSource;
    private final String dbName;
    private JdbcTemplate jdbcTemplate;

    // 构造方法仅注入依赖，不做验证
    public AbstractClientService(DataSource dataSource, String dbName) {
        this.dataSource = dataSource;
        this.dbName = dbName;
    }

    @Override
    public void run(String... args) throws Exception {
        try {
            // 启动后验证连接
            dataSource.getConnection();
            this.jdbcTemplate = new JdbcTemplate(dataSource);
        } catch (SqlInvalidAuthorizationSpecException e) {
            LOGGER.error("Invalid credentials for DB: {}", dbName);
            // 用Spring提供的优雅退出方式
            int exitCode = SpringApplication.exit(context, () -> 1);
            System.exit(exitCode);
        } catch (SQLException e) {
            LOGGER.error("Exception occurred during {} initialization", dbName);
            int exitCode = SpringApplication.exit(context, () -> 1);
            System.exit(exitCode);
        }
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.context = applicationContext;
    }

    // 提供JdbcTemplate的访问方法
    public JdbcTemplate getJdbcTemplate() {
        return jdbcTemplate;
    }
}

同时修改配置类的Bean定义，传入数据库名称：

@Bean
public AbstractClientService fooDB(@Qualifier("DB2Foo") DataSource dataSource){
    return new AbstractClientService(dataSource, "DB2Foo");
}

@Bean
public AbstractClientService barDB(@Qualifier("DB2Bar") DataSource dataSource){
    return new AbstractClientService(dataSource, "DB2Bar");
}

方案3：临时调整日志级别（应急方案） #

在验证连接前后，临时关闭HikariCP和DB2驱动的日志，验证完成后恢复原级别，适合无法修改日志配置的场景：

public AbstractClientService(DataSource dataSource, String... name) {
    String dbName = Arrays.toString(name);
    // 获取目标日志器
    Logger hikariLogger = LogManager.getLogger("com.zaxxer.hikari");
    Logger db2Logger = LogManager.getLogger("com.ibm.db2.jcc");
    // 保存原始日志级别
    Level originalHikariLevel = hikariLogger.getLevel();
    Level originalDb2Level = db2Logger.getLevel();

    // 临时关闭日志输出
    hikariLogger.setLevel(Level.OFF);
    db2Logger.setLevel(Level.OFF);

    try {
        dataSource.getConnection();
    } catch (SqlInvalidAuthorizationSpecException e) {
        LOGGER.error("Invalid credentials for DB: {}", dbName);
        System.exit(1);
    } catch (SQLException e) {
        LOGGER.error("Exception occurred during {} initialization", dbName);
        System.exit(1);
    } finally {
        // 恢复原始日志级别
        if (originalHikariLevel != null) {
            hikariLogger.setLevel(originalHikariLevel);
        }
        if (originalDb2Level != null) {
            db2Logger.setLevel(originalDb2Level);
        }
    }
    this.jdbcTemplate = new JdbcTemplate(dataSource);
}

注意：该方案依赖具体日志实现（如Logback/Log4j2），多线程环境下存在风险，但启动阶段为单线程执行，可正常使用。

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