Alibaba Cloud SDK：FAQ

• Pastikan lingkungan Java telah terinstal dengan benar dan versi Java adalah 1.8 atau lebih baru.

• Pastikan jaringan Anda dapat mengakses API Alibaba Cloud.

• Masalah pengiriman parameter AK.

• tidak dapat memperoleh kredensial dari penyedia mana pun dalam rantai: ...

• kode 403, Anda tidak berwenang untuk melakukan operasi ini. Action: xxxx

• Kesalahan impor dependensi Maven: Tidak dapat menemukan artefak com.aliyun:XX:XX

• java: Error: rilis versi X tidak didukung.

• java: Kompilasi gagal: kesalahan kompiler java internal.

• kode: 400, <Parameter> wajib untuk aksi ini.

• java.lang.NoSuchMethodError, java.lang.NoSuchFieldError

• "TeaUnretryableException: timeout", "java.net.SocketTimeoutException: connect timed out", "java.net.SocketTimeoutException: Read timed out", "SDK.ServerUnreachable", "Connection aborted", atau "RemoteDisconnected".

• Permintaan Anda ditolak karena kurangnya perlindungan SSL. RequestId.

• kode: 404, API yang ditentukan tidak ditemukan. Harap periksa URL dan metode Anda.

• Kode respons tak terduga untuk CONNECT: 400.

• Tidak dapat mengatur bidang java.lang.String com.aliyun.imm20200930.models.GenerateWebofficeTokenShrinkRequest.userShrink ke java.util.

• Gagal mengunduh dependensi secara otomatis menggunakan Maven di IDEA.

• Cara menghindari pesan peringatan yang disebabkan oleh refleksi.

• Tanda tangan yang ditentukan tidak cocok dengan perhitungan kami.

• SDK.EndpointResolvingError: "Tidak ada wilayah 'cn-XX'. Harap periksa ID wilayah Anda".

• Gagal membuat instance [com.aliyuncs.IAcsClient]: Metode pabrik 'iAcsClient' melemparkan pengecualian dengan pesan: org/apache/http/conn/ssl/DefaultHostnameVerifier.

• Kode error 401 'Anda belum mengaktifkan layanan XXX' atau pesan serupa dilaporkan saat Anda memanggil operasi OpenAPI.

• Gagal mengambil kredensial sesi RAM dari layanan metadata ECS. HttpCode=XX

• AccessKey ini berisiko bocor

• Permintaan ditolak karena pengendalian alur API

• AccessKey yang ditentukan ditolak karena kebijakan akses

• com.aliyuncs.exceptions.ClientException: SDK.InvalidRegionId: Tidak dapat menemukan titik akhir untuk diakses

Masalah pengiriman parameter AK.

Gejala: Terjadi error saat kode dijalankan. Jika pesan error berisi informasi berikut, AccessKey tidak diatur dengan benar.

• SDK V2.0: Cannot invoke "com.aliyun.credentials.Client.getCredential()" because "this._credential" is null

• SDK V1.0: ErrCode:MissingAccessKeyId.ErrMsg:AccessKeyId is mandatory for this action.

Solusi:

1. Jalankan perintah berikut untuk memeriksa apakah ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi dalam variabel lingkungan Anda:

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   Jika AccessKey yang benar dikembalikan, konfigurasi berhasil. Jika nilai yang dikembalikan kosong atau salah, atur ulang. Untuk informasi selengkapnya, lihat Konfigurasikan variabel lingkungan pada Linux, macOS, dan Windows.

2. Periksa kode untuk mencari kesalahan terkait AccessKey.

   Contoh kesalahan umum:

   Config config = new Config()
            .setAccessKeyId(System.getenv("yourAccessKeyID"))   
            .setAccessKeySecret(System.getenv("yourAccessKeySecret"));

   Contoh yang benar:

   Config config = new Config()
           .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
           .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

   Catatan

   System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID") dan System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET") mengambil nilai ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET dari variabel lingkungan.

   Penting

   Jangan menyematkan AccessKey secara langsung dalam kode produksi Anda. Hal ini dapat menyebabkan risiko keamanan.

unable to get credentials from any of the providers in the chain : ...

Penyebab: Anda menggunakan kredensial default dalam proyek Anda, seperti yang ditunjukkan pada contoh kode berikut. Error ini terjadi karena tidak ada kredensial yang didukung oleh penyedia kredensial default yang dikonfigurasi.

