当 Gradle 9、Docker 29 和 Testcontainers 自找麻烦时：调试 JHipster 构建

sdk use java 21.0.11-tem

$ ./gradlew build --no-daemon

FAILURE: Build failed with an exception.

* Where:
Build file '/home/.../edster/build.gradle' line: 18

* What went wrong:
An exception occurred applying plugin request [id: 'jhipster.cucumber-conventions']
> Failed to apply plugin 'jhipster.cucumber-conventions'.
   > Could not create task ':cucumberTest'.
      > Could not create task ':consoleLauncherTest'.
         > Could not set unknown property 'reportsDir' for task ':consoleLauncherTest'

tasks.register('consoleLauncherTest', JavaExec) {
    dependsOn(testClasses)
    String cucumberReportsDir = file("$buildDir/reports/tests")
    outputs.dir(reportsDir)           // <-- reportsDir n'existe PAS
    classpath = sourceSets["test"].runtimeClasspath
    main = "org.junit.platform.console.ConsoleLauncher"
    // ...
}

Could not set unknown property 'main' for task ':consoleLauncherTest' of type org.gradle.api.tasks.JavaExec.

Could not set unknown property 'sourceCompatibility' for root project 'edster' of type org.gradle.api.Project.

sourceCompatibility=17
targetCompatibility=17

java {
    sourceCompatibility = JavaVersion.VERSION_21
    targetCompatibility = JavaVersion.VERSION_21
}

assert System.properties["java.specification.version"] == "17" || "21" || "24"

assert System.properties["java.specification.version"] in ["17", "21", "23", "24"]

Task ':compileKotlin' uses this output of task ':openApiGenerate'
without declaring an explicit or implicit dependency.

afterEvaluate {
    tasks.named("compileKotlin").configure {
        dependsOn(tasks.named("openApiGenerate"))
    }
}

> Task :generateGitProperties FAILED

No signature of method: java.io.FilterOutputStream.write() is applicable for argument types: (Integer) values: [103]

gitPropertiesPluginVersion=2.5.7

Could not find a valid Docker environment.

EnvironmentAndSystemPropertyClientProviderStrategy: failed with exception BadRequestException
(Status 400: {"message":"client version 1.32 is too old. Minimum supported API version is 1.40"}
UnixSocketClientProviderStrategy: failed with exception BadRequestException
(Status 400: {"message":"client version 1.32 is too old. Minimum supported API version is 1.40"}

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

actor "Testcontainers\n1.20.6" as TC
participant "docker-java\n3.4.1" as DJ
participant "Docker Engine\n29.4.1" as DE

TC -> DJ : new DockerClient()
DJ -> DE : GET /_ping\nUser-Agent: docker-java/3.4.1\nAPI-Version: 1.32
DE --> DJ : HTTP 400 错误请求\n客户端版本 1.32 太旧。\n最低支持的 API 版本是 1.40
DJ --> TC : BadRequestException
TC --> TC : 找不到有效的\nDocker 环境

note right of DE
Docker Engine 29.x 强制
API 最小值 = 1.40
(旧默认值: 1.24)
end note

note left of DJ
docker-java 3.4.1 发送
硬编码 API 版本 1.32
在头部 HTTP
end note

@enduml

$ ./gradlew dependencies --configuration testRuntimeClasspath | grep docker-java

+--- com.github.docker-java:docker-java-api:3.4.1
+--- com.github.docker-java:docker-java-transport:3.4.1

configurations {
    all {
        resolutionStrategy.eachDependency { details ->
            if (details.requested.group == "com.github.docker-java"
                && details.requested.name.startsWith("docker-java")) {
                details.useVersion("3.5.1")
            }
        }
    }
}

rm -rf ~/.gradle/caches
rm -rf /path/to/project/.gradle

site:github.com/testcontainers "client version 1.32 is too old"
site:github.com/docker-java "client version 1.32" Docker Engine 29

dependencies {
    testImplementation platform("org.testcontainers:testcontainers-bom:2.0.5")
    testImplementation "org.testcontainers:testcontainers-postgresql"
    testImplementation "org.testcontainers:testcontainers-jdbc"
    testImplementation "org.testcontainers:testcontainers-junit-jupiter"
    testImplementation "org.testcontainers:testcontainers"
}

FAILURE: Could not find org.testcontainers:jdbc:2.0.5.
Could not find org.testcontainers:junit-jupiter:2.0.5.

+--- org.testcontainers:testcontainers -> 1.20.6 (*)
|    \--- org.testcontainers:testcontainers:2.0.5 -> 1.20.6

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false
skinparam componentStyle rectangle

left to right direction

component "build.gradle\n(消费者)" as BG #E3F2FD {
    rectangle "请求\n`testcontainers-bom:2.0.5`" as REQ
    rectangle "请求\n`testcontainers-postgresql`" as REQ2
}

component "Maven 中心" as MC #FFF3E0

component "声明" as DEC #E8F5E9 {
    rectangle "`testcontainers-bom:2.0.5`\n固定 2.0.5" as BOM2
    rectangle "`spring-boot-dependencies:3.4.5`\n固定 1.20.6" as BOM1
}

