Khi Gradle 9, Docker 29 và Testcontainers đang bực mình: việc gỡ lỗi trong quá trình xây dựng 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 : mới DockerClient()
DJ -> DE : GET /_ping\nUser-Agent: docker-java/3.4.1\nAPI-Version: 1.32
DE --> DJ : HTTP 400 Bad Request\nphiên bản khách hàng 1.32 là quá cũ.\nhỗ trợ tối thiểu API phiên bản là 1.40
DJ --> TC : BadRequestException
TC --> TC : Không thể tìm thấy môi trường \nDocker hợp lệ

note right of DE
Docker Engine 29.x impose
API minimum = 1.40
(Giá trị mặc định cũ : 1.24)
end note

note left of DJ
docker-java 3.4.1 gửi
hardcoded API version 1.32
trong tiêu đề 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(người tiêu dùng)" as BG #E3F2FD {
    rectangle "yêu cầu\n`testcontainers-bom:2.0.5`" as REQ
    rectangle "yêu cầu\n`testcontainers-postgresql`" as REQ2
}

component "Maven Central" as MC #FFF3E0

component "Khai báo" as DEC #E8F5E9 {
    rectangle "`testcontainers-bom:2.0.5`\ncố định 2.0.5" as BOM2
    rectangle "`spring-boot-dependencies:3.4.5`\ncố định 1.20.6" as BOM1
}

component "Giải quyết Gradle" as RES #FFEBEE {
    rectangle "phiên bản thắng\n`testcontainers:1.20.6`" as WIN #EF9A9A
}

BG --> DEC : "phân tích các BOMs"
BOM2 --> RES : "đề xuất 2.0.5"
BOM1 --> RES : "đề xuất 1.20.6"
WIN -> MC : "tải về\ntestcontainers:1.20.6"

note bottom of WIN
Spring Boot BOM xe chính
plugin spring-boot áp dụng các phụ thuộc quản lý của nó
sau khi giải quyết người tiêu dùng
end note

@enduml

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

left to right direction

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

component "Xung đột đã được giải quyết" as RESOLVED #E3F2FD {
    rectangle "docker-java\n`3.7.1` (buộc)" as DJ
    rectangle "testcontainers\n`2.0.5` (buộc)" 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(ngầm, ghi đè)" as BOM1 #FFEBEE

component "Maven Central" as MC #FFF3E0

BG --> RESOLVED : "BOM Testcontainers 2.0.5\ntrực tiếp"
RS -> DJ : "ép buộc 3.7.1"
RS -> TC : "ép buộc 2.0.5"
RESOLVED --> MC : "tải các JARs\ntương thích Docker 29"
BOM1 -[#gray,dashed]-> RESOLVED : "bỏ qua trên testcontainers\nvà docker-java"

note bottom of RS
`eachDependency` chặn việc giải quyết Gradle AVANT
mà BOM Spring Boot không giành được.
Đây là một can thiệp phẫu thuật.
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