创建OCI ObjectStorageClient时遇NoSuchFieldError: TOO_MANY_REQUESTS异常求助

异常原因分析 #

这个java.lang.NoSuchFieldError: TOO_MANY_REQUESTS异常的核心原因是依赖版本不兼容或缺失：

• TOO_MANY_REQUESTS是OCI SDK中用于标识限流错误的常量，通常定义在com.oracle.bmc.http.client.HttpStatus类中。
• 创建ObjectStorageClient时，断路器（CircuitBreaker）组件尝试引用该常量，但当前类路径中对应的依赖版本未包含这个字段，导致查找失败。

具体解决步骤 #

1. 统一OCI SDK所有组件的版本 #

OCI Java SDK的各个模块（objectstorage、core、circuitbreaker等）必须使用完全一致的版本，避免版本差异引发的类/字段不匹配问题。

如果使用Maven，确保所有oci-java-sdk依赖的版本统一：

<properties>
    <oci-java-sdk.version>2.50.0</properties> <!-- 替换为最新稳定版 -->
</properties>

<dependencies>
    <dependency>
        <groupId>com.oracle.oci.sdk</groupId>
        <artifactId>oci-java-sdk-objectstorage</artifactId>
        <version>${oci-java-sdk.version}</version>
    </dependency>
    <dependency>
        <groupId>com.oracle.oci.sdk</groupId>
        <artifactId>oci-java-sdk-core</artifactId>
        <version>${oci-java-sdk.version}</version>
    </dependency>
    <!-- 若显式引入circuitbreaker，保持版本一致 -->
    <dependency>
        <groupId>com.oracle.oci.sdk</groupId>
        <artifactId>oci-java-sdk-circuitbreaker</artifactId>
        <version>${oci-java-sdk.version}</version>
    </dependency>
</dependencies>

如果使用Gradle：

ext {
    ociJavaSdkVersion = '2.50.0' // 替换为最新稳定版
}

dependencies {
    implementation "com.oracle.oci.sdk:oci-java-sdk-objectstorage:$ociJavaSdkVersion"
    implementation "com.oracle.oci.sdk:oci-java-sdk-core:$ociJavaSdkVersion"
    implementation "com.oracle.oci.sdk:oci-java-sdk-circuitbreaker:$ociJavaSdkVersion"
}

2. 清理依赖冲突 #

检查项目依赖树，排除间接引入的低版本或不兼容OCI SDK组件：

• Maven执行mvn dependency:tree，Gradle执行./gradlew dependencies，查找所有com.oracle.oci.sdk开头的依赖，确保版本统一。
• 若发现第三方依赖间接引入旧版本OCI SDK，在对应依赖中添加排除规则：

<!-- Maven示例：排除间接引入的旧版本OCI SDK -->
<dependency>
    <groupId>第三方依赖groupId</groupId>
    <artifactId>第三方依赖artifactId</artifactId>
    <version>第三方版本</version>
    <exclusions>
        <exclusion>
            <groupId>com.oracle.oci.sdk</groupId>
            <artifactId>*</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 升级到包含该字段的SDK版本 #

TOO_MANY_REQUESTS字段是在OCI SDK的较新版本中新增的，若使用旧版本，直接升级到最新稳定版即可解决问题。

4. 可选：禁用断路器功能 #

如果不需要断路器功能，可以显式禁用以规避该问题：

ObjectStorage ociClient = ObjectStorageClient.builder()
        .authenticationDetailsProvider(provider)
        .circuitBreakerConfiguration(CircuitBreakerConfiguration.disabled())
        .build();

验证解决结果 #

完成上述步骤后，重新编译运行代码，检查是否仍抛出NoSuchFieldError异常。若问题依旧，清理项目构建缓存（Maven执行mvn clean install，Gradle执行./gradlew clean build）后再次尝试。

内容的提问来源于stack exchange，提问作者M-zet Mzamo