Spring Boot 2.7迁3.0遇JPA无法访问MappedSuperclass错误求助

问题核心分析 #

从错误日志看，存在两个关键问题：

1. 编译时仍在寻找javax.persistence下的类（如MappedSuperclass、GenerationType），说明依赖中仍有旧的Javax API残留，或配置未完全切换到Jakarta。
2. AddAttachmentPayload的setter方法找不到，虽然标注了Lombok的@Setter注解，但编译时未生成对应方法，大概率是Lombok依赖缺失或版本不兼容。

分步解决方案 #

1. 补充并升级Lombok依赖 #

你的AddAttachmentPayload使用了Lombok注解，但当前build.gradle中未添加Lombok依赖，导致编译时无法生成getter/setter。需添加兼容Spring Boot 3的Lombok版本：

dependencies {
    // ... 其他依赖
    // 添加Lombok
    implementation 'org.projectlombok:lombok:1.18.30'
    annotationProcessor 'org.projectlombok:lombok'
}

注意：Spring Boot 3要求Lombok版本≥1.18.24，建议使用最新稳定版。

2. 清理JPA依赖，确保完全切换到Jakarta #

• 移除手动添加的jakarta.persistence:jakarta.persistence-api注解处理器依赖，Spring Boot Starter Data JPA 3.x已默认引入兼容的Jakarta Persistence API，无需手动指定。
• 排查依赖树中的Javax残留：执行./gradlew dependencies，搜索javax.persistence，找到所有引入旧API的依赖，通过exclude排除。例如：

  implementation('某第三方依赖') {
      exclude group: 'javax.persistence', module: 'javax.persistence-api'
  }
  

3. 优化Querydsl配置 #

Spring Boot 3需使用支持Jakarta的Querydsl 5.x版本，同时清理冗余依赖：

// 确保querydslVersion为5.x，如5.0.0或更高
def querydslVersion = '5.0.0'

dependencies {
    // ... 其他依赖
    // Querydsl配置
    implementation "com.querydsl:querydsl-jpa:${querydslVersion}:jakarta"
    implementation "com.querydsl:querydsl-sql:${querydslVersion}"
    implementation "com.querydsl:querydsl-sql-spring:${querydslVersion}"
    implementation "com.querydsl:querydsl-core:${querydslVersion}"

    // 仅保留Jakarta版本的APT注解处理器
    annotationProcessor "com.querydsl:querydsl-apt:${querydslVersion}:jakarta"
    // 移除：annotationProcessor("jakarta.persistence:jakarta.persistence-api:3.1.0")
}

4. 检查代码中的注解替换 #

确保所有JPA相关注解已从javax.persistence.*替换为jakarta.persistence.*，例如：

• 替换import javax.persistence.Entity;为import jakarta.persistence.Entity;
• 替换import javax.persistence.MappedSuperclass;为import jakarta.persistence.MappedSuperclass;
• 检查@GeneratedValue、@ManyToOne等注解的包路径是否正确。

5. 清理编译缓存并重新构建 #

执行以下命令清理旧的编译文件和缓存，避免残留文件干扰：

./gradlew clean build

额外注意点 #

• AddAttachmentPayload类中导入了jakarta.persistence.Entity但未使用@Entity注解，建议移除该无用导入，避免编译时混淆。
• 若仍存在依赖冲突，可使用Gradle的dependencyInsight命令定位具体依赖来源：

  ./gradlew dependencyInsight --dependency javax.persistence-api
  

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