Broken okhttp transitive dependency in minio 8.6.0

[devtobi]

The new io.minio.minio java dependency version 8.6.0 upgraded com.squareup.okhttp3.okhttp transitive dependency from 4.12.0 to 5.1.0.
However this version seems broken, as its jar does not contain any Java class files. (see screenshot in my IDE)

In my case thus compilation thus fails because the HttpUrl class is not found and I call the .endpoint() method of the MinioClient.Builder. leading to the error:

Class file for okhttp3.HttpUrl not found.

I checked the release notes for okhttp 5.x and it looks like the artifacts where split into dedicated JVM / Android versions. Maybe this is the root of the issue here? (see https://square.github.io/okhttp/changelogs/changelog/#version-500)

[seransaca]

The new io.minio.minio java dependency version 8.6.0 upgraded com.squareup.okhttp3.okhttp transitive dependency from 4.12.0 to 5.1.0. However this version seems broken, as its jar does not contain any Java class files. (see screenshot in my IDE)

In my case thus compilation thus fails because the `HttpUrl` class is not found and I call the `.endpoint()` method of the `MinioClient.Builder`. leading to the error:

Class file for okhttp3.HttpUrl not found.

I checked the release notes for okhttp 5.x and it looks like the artifacts where split into dedicated JVM / Android versions. Maybe this is the root of the issue here? (see https://square.github.io/okhttp/changelogs/changelog/#version-500)

If you want while they fix the problem you can include this:

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp-jvm</artifactId>
    <version>5.1.0</version>
</dependency>

[balamurugana]

build.gradle

plugins {
  id 'java'
  id 'application'
}

group = 'demo'
version = '1.0.0'

java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(8) // Java 8+ also works
  }
}

repositories {
  mavenCentral()
}

dependencies {
  implementation 'io.minio:minio:8.6.0'
}

application {
  mainClass = 'demo.MinioStatDemo'
}

settings.gradle

rootProject.name = 'minio-stat-demo'

src/main/java/demo/MinioStatDemo.java

package demo;

import io.minio.MinioClient;
import io.minio.StatObjectArgs;
import io.minio.StatObjectResponse;

public class MinioStatDemo {
  public static void main(String[] args) throws Exception {
    MinioClient minioClient =
        MinioClient.builder()
            .endpoint("https://play.min.io")
            .credentials("Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")
            .build();

    StatObjectResponse stat =
        minioClient.statObject(
            StatObjectArgs.builder().bucket("mybucket").object("myobject").build());
    System.out.println(stat);
  }
}

Execution

$ ~/bin/gradle-8.14.3/bin/gradle wrapper --gradle-version 8.14.3

$ ./gradlew -console plain clean
> Task :clean

BUILD SUCCESSFUL in 953ms
1 actionable task: 1 executed

$ ./gradlew -console plain build
> Task :compileJava
> Task :processResources NO-SOURCE
> Task :classes
> Task :jar
> Task :startScripts
> Task :distTar
> Task :distZip
> Task :assemble
> Task :compileTestJava NO-SOURCE
> Task :processTestResources NO-SOURCE
> Task :testClasses UP-TO-DATE
> Task :test NO-SOURCE
> Task :check UP-TO-DATE
> Task :build

BUILD SUCCESSFUL in 3s
5 actionable tasks: 5 executed

$ ./gradlew -console plain run
> Task :compileJava UP-TO-DATE
> Task :processResources NO-SOURCE
> Task :classes UP-TO-DATE

> Task :run
ObjectStat{bucket=mybucket, object=myobject, last-modified=2025-09-29T14:02:19Z, size=30605496}

BUILD SUCCESSFUL in 1m 3s
2 actionable tasks: 1 executed, 1 up-to-date

[devtobi]

The new io.minio.minio java dependency version 8.6.0 upgraded com.squareup.okhttp3.okhttp transitive dependency from 4.12.0 to 5.1.0. However this version seems broken, as its jar does not contain any Java class files. (see screenshot in my IDE)