com.aliyun.credentials.Client credential = new com.aliyun.credentials.Client();
com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
        .setCredential(credential);

Solusi:

• Untuk menggunakan AccessKey secara langsung dalam kode, lihat contoh berikut:

  com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
          // Contoh ini menunjukkan cara memperoleh ID AccessKey dari variabel lingkungan.
          .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
          // Contoh ini menunjukkan cara memperoleh rahasia AccessKey dari variabel lingkungan.
          .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

  Untuk menggunakan kredensial lainnya, lihat Kelola kredensial akses.

• Untuk tetap menggunakan kredensial default, Anda perlu mengonfigurasi kredensial apa pun yang didukung oleh rantai penyedia kredensial default.

kode 403, Anda tidak berwenang untuk melakukan operasi ini. Action: xxxx.

Penyebab masalah ini adalah pengguna RAM, peran, atau grup pengguna yang memanggil API belum diberikan izin yang diperlukan untuk melakukan operasi API tersebut. Action:XXXX dalam pesan error menunjukkan operasi API spesifik yang sedang Anda coba panggil. Misalnya, Action:dysms:SendSms menunjukkan bahwa Anda mencoba memanggil operasi SendSms dari Layanan Pesan Singkat, tetapi akun saat ini tidak memiliki izin yang diperlukan. Anda harus memberikan izin untuk mengirim pesan teks kepada pengguna RAM.

Solusi:

1. Hubungi pengguna RAM dengan izin administrator untuk membuat kebijakan kustom berdasarkan dokumen kebijakan berikut. Untuk informasi selengkapnya, lihat Buat kebijakan kustom.

   Catatan

   Kebijakan ini hanya memberikan izin untuk memanggil operasi SendSms dari Layanan Pesan Singkat (dysms). Anda harus menggantinya berdasarkan pesan error aktual.

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "dysms:SendSms",
         "Resource": "*"
       }
     ]
   }

2. Berikan izin kepada pengguna RAM. Untuk informasi selengkapnya, lihat dokumen berikut:

   • Berikan izin kepada pengguna RAM.

   • Berikan izin kepada peran RAM.

   • Berikan izin kepada grup pengguna RAM.

Kesalahan impor dependensi Maven: Tidak dapat menemukan artefak com.aliyun:XX:XX

Deskripsi:

Saat Anda mengimpor dependensi dalam proyek Maven, pesan error menunjukkan bahwa dependensi tersebut tidak dapat ditemukan.

Solusi:

Konfigurasikan alamat repositori pusat Maven dalam proyek. Hal ini memberi tahu Maven repositori jarak jauh mana yang harus digunakan untuk mengunduh dependensi saat membangun proyek. Anda dapat menggunakan salah satu dari dua metode konfigurasi berikut:

• Tambahkan konten berikut ke pom.xml:

  <repositories>
      <repository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
      </repository>
      <repository>
          <id>nexus-noke</id>
          <url>http://nexus.noke.com/nexus/content/groups/public/</url>
      </repository>
  </repositories>

• Tambahkan konten berikut ke settings.xml:

  <settings>
      <!-- Pengaturan yang sudah ada -->
      
      <mirrors>
          <mirror>
              <!-- ID ini bisa berupa pengenal unik apa pun -->
              <id>central</id>
              <mirrorOf>central</mirrorOf>
              <name>Maven Central Mirror</name>
              <url>https://repo1.maven.org/maven2</url>
          </mirror>
      </mirrors>
  </settings>

java: Error: rilis versi X tidak didukung.

Di IntelliJ IDEA, tekan Ctrl+Alt+Shift+S untuk membuka jendela Struktur Proyek. Pilih Modul. Di bagian Tingkat Bahasa (Language Level) di sebelah kanan, pilih versi yang konsisten dengan versi JDK yang Anda gunakan. Misalnya, jika Anda menggunakan JDK 8, pilih "8 - Lambdas, type annotations etc." untuk Tingkat Bahasa. Klik Terapkan (Apply), lalu klik OK.

java: Kompilasi gagal: kesalahan kompiler java internal.

