[Querydsl] unable to load class com.mysema.codegen.model.type'. error

문제

에러 내용

현재 프로젝트는 spring-boot-2.7.2를 사용 중이며, Querydsl을 사용하기 위해 build.gradle에 의존성을 추가하는 과정에서 위와 같은 에러가 발생했습니다.

plugins {
    id 'org.springframework.boot' version '2.7.2'
    id 'io.spring.dependency-management' version '1.0.12.RELEASE'
    // querydsl 추가
    id "com.ewerk.gradle.plugins.querydsl" version "1.0.10"
    id 'java'
}

group = 'study'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {

    // querydsl 추가
    implementation 'com.querydsl:querydsl-jpa'

    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    runtimeOnly 'com.h2database:h2'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation('org.springframework.boot:spring-boot-starter-test') {
        exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
    }
}

test {
    useJUnitPlatform()
}

// ------------querydsl 추가 시작 ------------
def querydslDir = "$buildDir/generated/querydsl"
querydsl {
    jpa = true
    querydslSourcesDir = querydslDir
}
sourceSets {
    main.java.srcDir querydslDir
}
configurations {
    querydsl.extendsFrom compileClasspath
}
compileQuerydsl {
    options.annotationProcessorPath = configurations.querydsl
}
// ------------querydsl 추가 끝------------

---

Querydsl을 추가하기 위해 설정한 build.gradle 코드는 위와 같습니다.

해결

// ------------ 여기 추가 ------------
buildscript {
    ext {
        queryDslVersion = "5.0.0"
    }
}
// ------------------------


plugins {
    id 'org.springframework.boot' version '2.7.2'
    id 'io.spring.dependency-management' version '1.0.12.RELEASE'
    //---------------추가---------------------
    id "com.ewerk.gradle.plugins.querydsl" version "1.0.10"
    //---------------------------------------
    id 'java'
}

group = 'study'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    
    // ------------ 여기 변경 ------------
    implementation "com.querydsl:querydsl-jpa:${queryDslVersion}"
    implementation "com.querydsl:querydsl-apt:${queryDslVersion}"
    // ------------------------
    
    runtimeOnly 'com.h2database:h2'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}
def querydslDir = "$buildDir/generated/querydsl"

querydsl {
    jpa = true
    querydslSourcesDir = querydslDir
}
sourceSets {
    main.java.srcDir querydslDir
}
compileQuerydsl {
    options.annotationProcessorPath = configurations.querydsl
}

// ------------ 여기 변경 ------------
configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
    querydsl.extendsFrom compileClasspath
}
// ------------------------

---

build.gradle을 위와 같이 변경해 줍니다. 특히 dependency 부분에 querydsl-jpa , querydsl-apt를 추가하고 버전을 명시해 주어야 합니다. (위 코드에서는  dependency querydsl-jpa , querydsl-apt을 추가하고 최 상단에 버전을 명시했습니다.)

확인

위 이미지 처럼 inteliJ우측의 Gradle -> querydsl -> other -> compileQuerydsl을 더블 클릭합니다.

위와 같은 결과가 출력되었다면 성공입니다!

원인

Srping Boot 2.6 버전 이상부터는 Querydsl 5.0을 사용해야 하며 아래와 같은 부분을 확인해야 합니다.

1. build.gradle 설정 변경 (필수)
2. PageableExecutionUtils Deprecated(향후 미지원) 패키지 변경 (사용한다면)
3. Querydsl fetchResults() , fetchCount() Deprecated(향후 미지원) (사용한다면)

 

PageableExecutionUtils 패키지 변경

PageableExecutionUtils 클래스 사용 패키지 변경
PageableExecutionUtils 클래스 사용 패키지 위치가 변경되었습니다. 기존 위치를 신규 위치로 변경해주시면 문제없이 사용할 수 있습니다.
기존: org.springframework.data.repository.support.PageableExecutionUtils
신규: org.springframework.data.support.PageableExecutionUtils

 

Querydsl fetchResults() , fetchCount() Deprecated(향후 미지원)

Querydsl의 fetchCount() , fetchResult()는 개발자가 작성한 select 쿼리를 기반으로 count용 쿼리를 내부에서 만들어서 실행합니다.
그런데 이 기능은 select 구문을 단순히 count 처리하는 용도로 바꾸는 정도입니다. 따라서 단순한 쿼리에서는 잘 동작하지만, 복잡한 쿼리에서는 제대로 동작하지 않으며 Querydsl은 향후 fetchCount() , fetchResult()를 지원하지 않기로 결정했습니다.

따라서 count 쿼리가 필요하면 다음과 같이 별도로 작성해야 합니다.

@Test
  public void count() {
      Long totalCount = queryFactory
              //.select(Wildcard.count) //select count(*)
              .select(member.count()) //select count(member.id)
              .from(member)
              .fetchOne();
      System.out.println("totalCount = " + totalCount);
}

 

 

참고

https://www.inflearn.com/course/Querydsl-%EC%8B%A4%EC%A0%84