Spring Boot 3迁移遇QueryDSL问题：无法访问MappedSuperclass

问题核心 #

从Spring Boot 2.7升级到3.0.4后，QueryDSL出现编译报错，本质原因是Spring Boot 3.x全面切换到Jakarta EE规范，原Java EE的javax.persistence包已被替换为jakarta.persistence，但当前依赖配置和代码适配存在遗漏。

报错分析 #

• 编译警告提示找不到javax.persistence下的枚举类（如GenerationType.IDENTITY、FetchType.LAZY），说明APT生成Q类时仍在引用旧的Java EE API。
• JPAQueryFactory构造器无法解析，是因为注入的EntityManager为Jakarta版本（jakarta.persistence.EntityManager），但QueryDSL组件未正确适配Jakarta规范。

解决方案 #

1. 清理冗余Java EE依赖 #

移除build.gradle中所有javax开头的annotationProcessor依赖，Spring Boot 3已内置Jakarta对应API：

// 删除以下无效依赖
annotationProcessor('javax.annotation:javax.annotation-api:1.3.2')
annotationProcessor('org.hibernate.javax.persistence:hibernate-jpa-2.1-api:1.0.2.Final')

2. 修正QueryDSL依赖配置 #

QueryDSL 5.x支持Jakarta，但需确保依赖分类器和scope正确，querydsl-apt仅需作为注解处理器：

def querydslVersion = '5.0.0' // 建议使用固定版本，避免自动升级的兼容问题
dependencies {
    // 原有Spring依赖保持不变

    // Querydsl核心依赖（指定jakarta分类器适配Spring Boot 3）
    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}"

    // 注解处理器（仅用于生成Q类）
    annotationProcessor "com.querydsl:querydsl-apt:${querydslVersion}:jakarta"
    annotationProcessor "jakarta.persistence:jakarta.persistence-api"
    annotationProcessor "jakarta.annotation:jakarta.annotation-api"
    annotationProcessor "org.springframework.boot:spring-boot-starter-data-jpa"
}

3. 统一实体类注解导入 #

确保所有JPA实体类的注解都来自jakarta.persistence包，替换旧的javax.persistence导入：

// 正确导入
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;

// 删除以下旧导入
// import javax.persistence.Entity;

4. 清理缓存并重新构建 #

执行Gradle命令清理缓存后重新构建，同时重启IDE消除缓存报错：

./gradlew clean build --refresh-dependencies

额外说明 #

• IDE中JPAQueryFactory构造器的报错通常是缓存未更新，执行clean后重启IDE即可解决。
• QueryDSL 5.x与Spring Boot 3.x版本需严格对应，建议使用5.0.0及以上版本避免API差异问题。

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