如何通过Netflix DGS CodeGen Gradle任务自定义目录生成GraphQL文件及解决类导入问题

一、GenerateJavaTask找不到的原因 #

1. 版本不兼容：你混用了不同版本的DGS组件——graphql-dgs-spring-boot-starter用了4.9.11，而Codegen插件/依赖用了5.5.0。DGS的核心库和Codegen工具需要保持版本一致，跨大版本会导致类路径缺失或冲突。
2. 冗余依赖声明：graphql-dgs-codegen-gradle不需要放在implementation依赖块里。通过plugins块引入Codegen插件后，Gradle会自动管理插件的类路径，手动添加implementation依赖反而可能引发类加载问题。

二、修正后的完整Gradle配置 #

1. 统一DGS版本 #

先把所有DGS相关组件的版本对齐，示例使用5.5.0版本：

plugins {
    // 保留你的其他插件...
    id("com.netflix.dgs.codegen") version "5.5.0"
}

dependencies {
    // 保留你的其他依赖...
    implementation("com.netflix.graphql.dgs:graphql-dgs-spring-boot-starter:5.5.0")
    // 移除原有的graphql-dgs-codegen-gradle依赖
}

2. 配置任务类型与输出目录 #

添加outputDir指定生成文件到generated目录，同时确保任务类型可被正确识别：

// 若IDE仍提示找不到类，手动导入任务类型
import com.netflix.graphql.dgs.codegen.gradle.GenerateJavaTask

tasks.withType<GenerateJavaTask> {
    schemaPaths = mutableListOf("$projectDir/src/main/resources/schema")
    generateClient = true
    packageName = "com.example.api.generated"
    // 指定输出到项目根目录的generated文件夹
    outputDir = file("$projectDir/generated")
}

3. 让IDE识别生成目录（可选） #

如果需要IntelliJ等IDE自动将generated目录标记为源码目录，添加以下配置：

sourceSets {
    main {
        java {
            srcDir("$projectDir/generated")
        }
    }
}

三、验证 #

运行./gradlew generateJava任务，检查generated目录是否生成了预期的代码，同时IDE的类导入错误应该会消失。

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