In my case thus compilation thus fails because the HttpUrl class is not found and I call the .endpoint() method of the MinioClient.Builder. leading to the error:
Class file for okhttp3.HttpUrl not found.
I checked the release notes for okhttp 5.x and it looks like the artifacts where split into dedicated JVM / Android versions. Maybe this is the root of the issue here? (see square.github.io/okhttp/changelogs/changelog#version-500)

If you want while they fix the problem you can include this:

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp-jvm</artifactId>
    <version>5.1.0</version>
</dependency>

This could be an fix, however would require us to maintain the version of okhttp-jvm to be in sync with the version provided by minio which is not what we want.

[devtobi]

build.gradle

plugins {
  id 'java'
  id 'application'
}

group = 'demo'
version = '1.0.0'

java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(8) // Java 8+ also works
  }
}

repositories {
  mavenCentral()
}

dependencies {
  implementation 'io.minio:minio:8.6.0'
}

application {
  mainClass = 'demo.MinioStatDemo'
}

settings.gradle

rootProject.name = 'minio-stat-demo'

src/main/java/demo/MinioStatDemo.java

package demo;

import io.minio.MinioClient;
import io.minio.StatObjectArgs;
import io.minio.StatObjectResponse;

public class MinioStatDemo {
public static void main(String[] args) throws Exception {
MinioClient minioClient =
MinioClient.builder()
.endpoint("https://play.min.io")
.credentials("Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")
.build();

StatObjectResponse stat =
    minioClient.statObject(
        StatObjectArgs.builder().bucket("mybucket").object("myobject").build());
System.out.println(stat);

}
}

Execution

$ ~/bin/gradle-8.14.3/bin/gradle wrapper --gradle-version 8.14.3

$ ./gradlew -console plain clean
> Task :clean

BUILD SUCCESSFUL in 953ms
1 actionable task: 1 executed

$ ./gradlew -console plain build
> Task :compileJava
> Task :processResources NO-SOURCE
> Task :classes
> Task :jar
> Task :startScripts
> Task :distTar
> Task :distZip
> Task :assemble
> Task :compileTestJava NO-SOURCE
> Task :processTestResources NO-SOURCE
> Task :testClasses UP-TO-DATE
> Task :test NO-SOURCE
> Task :check UP-TO-DATE
> Task :build

BUILD SUCCESSFUL in 3s
5 actionable tasks: 5 executed

$ ./gradlew -console plain run
> Task :compileJava UP-TO-DATE
> Task :processResources NO-SOURCE
> Task :classes UP-TO-DATE

> Task :run
ObjectStat{bucket=mybucket, object=myobject, last-modified=2025-09-29T14:02:19Z, size=30605496}

BUILD SUCCESSFUL in 1m 3s
2 actionable tasks: 1 executed, 1 up-to-date

@balamurugana I recreated your small example using Maven and get the same error. So could it be a Maven thing? Using Java 21 and Maven 3.9.11

[balamurugana]

@devtobi looks like

[devtobi]

build.gradle

plugins {
  id 'java'
  id 'application'
}

group = 'demo'
version = '1.0.0'

java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(8) // Java 8+ also works
  }
}

repositories {
  mavenCentral()
}

dependencies {
  implementation 'io.minio:minio:8.6.0'
}

application {
  mainClass = 'demo.MinioStatDemo'
}

settings.gradle

rootProject.name = 'minio-stat-demo'

src/main/java/demo/MinioStatDemo.java

package demo;

import io.minio.MinioClient;
import io.minio.StatObjectArgs;
import io.minio.StatObjectResponse;

public class MinioStatDemo {
public static void main(String[] args) throws Exception {
MinioClient minioClient =
MinioClient.builder()
.endpoint("https://play.min.io")
.credentials("Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")
.build();

StatObjectResponse stat =
    minioClient.statObject(
        StatObjectArgs.builder().bucket("mybucket").object("myobject").build());
System.out.println(stat);

}
}

Execution

$ ~/bin/gradle-8.14.3/bin/gradle wrapper --gradle-version 8.14.3

