升级QueryDSL至5.0.0版本后无法生成QClass：com.querydsl.sql.Configuration未注册问题求助

这个问题我之前帮不少开发者排查过，核心原因是QueryDSL 5.x版本彻底弃用了旧的mysema系APT插件，换成了官方维护的插件，同时内部配置类的加载逻辑也有调整，导致你用旧插件时找不到com.querydsl.sql.Configuration类。

下面是具体的解决方案：

1. 替换旧的APT插件为QueryDSL官方插件 #

移除你当前使用的com.mysema.maven:apt-maven-plugin，换成QueryDSL 5.x配套的官方插件，版本必须和你的QueryDSL版本保持一致（5.0.0）：

<plugin>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-maven-plugin</artifactId>
    <version>5.0.0</version>
    <executions>
        <execution>
            <goals>
                <goal>export</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <outputDirectory>${project.build.directory}/generated-sources</outputDirectory>
        <processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
        <jpa>true</jpa> <!-- 启用JPA模式，自动扫描实体类 -->
    </configuration>
    <dependencies>
        <!-- 必须添加querydsl-jpa依赖到插件，确保处理器能加载必要类 -->
        <dependency>
            <groupId>com.querydsl</groupId>
            <artifactId>querydsl-jpa</artifactId>
            <version>5.0.0</version>
        </dependency>
        <!-- 如果使用Hibernate作为JPA实现，可添加此依赖增强实体识别能力 -->
        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-jpamodelgen</artifactId>
            <version>你的Hibernate版本号</version>
        </dependency>
    </dependencies>
</plugin>

2. 确保项目依赖的QueryDSL版本统一 #

检查你的<dependencies>块，确保所有QueryDSL相关依赖的版本都是5.0.0，避免版本冲突：

<dependencies>
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-jpa</artifactId>
        <version>5.0.0</version>
    </dependency>
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-core</artifactId>
        <version>5.0.0</version>
    </dependency>
    <!-- 其他项目依赖... -->
</dependencies>

3. 验证修复效果 #

你可以先单独执行QClass生成命令，验证是否正常：

mvn querydsl:export

如果没有报错，再执行完整的构建命令：

mvn clean install

关键说明 #

• 旧的apt-maven-plugin是QueryDSL 4.x及更早版本的配套工具，5.x版本开始官方停止维护该插件，改用querydsl-maven-plugin，这是导致报错的核心原因。
• 插件中配置的<jpa>true</jpa>会自动扫描项目中的JPA实体类，无需额外配置实体路径（如果需要自定义扫描路径，可以添加<entityPackage>你的实体包路径</entityPackage>）。

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