Di bilah menu IntelliJ IDEA, klik File > Pengaturan (Settings) > Build, Execution, Deployment > Compiler > Java Compiler. Untuk versi bytecode Proyek (Project bytecode version) dan versi bytecode Target (Target bytecode version), pilih versi yang konsisten dengan versi JDK yang Anda gunakan. Misalnya, jika Anda menggunakan JDK 8, pilih 8 untuk kedua item tersebut. Klik Terapkan (Apply), lalu klik OK.

kode: 400, <CERTAIN_FIELD > wajib untuk aksi ini.

Penyebab masalah ini adalah parameter yang diperlukan tidak ditentukan saat Anda memanggil API. Solusi:

Contoh ini menunjukkan cara memanggil operasi SendSms dari Layanan Pesan Singkat:

• Buka halaman Debugging API Portal OpenAPI dan pilih layanan Alibaba Cloud serta operasinya.

• Periksa dengan cermat bahwa semua bidang yang diperlukan, seperti nomor telepon dan tanda tangan, telah diisi dalam objek permintaan yang dibuat, seperti SendSmsRequest.

• Merujuk pada dokumentasi API untuk mengonfirmasi parameter yang diperlukan. Pastikan nilai parameter yang diperlukan benar.

• Pastikan nilai parameter yang diperlukan benar. Misalnya, periksa apakah format nomor telepon valid.

• Sebelum Anda memanggil API, SDK secara otomatis memverifikasi parameter. Jika parameter yang diperlukan hilang, Anda akan menerima pesan error seperti MissingRequiredParameter. Misalnya, jika parameter nomor telepon hilang, pesan error "MissingPhoneNumbers: kode: 400" dikembalikan.

SendSmsRequest sendSmsRequest = new SendSmsRequest()
        // Ganti ini dengan nomor telepon yang menerima pesan teks.
        .setPhoneNumbers("<YOUR_VALUE>")
        // Ganti ini dengan tanda tangan SMS Anda.
        .setSignName("<YOUR_VALUE>")
        // Ganti ini dengan kode template SMS Anda.
        .setTemplateCode("<YOUR_VALUE>");

java.lang.NoSuchMethodError, java.lang.NoSuchFieldError

Penyebab:

Jenis pengecualian ini biasanya terjadi ketika lingkungan runtime Java mencoba memanggil metode atau mengakses bidang yang tidak ada. Penyebab yang mungkin meliputi:

• Versi dependensi usang: Versi dependensi yang terlalu lama mungkin ditentukan dalam file konfigurasi alat build seperti Maven atau Gradle (misalnya, pom.xml atau build.gradle).

• Konflik dependensi: Beberapa versi dependensi yang sama mungkin ada dalam proyek. Hal ini dapat menyebabkan versi dependensi yang lebih rendah dimuat saat runtime.

• Dependensi tidak diperbarui: Setelah versi dependensi diperbarui, proyek tidak dibangun ulang atau cache tidak dihapus, sehingga versi lama tetap digunakan.

• Lingkungan kompilasi dan runtime tidak konsisten: Versi dependensi yang digunakan saat kompilasi tidak konsisten dengan versi dependensi saat runtime.

• Konflik classpath: Classpath yang salah dipilih saat impor.

Solusi:

1. Periksa bahwa classpath benar dengan merujuk pada contoh yang disediakan di Portal OpenAPI Alibaba Cloud.

2. Jika classpath benar, Anda dapat mengambil kelas spesifik tempat error terjadi dari informasi stack pengecualian, lalu menemukan dependensi dan versi yang sesuai.

3. Jalankan perintah berikut untuk melihat dependensi langsung dan transitif proyek, beserta konflik dan duplikasi spesifiknya.

   • Maven: Maven menggunakan kebijakan "jalur terpendek lebih dulu" dan "urutan deklarasi lebih dulu" secara default untuk menentukan versi dependensi yang akan digunakan. Oleh karena itu, Anda dapat menyelesaikan konflik dengan menyesuaikan urutan dependensi.

     mvn dependency:tree -Dverbose

   • Gradle: Gradle menggunakan kebijakan "versi tertinggi lebih dulu" secara default untuk penyelesaian konflik. Oleh karena itu, hanya kasus versi usang yang ada. Lanjutkan ke langkah 4 untuk mendapatkan versi terbaru dependensi.

