@TransactionalEventListener为何以DEBUG级别记录错误？如何改ERROR级别？

为什么会以DEBUG级别记录错误？ #

Spring的TransactionSynchronizationUtils类在处理事务完成后的同步回调（包括@TransactionalEventListener的执行逻辑）时，设计逻辑是回调异常不应该干扰主事务的最终结果。所以当回调抛出异常时，框架会捕获异常并仅以DEBUG级别记录日志，同时吞噬异常——避免回调的错误影响主流程的正常结束。这种设计是为了保证事务最终一致性不受后续回调失败的干扰，但也导致生产环境中这类错误容易被忽略。

如何改为ERROR级别记录？ #

有几种可行的解决方案，可根据场景选择：

1. 方法内部手动处理异常 #

在@TransactionalEventListener方法内部捕获异常，自行用ERROR级别日志记录，确保错误被醒目输出：

import org.slf4j.LoggerFactory
import org.springframework.transaction.event.TransactionalEventListener
import org.springframework.transaction.annotation.Transactional

private val log = LoggerFactory.getLogger(YourClass::class.java)

@TransactionalEventListener
@Transactional
fun handle(event: TestEvent) {
    try {
        // 业务逻辑
        throw Exception("test3")
    } catch (e: Exception) {
        log.error("处理TestEvent失败", e)
        // 若需要让异常继续传播（仍会被Spring捕获，但日志已手动输出）
        throw e
    }
}

2. 通过日志框架规则提升级别 #

如果不想修改业务代码，可通过日志框架（如Logback、Log4j2）的配置，将TransactionSynchronizationUtils类中特定的DEBUG日志提升为ERROR级别。以Logback为例，添加自定义过滤器：

<configuration>
    <!-- 其他原有配置 -->
    <logger name="org.springframework.transaction.support.TransactionSynchronizationUtils" level="DEBUG">
        <appender-ref ref="YOUR_APPENDER"/>
        <!-- 过滤出目标错误日志 -->
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">
            <evaluator>
                <expression>message.contains("TransactionSynchronization.afterCompletion threw exception")</expression>
            </evaluator>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMatch>
        </filter>
        <!-- 将级别改为ERROR -->
        <filter class="ch.qos.logback.classic.filter.LevelChangeFilter">
            <level>ERROR</level>
        </filter>
    </logger>
</configuration>

这段配置会把包含指定消息的DEBUG日志改为ERROR级别输出，其他无关DEBUG日志会被过滤。

3. 自定义事务同步处理器（进阶） #

通过扩展Spring事务同步机制，替换默认的异常处理逻辑。自定义TransactionSynchronization实现，在afterCompletion方法中自行处理异常日志，这种方式适合有一定Spring框架经验的场景。

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