更新时间：2026-01-15 GMT+08:00
使用前须知(Java SDK)
本文介绍Java SDK的版本兼容性说明，以及其他使用前须知。
兼容性说明
- 推荐使用的JDK版本：JDK 8及以上版本。
- 第三方依赖：与旧版本（2.1.x）不完全兼容，统一使用okhttp3替代httpclient4.x。
- 命名空间：与旧版本（2.1.x）保持兼容，对外的接口都包含在com.obs.services，com.obs.services.model和com.obs.services.exception三个包中。
- 接口函数：与旧版本（2.1.x）保持兼容。
- 旧版本（2.x）已不再维护，建议尽快升级至最新版。
其他使用前须知
- 您可以先参考OBS客户端通用示例，了解OBS Java SDK接口调用的通用方式。
- 使用OBS客户端进行接口调用操作完成后，没有异常抛出，则表明返回值有效；如果抛出异常，则说明操作失败，此时可从SDK自定义异常实例中获取错误信息。
- 使用OBS客户端进行接口调用成功后，均会返回包含响应头信息的SDK公共响应头实例（或其子类实例）。
- 当前各区域特性开放不一致，部分特性只在部分区域开放，使用过程中如果接口HTTP状态码为405，请确认该区域是否支持该功能特性。