4. Dalam pohon dependensi keluaran, periksa adanya konflik antara dependensi dan dependensi induknya. Jika ada konflik, pindahkan versi tertinggi dependensi atau dependensi induknya ke bagian atas bagian <dependencies></dependencies> dalam pom.xml. Setelah menjalankan mvn clean install -U untuk membangun ulang, lanjutkan ke langkah berikutnya jika error masih berlanjut.

5. Temukan versi terbaru dependensi yang sesuai dari Paket dependensi umum Java SDK V2.0 dan tentukan versi terbaru dalam file konfigurasi alat build, seperti Maven atau Gradle (misalnya, pom.xml atau build.gradle).

6. Jalankan perintah berikut untuk membersihkan dan membangun ulang proyek:

   • Maven

     mvn clean install -U

   • Gradle:

     gradle clean build --refresh-dependencies

7. Verifikasi bahwa masalah telah terselesaikan.

Contoh:

Misalnya, informasi pengecualian adalah java.lang.NoSuchMethodError: com.aliyun.credentials.Client.getCredential().

1. Setelah memeriksa, Anda memastikan bahwa classpath benar.

2. Pengecualian terjadi di kelas com.aliyun.credentials.Client, yang merupakan bagian dari dependensi credentials-java. Versi saat ini adalah 0.2.4.

3. Setelah menjalankan mvn dependency:tree -Dverbose, Anda menemukan bahwa dependensi induk tea-openapi dari credentials-java mengalami konflik versi. Versi yang saat ini dirujuk adalah 0.3.2, dan versi yang bertentangan adalah 0.3.8. Kami menyarankan agar Anda memindahkan dependensi induk yang sesuai dengan versi 0.3.8 dari tea-openapi ke bagian atas bagian <dependencies></dependencies>.

4. Jalankan perintah mvn clean install -U untuk membersihkan dan membangun ulang proyek, lalu verifikasi bahwa masalah telah terselesaikan.

5. Jika masalah masih berlanjut, Anda dapat mengambil versi terbaru credentials-java dari Maven Central: com.aliyun:credentials-java dan menambahkan dependensi tersebut secara manual ke pom.xml.

"TeaUnretryableException: timeout", "java.net.SocketTimeoutException: connect timed out", "java.net.SocketTimeoutException: Read timed out", "SDK.ServerUnreachable", "Connection aborted", atau "RemoteDisconnected".

Masalah timeout dapat disebabkan oleh berbagai faktor. Berikut adalah beberapa penyebab umum dan solusinya:

// Pengaturan timeout parameter runtime, yang hanya berlaku untuk permintaan yang menggunakan instance parameter runtime.
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.connectTimeout = 5000;

// Pengaturan timeout parameter runtime, yang hanya berlaku untuk permintaan yang menggunakan instance parameter runtime.
RuntimeOptions runtimeOptions = new RuntimeOptions();
runtimeOptions.readTimeout = 10000;

Permintaan Anda ditolak karena kurangnya perlindungan ssl.RequestId .

Masalah ini terjadi karena operasi memerlukan pemanggilan melalui protokol HTTPS, tetapi Anda menggunakan protokol HTTP.

Solusi:

• Untuk SDK V1.0, Anda dapat mengatur permintaan agar dikirim melalui protokol HTTPS untuk objek Request:

  request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);

• Gunakan SDK V2.0. SDK V2.0 menggunakan protokol HTTPS secara default.

kode: 404, API yang ditentukan tidak ditemukan, harap periksa URL dan metode Anda.

Penyebab jenis error ini mungkin karena Anda menentukan Endpoint atau RegionId yang salah saat memanggil API layanan Alibaba Cloud. Solusinya sebagai berikut:

Pastikan wilayah yang Anda pilih mendukung layanan yang Anda panggil. Anda dapat menemukan Endpoint layanan Alibaba Cloud di halaman utama layanan tersebut di Portal Pengembang OpenAPI. Contoh ini menggunakan Layanan Pesan Singkat.

Kode respons tak terduga untuk CONNECT: 400.

Penyebab masalah ini adalah permintaan tidak dikirim ke gerbang Alibaba Cloud dan diblokir oleh node perantara.

Solusi:

• Layanan proxy mungkin dikonfigurasi secara salah, artinya layanan proxy tidak dapat meneruskan permintaan ke gerbang Alibaba Cloud dengan benar. Anda dapat menggunakan curl untuk memeriksa apakah konfigurasi proxy benar: `curl https://<nama domain layanan Alibaba Cloud>/ -v -x <alamat IP proksi/nama domain proksi>:<port proksi>`. Misalnya: `curl https://ecs-cn-hangzhou.aliyuncs.com/ -v -x 127.0.0.1:3128`.

