Spring Boot Gradle构建报错：java.lang.IllegalStateException: endPosTable already set

核心原因分析 #

这个异常通常由Java编译增量缓存冲突或Querydsl与Java编译任务的执行顺序/依赖配置问题引发。本地重试能成功是因为本地缓存状态偶尔可自行恢复，但Jenkins的CI环境缓存清理策略更严格，且可能存在并行执行资源竞争，导致冲突持续触发。

具体解决方案 #

1. 禁用Java编译的增量构建 #

Gradle增量编译在部分场景下会和Querydsl的代码生成逻辑冲突，直接禁用可避免缓存异常：
在build.gradle中添加：

tasks.withType(JavaCompile) {
    options.incremental = false
}

2. 调整Querydsl任务的依赖与执行逻辑 #

确保compileQuerydsl任务明确依赖compileJava完成，同时禁用自身增量构建：

tasks.named('compileQuerydsl') {
    dependsOn tasks.named('compileJava')
    options.incremental = false
}

3. 清理Jenkins构建缓存 #

Jenkins工作目录的残留缓存文件可能损坏，可通过以下方式处理：

• 构建前强制执行clean任务，或在Jenkins构建配置中勾选"Delete workspace before build starts"
• 执行Gradle命令时添加--no-build-cache参数禁用构建缓存：

./gradlew clean build --no-build-cache

4. 升级Gradle版本（可选但推荐） #

Gradle 6.9存在不少编译缓存相关的已知bug，Spring Boot 2.7.x兼容Gradle 7.x系列，升级至7.6.x可从根源减少这类异常发生。

5. 校验Querydsl路径配置 #

确保Querydsl代码生成路径与Java编译路径无重叠，避免文件覆盖冲突：

querydsl {
    jpa = true
    querydslSourcesDir = file("$buildDir/generated/sources/querydsl")
}
sourceSets {
    main {
        java {
            srcDirs += querydsl.querydslSourcesDir
        }
    }
}

排查补充 #

若以上方法无效，可在Jenkins构建时添加--info参数获取详细日志，重点查看compileJava和compileQuerydsl任务的文件访问记录，确认是否存在文件重复写入的情况。

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