$ ./gradlew -console plain clean
> Task :clean

BUILD SUCCESSFUL in 953ms
1 actionable task: 1 executed

$ ./gradlew -console plain build
> Task :compileJava
> Task :processResources NO-SOURCE
> Task :classes
> Task :jar
> Task :startScripts
> Task :distTar
> Task :distZip
> Task :assemble
> Task :compileTestJava NO-SOURCE
> Task :processTestResources NO-SOURCE
> Task :testClasses UP-TO-DATE
> Task :test NO-SOURCE
> Task :check UP-TO-DATE
> Task :build

BUILD SUCCESSFUL in 3s
5 actionable tasks: 5 executed

$ ./gradlew -console plain run
> Task :compileJava UP-TO-DATE
> Task :processResources NO-SOURCE
> Task :classes UP-TO-DATE

> Task :run
ObjectStat{bucket=mybucket, object=myobject, last-modified=2025-09-29T14:02:19Z, size=30605496}

BUILD SUCCESSFUL in 1m 3s
2 actionable tasks: 1 executed, 1 up-to-date

Could it be a problem only occuring when using Maven? The error on my side happens when using the maven-compiler-plugin to build the project.

@devtobi looks like

Could you try replicating the problem on your side using Maven? Unfortunately we cannot use Gradle.

[balamurugana]

@devtobi This is not minio-java issue. You would need to check with respective people.

[seransaca]

@devtobi This is not minio-java issue. You would need to check with respective people.

Hello
Of course it's a minio-java issue, since it says it can be used with Maven, but if you compile with Maven, the okhttp dependency isn't imported correctly, so MinioClient doesn't work properly.
If you read the documentation of okhttp correctly, which you use in minio-java,
Maven and JVM Projects
you will see that in your pom.xml

you would need to put the dependency on okhttp-jvm or okhttp-android depending on the type of project. With something like this, you could do what is stated in the okhttp documentation:

publishing {
    publications {
        minioJava(MavenPublication) {
            artifactId = base.archivesName.get()
            from components.java

            pom.withXml {
                def dependenciesNode = asNode().appendNode('dependencies')

                def isAndroid = project.hasProperty('android') || project.plugins.hasPlugin('com.android.library')

                if (isAndroid) {
                    def dep = dependenciesNode.appendNode('dependency')
                    dep.appendNode('groupId', 'com.squareup.okhttp3')
                    dep.appendNode('artifactId', 'okhttp-android')
                    dep.appendNode('version', '5.1.0')
                } else {
                    def dep = dependenciesNode.appendNode('dependency')
                    dep.appendNode('groupId', 'com.squareup.okhttp3')
                    dep.appendNode('artifactId', 'okhttp-jvm')
                    dep.appendNode('version', '5.1.0')
                }
            }
        }
    }
}

[seransaca]

This could be an fix, however would require us to maintain the version of okhttp-jvm to be in sync with the version provided by minio which is not what we want.

I understand perfectly what you're saying, it was in case it was of use to you momentarily while they corrected the error in minio-java

[devtobi]

@balamurugana As @seransaca already stated above adding okhttp-jvm currently is the only way to solve this using with Maven, see https://github.com/square/okhttp?tab=readme-ov-file#maven-and-jvm-projects.

I suggest you add a note to minio-java so other people don't run into the same issue.

Would maybe adding the okhttp-bom to minio-java solve the problem?
Or is there a way to include okhttp-jvm as a dependency?

Would definitely be better if there is a way of solving this on the minio-java side instead of downstream projects having to fix this (and keep the dependency versions in sync) themself.

[balamurugana]

If dependency is the issue, gradle should also fail. I see maven is the issue and this should be taken outside of minio-java.

[seransaca]

If dependency is the issue, gradle should also fail. I see maven is the issue and this should be taken outside of minio-java.

Sorry, did you read the link I posted?
I'll also include a picture of it so you can see the difference.

[seransaca]

@balamurugana Any updates on the last message I sent you?
@minio-trusted or another project contributor could review this together with you to find a solution.