• Permintaan mungkin diblokir oleh firewall internal. Di lingkungan lokal Anda, Anda dapat mencoba mengganti lingkungan jaringan untuk pengujian, misalnya dengan menghubungkan ke hotspot jaringan seluler.

Tidak dapat mengatur bidang java.lang.String com.aliyun.imm20200930.models.GenerateWebofficeTokenShrinkRequest.userShrink ke java.util .

Penyebab masalah ini adalah versi paket Tea yang lebih lama tidak dapat mengubah struktur kompleks menjadi String, sehingga menyebabkan error.

Solusi:

Tingkatkan paket Tea ke versi 1.2.7 atau lebih baru.

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>tea</artifactId>
  <version>1.2.7</version>
</dependency>

Gagal mengunduh dependensi secara otomatis menggunakan Maven di IDEA.

• Perbarui repositori Maven

  Buka menu "File" dan pilih "Pengaturan (Settings)" (atau "Preferensi (Preferences)"). Di panel navigasi sebelah kiri, perluas "Build, Execution, Deployment", lalu pilih "Build Tools" > "Maven". Temukan tab "Repositories", pilih repositori lokal, klik tombol "Update", dan tunggu hingga pembaruan selesai.

• Periksa cache IDEA

  Buka menu "File", pilih "Invalidate Caches...", pilih "Invalidate and Restart" di kotak dialog yang muncul, dan tunggu hingga IDEA membersihkan cache dan memulai ulang.

  

• Periksa konektivitas jaringan

  Jika Maven tidak dapat terhubung ke repositori pusat atau repositori jarak jauh lainnya, Maven mungkin tidak dapat mengunduh dependensi. Pastikan konektivitas jaringan Anda normal dan tidak ada firewall atau server proxy yang memblokir akses Maven.

• Periksa konfigurasi Maven

  Periksa apakah file konfigurasi Maven (biasanya settings.xml) dikonfigurasi dengan benar. Pastikan "localRepository" mengarah ke jalur repositori lokal yang benar dan "mirrors", "proxies", serta "profiles" dikonfigurasi dengan benar.

Cara menghindari pesan peringatan yang disebabkan oleh refleksi.

Saat Anda menggunakan Alibaba Cloud SDK untuk pengembangan dengan versi JDK yang lebih baru, Anda mungkin mengalami pesan peringatan terkait refleksi. Pesan peringatan ini dapat memengaruhi keluaran program, terutama saat Anda ingin menghindari informasi log yang tidak perlu di lingkungan produksi.

Solusi:

Anda dapat mengatur variabel lingkungan ALIBABA_CLOUD_SDK_LOG_LEVEL ke ERROR untuk menekan pesan peringatan. Prosedurnya sebagai berikut:

1. Atur variabel lingkungan:

   Windows

   set ALIBABA_CLOUD_SDK_LOG_LEVEL=ERROR

   Linux/macOS

   export ALIBABA_CLOUD_SDK_LOG_LEVEL=ERROR

2. Konfirmasi pengaturan variabel lingkungan:

   Windows

   echo %ALIBABA_CLOUD_SDK_LOG_LEVEL%

   Linux/macOS

   echo $ALIBABA_CLOUD_SDK_LOG_LEVEL

3. Jalankan aplikasi Anda: Setelah Anda mengonfigurasi variabel lingkungan, jalankan aplikasi Java Anda. Pesan peringatan yang dihasilkan oleh Alibaba Cloud SDK tidak akan ditampilkan. Anda hanya akan melihat informasi log pada tingkat ERROR atau lebih tinggi.

Tanda tangan yang ditentukan tidak cocok dengan perhitungan kami.

Penyebab masalah ini biasanya karena tanda tangan permintaan tidak cocok dengan tanda tangan yang dihitung oleh server. Penyebab yang mungkin, namun tidak terbatas pada, meliputi:

• AccessKey (AK) disalin secara salah.

• Algoritma tanda tangan yang salah digunakan.

• Parameter permintaan atau urutannya tidak memenuhi persyaratan API.

Solusi:

1. Pastikan AccessKey dan rahasia AccessKey yang diatur dalam kode persis sama dengan yang Anda peroleh dari konsol. Periksa adanya spasi tambahan atau karakter khusus. Untuk melihat AccessKey, lihat Lihat informasi AccessKey pengguna RAM.

2. Tingkatkan versi commons-codec untuk menghindari potensi kesalahan perhitungan tanda tangan:

   Perbarui dependensi:

   Maven

   Modifikasi file pom.xml

   <dependency>
      <groupId>commons-codec</groupId>
      <artifactId>commons-codec</artifactId>
      <version>1.15</version> <!-- Versi yang diperbarui -->
   </dependency>

   Setelah memperbarui nomor versi, jalankan perintah berikut:

   mvn clean install

   Gradle

   Tambahkan atau perbarui dependensi dalam file build.gradle:

   dependencies {
        implementation 'commons-codec:commons-codec:1.15' // Versi yang diperbarui
   }

   Jalankan perintah berikut untuk membangun proyek:

   gradle build

3. Jika Anda menggunakan tanda tangan kustom, periksa dengan cermat apakah logika kode konsisten dengan logika yang dijelaskan dalam Mekanisme badan permintaan dan tanda tangan V3.

SDK.EndpointResolvingError: "Tidak ada wilayah 'cn-XX'. Harap periksa ID wilayah Anda".

Penyebab masalah ini adalah versi SDK terlalu lama sehingga tidak mendukung pemanggilan wilayah atau operasi baru. Solusi:

Tingkatkan versi dependensi SDK:

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <version>4.7.2</version>
</dependency>

dependencies {
    implementation 'com.aliyun:aliyun-java-sdk-core:4.7.2'
    implementation 'com.aliyun:aliyun-java-sdk-sts:3.1.2'
}

Gagal membuat instance [com.aliyuncs.IAcsClient]: Metode pabrik 'iAcsClient' melemparkan pengecualian dengan pesan: org/apache/http/conn/ssl/DefaultHostnameVerifier .

Penyebab masalah ini adalah penggunaan versi pustaka Apache HttpClient yang tidak kompatibel dengan Alibaba Cloud SDK, sehingga menyebabkan error. Solusi:

• Jika proyek menggunakan beberapa pustaka dependensi, pastikan tidak ada pustaka lain yang memperkenalkan versi HttpClient yang tidak kompatibel. Anda dapat memeriksanya secara manual atau menggunakan fitur manajemen dependensi dari alat build Anda.

• Versi Apache HttpClient terlalu lama. Kami menyarankan agar Anda memperbaruinya ke versi 4.5.14 atau lebih baru.

  <dependency>
      <groupId>org.apache.httpcomponents.client</groupId>
      <artifactId>httpclient</artifactId>
      <version>4.5.14</version> <!-- Harap periksa versi terbaru -->
  </dependency>

Kode error 401 'Anda belum mengaktifkan layanan XXX' atau pesan serupa dilaporkan saat Anda memanggil operasi OpenAPI.

Error ini menunjukkan bahwa akun Alibaba Cloud yang Anda gunakan belum mengaktifkan atau mengaktifkan layanan yang sesuai. XXX menunjukkan nama layanan spesifik, seperti layanan OCR. Solusi:

1. Login ke konsol manajemen untuk layanan yang sesuai.

2. Temukan dan aktifkan fitur yang diperlukan.

3. Tunggu hingga layanan berlaku, lalu panggil operasi tersebut lagi.

Gagal memperoleh kredensial sesi RAM dari layanan metadata ECS. HttpCode=XX

Kredensial peran RAM instans untuk instans ECS (ecs_ram_role) hanya dapat digunakan di instans ECS atau ECI, dan peran RAM harus dikaitkan dengan instans tersebut. Untuk informasi selengkapnya, lihat Peran RAM Instans dan Gunakan peran RAM instans dengan memanggil API.