component "解决 Gradle" as RES #FFEBEE {
    rectangle "获胜版本\n`testcontainers:1.20.6`" as WIN #EF9A9A
}

BG --> DEC : "分析 BOMs"
BOM2 --> RES : "建议 2.0.5"
BOM1 --> RES : "建议 1.20.6"
WIN -> MC : "下载\ntestcontainers:1.20.6"

note bottom of WIN
Spring Boot BOM 主要因为
spring-boot 插件会应用
其管理依赖
在消费者解析之后
end note

@enduml

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false
skinparam componentStyle rectangle

left to right direction

component "build.gradle\n(带有 resolutionStrategy)" as BG #E8F5E9 {
    rectangle "BOM Testcontainers\n`2.0.5`" as BOM2
    rectangle "`resolutionStrategy\n.eachDependency`" as RS #66BB6A
}

component "冲突已解决" as RESOLVED #E3F2FD {
    rectangle "docker-java\n`3.7.1` (强制)" as DJ
    rectangle "testcontainers\n`2.0.5` (强制)" as TC #81C784
    rectangle "testcontainers-postgresql\n`2.0.5`" as TPG
    rectangle "testcontainers-jdbc\n`2.0.5`" as TJ
    rectangle "testcontainers-junit-jupiter\n`2.0.5`" as TJJ
}

component "BOM Spring Boot\n(隐式, 被覆盖)" as BOM1 #FFEBEE

component "Maven Central" as MC #FFF3E0

BG --> RESOLVED : "BOM Testcontainers 2.0.5\n直接通过"
RS -> DJ : "强制 3.7.1"
RS -> TC : "强制 2.0.5"
RESOLVED --> MC : "下载 JARs\n兼容的 Docker 29"
BOM1 -[#gray,dashed]-> RESOLVED : "已忽略在 testcontainers\n和 docker-java"

note bottom of RS
`eachDependency` 拦截了 Gradle AVANT 解析，BOM Spring Boot 无法获得。这是一项外科手术。
end note

@enduml

configurations {
    all {
        resolutionStrategy.eachDependency { details ->
            if (details.requested.group == "com.github.docker-java"
                && details.requested.name.startsWith("docker-java")) {
                details.useVersion("3.7.1")
            }
            if (details.requested.group == "org.testcontainers"
                && details.requested.name == "testcontainers") {
                details.useVersion("2.0.5")
            }
        }
    }
}

dependencies {
    testImplementation platform("org.testcontainers:testcontainers-bom:2.0.5")
    testImplementation "org.testcontainers:testcontainers-jdbc"
    testImplementation "org.testcontainers:testcontainers-junit-jupiter"
    testImplementation "org.testcontainers:testcontainers-postgresql"
    testImplementation "org.testcontainers:testcontainers"
    // ... autres dépendances Spring Boot
}

$ ./gradlew build --no-daemon

> Task :consoleLauncherTest
[2 containers found]
[2 containers started]
[2 containers successful]

BUILD SUCCESSFUL in 1m 16s