Spring Boot 2+MongoDB+Kotlin+Gradle下QueryDSL元数据类生成失败求助

我帮你梳理下几个关键的配置补充和修改点，结合你的现有Gradle配置来调整：

1. 启用KAPT插件并配置MongoDB专属的注解处理器 #

因为是Kotlin项目，Java的apt工具无法处理Kotlin类的注解，必须用Kotlin官方的**KAPT（Kotlin Annotation Processing Tool）**来生成Q类。

首先添加KAPT插件：

apply plugin: 'kotlin-kapt'

然后替换原有的QueryDSL APT依赖，指定MongoDB的注解处理器：

// 移除原来的compile('com.querydsl:querydsl-apt:4.1.4')，换成下面的kapt依赖
kapt("com.querydsl:querydsl-apt:4.1.4:mongodb")
compile("com.querydsl:querydsl-mongodb:4.1.4")
compile(kotlin("stdlib-jdk8")) // 确保Kotlin标准库依赖

这里的:mongodb后缀会自动引入com.querydsl.apt.mongodb.MongoAnnotationProcessor，专门处理Spring Data MongoDB的@Document注解。

2. 配置QueryDSL插件的生成规则 #

需要明确告诉QueryDSL插件去哪里找实体类，以及生成的Q类放到哪个目录。在build.gradle中添加以下配置块：

querydsl {
    jpa = false // 我们用的是MongoDB，不是JPA，所以禁用JPA模式
    querydslSourcesDir = file("src/main/generated") // Q类生成的目录，可自定义
    entityPackages = ["com.yourproject.domain"] // 替换成你的实体类所在的包路径
}

3. 触发注解处理生成Q类 #

配置完成后，运行以下Gradle任务来生成Q类：

./gradlew kaptKotlin

或者直接执行build任务，会自动触发注解处理：

./gradlew build

额外检查点 #

• 确保实体类上的@Document注解是org.springframework.data.mongodb.core.mapping.Document，不是其他包的注解；
• 确认QueryDSL版本（4.1.4）和Spring Boot 2版本兼容（Spring Boot 2.x通常兼容QueryDSL 4.x系列，这个版本没问题）；
• 如果用IDEA，需要把生成的src/main/generated目录标记为Generated Sources Root，这样IDE才能识别Q类。

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