如何配置Spring应用在AOP切点表达式未匹配时启动失败？

针对你提到的问题——依赖Bean名称的切点不够安全，变更名称后切面静默失效，这里有几个可靠的方案来确保切点必须匹配到目标数据源，否则应用启动失败：

方案1：自定义注解标记目标数据源（最推荐） #

这个方案通过注解明确标记需要应用切面的数据源，同时在启动时验证存在至少一个标记的数据源，既类型安全又能快速定位问题：

步骤1：定义自定义注解 #

@Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
annotation class AuthAwareDataSource

步骤2：给目标数据源Bean添加注解 #

在你的数据源配置类中，给需要应用切面的数据源打上注解：

@Configuration
class DataSourceConfig {
    @Bean
    @AuthAwareDataSource
    fun myDataSource(): DataSource {
        // 你的数据源配置逻辑
    }

    // 第二个不需要应用切面的数据源，无需添加注解
    @Bean
    fun anotherDataSource(): DataSource {
        // 你的数据源配置逻辑
    }
}

步骤3：修改切面的切点表达式 #

把基于Bean名称的切点改成基于注解的，这样不管Bean名称怎么变更，只要标记了注解就会匹配：

@Configuration
@Aspect
class SqlAuthAopConfig {
    @AfterReturning(
        value = "@target(com.yourpackage.AuthAwareDataSource) && execution(java.sql.Connection javax.sql.DataSource+.getConnection(..))",
        returning = "connection"
    )
    fun initUser(connection: Connection) {
        // 原有逻辑保持不变
        val principal = SecurityContextHolder.getContext().authentication.principal as? MyUser ?: return
        connection.prepareStatement("BEGIN P_AUTH.SET_ID(?);END;").use { ps ->
            ps.setLong(1, principal.id)
            ps.execute()
        }
    }
}

步骤4：添加启动时验证逻辑 #

创建一个配置类，在应用启动时检查是否存在至少一个标记了@AuthAwareDataSource的DataSource Bean，没有则抛出异常终止启动：

@Configuration
class DataSourceValidationConfig {
    @Autowired
    private lateinit var applicationContext: ApplicationContext

    @PostConstruct
    fun validateAuthAwareDataSourcesExist() {
        val annotatedDataSources = applicationContext.getBeansWithAnnotation(AuthAwareDataSource::class.java)
        if (annotatedDataSources.isEmpty()) {
            throw IllegalStateException("No DataSource beans annotated with @AuthAwareDataSource found! The SqlAuthAopConfig aspect will not work correctly.")
        }
    }
}

方案2：直接验证切面切点的匹配情况 #

如果你不想引入自定义注解，可以直接在启动时验证你的切面切点是否能匹配到至少一个Bean的方法：

@Configuration
class AspectValidationConfig {
    @Autowired
    private lateinit var beanFactory: ListableBeanFactory

    @Autowired
    private lateinit var sqlAuthAopConfig: SqlAuthAopConfig

    @PostConstruct
    fun validateAspectPointcut() {
        // 获取切面中@AfterReturning注解的切点表达式
        val initUserMethod = sqlAuthAopConfig.javaClass.getMethod("initUser", Connection::class.java)
        val afterReturningAnnotation = initUserMethod.getAnnotation(AfterReturning::class.java)
        val pointcutExpression = afterReturningAnnotation.value

        // 解析切点并检查是否有匹配的Bean方法
        val pointcut = AspectJExpressionPointcut()
        pointcut.expression = pointcutExpression

        var hasMatchingBeans = false
        for (beanName in beanFactory.beanDefinitionNames) {
            val beanType = beanFactory.getType(beanName) ?: continue
            runCatching {
                beanType.getMethod("getConnection")
            }.onSuccess { method ->
                if (pointcut.matches(method, beanType)) {
                    hasMatchingBeans = true
                }
            }
        }

        if (!hasMatchingBeans) {
            throw IllegalStateException("The aspect pointcut '$pointcutExpression' does not match any DataSource.getConnection() methods! Application cannot start.")
        }
    }
}

这个方法会直接解析你的切面切点表达式，检查是否有Bean的getConnection方法能被匹配到，没有则抛出异常终止启动。

总结 #

方案1是最推荐的，它通过注解明确了切面的目标，类型安全，验证逻辑简单直接，能在启动阶段快速发现问题，避免因Bean名称变更导致的静默失效。

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