SpringBoot2.6.8集成Querydsl4.3.1报错无法加载com.mysema.codegen.model.Type类

com.mysema.codegen.model.Type是Querydsl 3.x及更早版本专属的类，Querydsl从4.0版本开始做了全包名重构，所有代码的包路径从com.mysema改为com.querydsl，4.3.1版本本身根本不存在这个类。
出现这个加载错误只有两个核心诱因：

• 项目依赖树中混入了Querydsl 3.x的旧版本传递依赖，和你手动引入的4.3.1版本产生类加载冲突
• 编译期用的注解处理器（APT）配置错误，生成Q类时仍然引用了旧版本的代码生成包

• 先输出项目全量依赖树定位冲突源：
  Maven项目执行命令：
  mvn dependency:tree | findstr querydsl（Windows环境）
  mvn dependency:tree | grep querydsl（Mac/Linux环境）
  Gradle项目执行命令：
  gradle dependencies | grep querydsl
  查看输出结果，如果存在com.mysema.querydsl或者com.mysema.codegen开头的依赖，顺着依赖链路找到引入这些旧包的上层组件即可。
• 检查编译插件的注解处理器配置，确认配置的Querydsl相关APT依赖全是com.querydsl开头的4.3.1版本，没有遗留com.mysema的旧坐标。

1. 传递依赖冲突修复
   找到引入旧版Querydsl的依赖项，添加排除规则过滤掉旧包，Maven配置示例：

   <dependency>
       <groupId>对应冲突组件的groupId</groupId>
       <artifactId>对应冲突组件的artifactId</artifactId>
       <exclusions>
           <exclusion>
               <groupId>com.mysema.querydsl</groupId>
               <artifactId>*</artifactId>
           </exclusion>
           <exclusion>
               <groupId>com.mysema.codegen</groupId>
               <artifactId>*</artifactId>
           </exclusion>
       </exclusions>
   </dependency>
   

2. 注解处理器配置修复
   对齐你使用的Querydsl 4.3.1版本配置maven-compiler-plugin的注解处理器路径，不要混用版本，参考配置：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-compiler-plugin</artifactId>
       <configuration>
           <annotationProcessorPaths>
               <path>
                   <groupId>com.querydsl</groupId>
                   <artifactId>querydsl-apt</artifactId>
                   <version>4.3.1</version>
                   <classifier>jpa</classifier>
               </path>
               <!-- 其他注解处理器如Lombok可按顺序追加在后方 -->
           </annotationProcessorPaths>
       </configuration>
   </plugin>
   

3. 版本统一优化
   SpringBoot 2.6.8版本的parent依赖默认管理的Querydsl版本为5.0.0，如果没有强需求必须使用4.3.1，建议直接删掉手动指定的Querydsl版本号，使用SpringBoot官方对齐的版本，从根源避免版本不一致问题。如果必须锁定4.3.1，直接在pom的properties节点添加<querydsl.version>4.3.1</querydsl.version>，保证所有Querydsl相关依赖（querydsl-core、querydsl-jpa、querydsl-apt）使用同一个版本，不要出现多版本共存的情况。

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