• Untuk memverifikasi apakah Anda dapat menggunakan kredensial ini dalam proyek Anda, Anda dapat menjalankan perintah berikut di instans ECS:

  • Instans Linux

    # Peroleh token akses metadata. Anda harus menetapkan periode validitas. Header X-Forwarded-For tidak boleh disertakan. 100.100.100.200 menunjukkan alamat IPv4 layanan metadata instans.
    TOKEN=`curl -X PUT "http://100.100.100.200/latest/api/token" -H "X-aliyun-ecs-metadata-token-ttl-seconds:<Periode validitas token akses metadata>"`
    # Akses metadata instans.
    curl -H "X-aliyun-ecs-metadata-token: $TOKEN" http://100.100.100.200/latest/meta-data/ram/security-credentials/[role-name]

  • Instans Windows (PowerShell)

    # Peroleh token akses metadata. Anda harus menetapkan periode validitas. Header X-Forwarded-For tidak boleh disertakan. 100.100.100.200 menunjukkan alamat IPv4 layanan metadata instans.
    $token = Invoke-RestMethod -Headers @{"X-aliyun-ecs-metadata-token-ttl-seconds" = "<Periode validitas token akses metadata>"} -Method PUT -Uri http://100.100.100.200/latest/api/token
    # Akses metadata instans.
    Invoke-RestMethod -Headers @{"X-aliyun-ecs-metadata-token" = $token} -Method GET -Uri http://100.100.100.200/latest/meta-data/ram/security-credentials/[role-name]

  Jika konten berikut dikembalikan, proyek Anda dapat menggunakan kredensial peran RAM instans untuk instans ECS (ecs_ram_role) di dalam instans tersebut.

  {
    "AccessKeyId" : "AccessKeyIdValue",
    "AccessKeySecret" : "AccessKeySecretValue",
    "Expiration" : "2025-07-10T08:37:58Z",
    "SecurityToken" : "SecurityTokenValue",
    "LastUpdated" : "2025-07-10T02:33:26Z",
    "Code" : "Success"
  }

• Untuk beralih ke kredensial lainnya, lihat Kelola kredensial akses.

Ada risiko kebocoran AccessKey ini

Penyebab: Saat informasi yang dikembalikan berisi prompt ini, berarti AccessKey (AK) Anda mungkin berisiko bocor, dan Alibaba Cloud telah memberlakukan pembatasan perlindungan pada AK tersebut.

Solusi: Lihat Solusi untuk kebocoran pasangan AccessKey.

Permintaan ditolak karena pengendalian alur api

Penyebab: Frekuensi tinggi pemanggilan SDK dapat menyebabkan server mengembalikan error, seperti "ThrottlingException".

Solusi:

• Terapkan mekanisme percobaan ulang permintaan dan tingkatkan interval waktu antar permintaan untuk mengurangi beban server.

• Optimalkan logika kode dan pertimbangkan untuk menggunakan pemrosesan batch atau pemanggilan asinkron untuk mengurangi jumlah permintaan API.

AccessKey yang ditentukan ditolak karena kebijakan akses

Penyebab: Kebijakan pembatasan akses jaringan AccessKey dikonfigurasi untuk membatasi alamat IP sumber untuk permintaan API yang menggunakan AccessKey permanen.

Solusi:

• Ubah rentang alamat IP dalam kebijakan pembatasan akses jaringan AccessKey.

• Jangan aktifkan kebijakan pembatasan akses jaringan AccessKey.

Untuk informasi selengkapnya, lihat Kebijakan pembatasan akses jaringan AccessKey.

com.aliyuncs.exceptions.ClientException: SDK.InvalidRegionId : Tidak dapat menemukan titik akhir untuk diakses

Penyebab: Konfigurasi parameter yang salah dapat menyebabkan layanan gagal atau mengembalikan error. Contohnya adalah pengaturan regionId yang salah.

Solusi:

• Berdasarkan dokumentasi dan contoh kode yang disediakan oleh Alibaba Cloud, pastikan semua parameter konfigurasi, seperti Endpoint, RegionId, dan parameter permintaan lainnya, diisi dengan benar.

• Anda dapat melakukan debugging API di Portal Pengembang OpenAPI. Setelah debugging berhasil, Anda dapat mengunduh kode proyek contoh lengkap untuk debugging lokal.

Solusi untuk masalah di atas dimaksudkan untuk membantu Anda menggunakan Alibaba Cloud SDK dengan lebih mudah. Jika Anda mengalami masalah lain, Anda dapat menghubungi kami melalui cara berikut:

• Kirim tiket: Halaman pengiriman tiket Alibaba Cloud.

• Jika Anda memiliki kebutuhan atau masukan terkait, Anda dapat bergabung dengan grup DingTalk untuk menghubungi insinyur dukungan teknis Alibaba Cloud. Nomor grupnya adalah 60965016010.