Spring Boot升级后启动报错求助：缺失RepositoryMethodInvocationListener类

问题根源 #

org.springframework.data.repository.core.support.RepositoryMethodInvocationListener在Spring Data 2021.0.x（对应Spring Boot 2.7.x的依赖版本）中已被移除/重构，你的项目出现这个错误，大概率是以下两种情况：

• 项目中存在手动指定的Spring Data版本，与Spring Boot 2.7.16的内置依赖版本冲突
• 自定义代码或第三方依赖直接引用了这个已被移除的类

排查与修复步骤 #

1. 对齐Spring Data版本（优先处理） #

Spring Boot的依赖管理会自动维护兼容的Spring Data版本，禁止手动指定Spring Data相关组件的版本。检查你的build.gradle：

• 移除所有手动设置的Spring Data版本，比如：

  // 删除这类手动版本配置
  // ext['spring-data-releasetrain.version'] = 'Hopper-SR10'
  // implementation 'org.springframework.data:spring-data-jpa:2.3.4.RELEASE'
  

• 改用Spring Boot提供的starter依赖，比如：

  implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
  

2. 检查自定义代码引用 #

搜索项目中是否有代码直接引用了RepositoryMethodInvocationListener：

• 如果存在，替换为Spring Data 2021.0+中的替代方案：
  • 若用于监听仓库方法调用，可使用RepositoryInvocationListener接口
  • 或通过@RepositoryEventHandler注解实现事件监听逻辑

3. 排查第三方依赖冲突 #

执行Gradle依赖分析命令，找出引入旧版本Spring Data的第三方库：

./gradlew dependencyInsight --dependency spring-data-commons

找到冲突的依赖后，在build.gradle中排除旧版本的Spring Data组件，示例：

dependencies {
    implementation('com.example:some-third-party-lib:1.0.0') {
        exclude group: 'org.springframework.data', module: 'spring-data-commons'
    }
}

4. 清理并重新构建 #

执行以下命令清理缓存并重新构建项目：

./gradlew clean build

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