Saat permintaan API dibuat melalui Apigee, Router dan Message Processor komponen Apigee, atau server
backend dapat menampilkan error ke aplikasi klien.
Error dari Pemroses Pesan
Message Processor adalah komponen inti Apigee yang memproses kebijakan dan berinteraksi dengan server backend. Fungsi ini dapat menampilkan error jika mendeteksi masalah seperti:
Masalah konektivitas jaringan, kegagalan TLS handshake, ketidaktersediaan server backend,
tidak adanya respons selama komunikasi dengan server backend
Kegagalan selama eksekusi kebijakan
Header HTTP, encoding, jalur, ketidakpatuhan terhadap spesifikasi HTTP, melebihi batas produk, dll. yang tidak valid:
Dengan permintaan HTTP yang dikirim oleh aplikasi klien
ATAU
Dengan respons HTTP yang dikirim oleh server backend
Dan masih banyak lagi
Contoh error dari Message Processor
Pemroses Pesan selalu menampilkan kode status HTTP, diikuti dengan pesan error beserta kode error dalam format JSON seperti yang ditunjukkan di bawah:
Aplikasi klien mendapatkan kode respons seperti contoh berikut:
HTTP/1.1 504 Gateway Timeout
Respons error dari Message Processor muncul dalam format berikut:
Berisi pesan error yang menjelaskan kemungkinan penyebab error
errorcode
Kode error (juga disebut sebagai kode error) yang terkait dengan
error
reason
Berisi pesan yang menunjukkan kemungkinan alasan terjadinya error
Katalog error runtime
Katalog error ini memberikan semua informasi yang perlu Anda ketahui tentang kode error
runtime (untuk error non-kebijakan) yang ditampilkan oleh komponen Apigee Message
Processor. Laporan ini mencakup informasi berikut untuk setiap kode error:
Kode Status HTTP
Pesan error
Alasan error (tidak semua pesan error menampilkan
reason)
Kemungkinan penyebab error
Spesifikasi HTTP dan/atau batasan produk yang terkait
Playbook dan video yang berisi petunjuk untuk mendiagnosis penyebab error dan solusi efektif yang dapat Anda terapkan untuk mengatasi error sendiri (jika tersedia)
Perbaikan yang dapat Anda terapkan untuk mengatasi error sendiri
Gunakan kotak Telusuri di bawah untuk memfilter tabel guna menampilkan informasi di atas untuk kode error tertentu. Anda dapat menelusuri kode status atau konten apa pun di kolom apa pun
dalam tabel.
searchPenelusuran
Kode error
Deskripsi
Perbaiki
flow.*
flow.APITimedOut
Kode status HTTP:
504 Gateway Timeout
Pesan error:
API timed out
Kemungkinan penyebab:
Error ini terjadi jika:
Server backend tidak merespons kembali dalam periode waktu tunggu yang dikonfigurasi
oleh properti
api.timeout untuk Proxy API tertentu.
Kebijakan memerlukan waktu lama karena operasi yang intensif secara komputasi, beban
tinggi, atau performa yang buruk.
Encoding yang ditentukan dalam header permintaan HTTP
Content-Encoding valid dan didukung oleh Apigee,
BUT
Format payload yang dikirim oleh klien sebagai bagian dari permintaan HTTP tidak cocok dengan format encoding yang ditentukan dalam header Content-Encoding
Encoding yang ditentukan dalam header respons HTTP server backend/target Content-Encoding valid dan didukung oleh Apigee,
BUT
Format payload yang dikirim oleh server backend/target sebagai
bagian dari respons HTTP tidak cocok dengan format encoding yang ditentukan dalam
header Content-Encoding
messaging.adaptors.http.flow.ErrorResponseCode
Kode status HTTP:
500
Pesan error:
Pesan dan format Error dapat bervariasi bergantung pada implementasi server backend.
Kemungkinan penyebab:
Error ini terjadi jika server backend merespons dengan kode status 500 ke Apigee.
Kode status HTTP:
503
Pesan error:
Pesan dan format Error dapat bervariasi bergantung pada implementasi server backend.
Kemungkinan penyebab:
Error ini terjadi jika server backend merespons dengan kode status 503 ke Apigee.
Kode status HTTP:
504
Pesan error:
Pesan dan format Error dapat bervariasi bergantung pada implementasi server backend.
Kemungkinan penyebab:
Error ini terjadi jika server backend merespons dengan kode status 504 ke Apigee.
Catatan: Kode error
messaging.adaptors.http.flow.ErrorResponseCode tidak ditampilkan
sebagai bagian dari pesan error yang dikirim ke aplikasi klien. Hal ini
karena kode error ini ditetapkan oleh Apigee setiap kali server backend
merespons dengan error dan salah satu kode status
4XX atau 5XX. Anda dapat melihat kode error ini di database Pemantauan API atau analisis.
messaging.adaptors.http.flow.GatewayTimeout
Kode status HTTP:
504 Gateway Timeout
Pesan error:
Gateway Timeout
Alasan:
TARGET_READ_TIMEOUT
Kemungkinan penyebab:
Error ini terjadi jika server backend tidak merespons kembali
ke Pemroses Pesan Apigee dalam
periode waktu tunggu I/O yang dikonfigurasi di Pemroses Pesan.
messaging.adaptors.http.flow.LengthRequired
Kode status HTTP:
411 Length Required
Pesan error:
'Content-Length' is missing
Alasan:
CLIENT_REQUEST_CONTENT_LENGTH_REQUIRED
Kemungkinan penyebab:
Error ini terjadi jika header Content-Length tidak diteruskan oleh
aplikasi klien sebagai bagian dari permintaan HTTP POST dan PUT
yang dikirim ke Apigee.
Catatan: Permintaan yang gagal dengan error
ini tidak dapat direkam di alat Trace, karena Message Processor melakukan
validasi ini pada fase yang sangat awal, jauh sebelum memproses permintaan dan
menjalankan kebijakan apa pun di API Proxy.
Untuk mengatasi error ini, lakukan langkah-langkah berikut:
Pastikan aplikasi klien selalu meneruskan header
Content-Length sebagai bagian dari permintaan HTTP POST dan
PUT yang dikirim ke Apigee. Contoh:
curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"
Meskipun Anda meneruskan payload kosong dengan permintaan POST dan
PUT, pastikan header
Content-Length: 0 diteruskan. Contoh:
curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"
messaging.adaptors.http.flow.NoActiveTargets
Kode status HTTP:
503 Service Unavailable
Pesan error:
The Service is temporarily unavailable
Alasan:
TARGET_HEALTHCHECK_CONNECT_TIMEOUT
TARGET_HEALTHCHECK_CONNECTION_REFUSED
TARGET_HEALTHCHECK_HTTPS_REQUEST_OVER_HTTP
TARGET_HEALTHCHECK_UNEXPECTED_EOF
Kemungkinan penyebab:
Error ini terjadi dalam salah satu skenario berikut,
jika Anda menggunakan
TargetServer di Apigee:
Resolusi DNS host server backend yang salah
oleh server otorisasi kustom menyebabkan alamat IP yang buruk sehingga
menyebabkan error koneksi.
Error waktu tunggu koneksi karena:
Pembatasan firewall di server backend mencegah Apigee terhubung ke server backend.
Masalah konektivitas jaringan antara Apigee dan server backend.
Host yang ditentukan di TargetServer salah atau
memiliki karakter yang tidak diinginkan (seperti spasi).
Error ini juga dapat terjadi jika health check yang dikonfigurasi untuk memantau health check server target gagal.
messaging.adaptors.http.flow.RequestTimeOut
Kode status HTTP:
408 Request Timeout
Pesan error:
Request timed out
Alasan:
CLIENT_READ_TIMEOUT
Kemungkinan penyebab:
Error ini terjadi jika Pemroses Pesan Apigee tidak menerima payload permintaan dari aplikasi klien selama periode waktu tunggu I/O yang dikonfigurasi pada komponen Pemroses Pesan.
Perbaiki
Pastikan aplikasi klien mengirimkan payload permintaan dalam
periode waktu tunggu I/O yang dikonfigurasi pada komponen Message Processor Apigee.
messaging.adaptors.http.flow.ServiceUnavailable
Kode status HTTP:
503 Service Unavailable
Pesan error:
The Service is temporarily unavailable
Alasan:
TARGET_CONNECT_TIMEOUT
TARGET_WRITE_BROKEN_PIPE
TARGET_WRITE_CONNECTION_RESET_BY_PEER
TARGET_CONNECT_CONNECTION_REFUSED
Kemungkinan penyebab:
Error ini terjadi dalam salah satu skenario berikut:
Resolusi DNS yang salah dari host server backend
oleh server otorisasi kustom menyebabkan alamat IP yang buruk sehingga
menyebabkan error koneksi.
Error waktu tunggu koneksi habis karena:
Pembatasan firewall di server backend mencegah Apigee terhubung ke server backend.
Masalah konektivitas jaringan antara Apigee dan
server backend.
Host server target yang ditentukan di Endpoint Target salah atau memiliki karakter yang tidak diinginkan (seperti spasi).
Error ini juga dapat terjadi jika server backend menutup koneksi sebelum waktunya
saat Pemroses Pesan masih mengirim payload permintaan ke
server backend.
messaging.adaptors.http.flow.SslHandshakeFailed
Kode status HTTP:
503 Service Unavailable
Pesan error:
SSL Handshake failed {error_message}
Kemungkinan penyebab:
Error ini terjadi selama proses handshake SSL antara Message Processor
Apigee dan server backend jika:
Truststore Message Processor Apigee:
Berisi rantai sertifikat yang tidak cocok dengan rantai sertifikat lengkap
server backend
ATAU
Tidak berisi rantai sertifikat lengkap server backend
Rantai sertifikat yang ditampilkan oleh server backend:
Berisi Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) yang tidak cocok dengan nama host yang ditentukan di endpoint target
ATAU
Berisi rantai sertifikat yang salah/tidak lengkap
Server backend menolak versi TLS yang digunakan oleh Apigee.
Misalnya, jika server backend hanya menerima TLS versi 1.3, tetapi
server target di sisi Apigee memiliki TLS versi 1.2 yang ditetapkan di
kolom TLS Protocol-nya (atau tidak ada versi TLS yang ditetapkan sama sekali, dalam hal ini
Apigee saat ini tidak akan menggunakan TLS versi 1.3 sebagai default), koneksi akan gagal karena ketidakcocokan versi protokol.
Error ini terjadi dalam salah satu skenario berikut:
TargetServer tidak dikonfigurasi dengan benar untuk mendukung koneksi TLS/SSL
di Apigee.
Server backend dapat menutup koneksi secara tiba-tiba,
saat Apigee menunggu respons dari server backend.
Timeout keep-alive yang salah dikonfigurasi di server backend dan Apigee.
messaging.runtime.*
messaging.runtime.RouteFailed
Kode status HTTP:
500 Internal Server Error
Pesan error:
Unable to route the message to a TargetEndpoint
Kemungkinan penyebab:
Error ini terjadi jika Apigee tidak dapat merutekan permintaan ke salah satu TargetEndpoints karena:
Tidak ada kondisi aturan rute (<RouteRule>) yang cocok dengan permintaan di proxy
DAN
Tidak ada aturan rute default yang ditentukan di ProxyEndpoint
(yaitu, <RouteRule> tanpa kondisi apa pun)
Perbaiki
Untuk mengatasi error ini, ikuti petunjuk berikut:
Tinjau aturan rute yang ditentukan di ProxyEndpoint dan ubah untuk memastikan bahwa
setidaknya ada satu kondisi aturan rute yang cocok dengan permintaan Anda.
Sebaiknya tentukan aturan rute default tanpa kondisi
jika Anda memiliki beberapa RouteRules.
Pastikan aturan rute default selalu ditentukan terakhir dalam daftar Rute bersyarat karena aturan dievaluasi dari atas ke bawah di ProxyEndpoint.
Untuk mempelajari lebih lanjut cara menentukan kondisi <RouteRule> di ProxyEndpoint, lihat
Target Bersyarat.
protocol.http.* - Caused due to bad request
protocol.http.BadFormData
Kode status HTTP:
500 Internal Server Error
Pesan error:
Bad Form Data
Kemungkinan penyebab:
Error ini terjadi jika dan hanya jika semua kondisi berikut terpenuhi:
Permintaan HTTP yang dikirim oleh klien ke Apigee
berisi:
Content-Type: application/x-www-form-urlencoded,
dan
Data formulir dengan tanda persen (%), atau tanda persen (%) diikuti dengan karakter heksadesimal yang tidak valid dan tidak diizinkan
sesuai dengan
Formulir - Bagian 17.13.4.1.
Proxy API di Apigee membaca parameter formulir tertentu
yang berisi karakter apa pun yang tidak diizinkan menggunakan
kebijakan ExtractVariables atau AssignMessage dalam alur permintaan.
protocol.http.DuplicateHeader
Kode status HTTP:
400 Bad Request
Pesan error:
Duplicate Header "{header_name}"
Kemungkinan penyebab:
Error ini terjadi jika header HTTP tertentu yang tidak diizinkan untuk memiliki duplikat
di Apigee, muncul lebih dari sekali dengan nilai yang sama atau berbeda sebagai bagian dari
permintaan HTTP yang dikirim oleh aplikasi klien ke Apigee.
Pastikan permintaan HTTP yang dikirim oleh aplikasi klien
ke Apigee selalu berisi nama header yang valid sesuai dengan
RFC 7230, bagian 3.2: Kolom Header.
protocol.http.HeaderNameWithNonAsciiChar
Kode status HTTP:
400 Bad Request
Pesan error:
Header {header_name} contains non ascii character {character}
Kemungkinan penyebab:
Error ini terjadi jika nama header yang dikirim sebagai bagian dari permintaan HTTP
oleh aplikasi klien ke Apigee berisi karakter non-ASCII.
Header {header_name} contains invalid character {character}
Kemungkinan penyebab:
Error ini terjadi jika nama header yang dikirim sebagai bagian dari permintaan HTTP
oleh aplikasi klien ke Apigee berisi karakter yang tidak valid seperti
sama dengan (=), koma (,), titik koma (;), tab, CRLF, dan karakter Newline.
Pastikan permintaan HTTP yang dikirim oleh aplikasi klien ke Apigee tidak
berisi karakter yang tidak valid dalam nama header sesuai dengan
RFC 7230, bagian 3.2.6: Komponen Nilai Kolom
protocol.http.NoResolvedHost
Kode status HTTP:
503 Service Unavailable
Pesan error:
Unable to resolve host {hostname}
Dengan: {hostname} bersifat dinamis dan nilainya
akan berubah sehubungan dengan nama host yang diberikan.
Alasan:
TARGET_CONNECT_HOST_NOT_REACHABLE
Kemungkinan penyebab:
Error ini terjadi jika host server target yang ditentukan
salah atau memiliki karakter yang tidak diinginkan (seperti spasi).
protocol.http.InvalidPath
Kode status HTTP:
400 Bad Request
Pesan error:
Invalid path {path}
Kemungkinan penyebab:
Error ini terjadi jika jalur di URL permintaan HTTP yang dikirim oleh aplikasi klien
ke Apigee berisi karakter yang tidak diizinkan sesuai spesifikasi
RFC 3986, bagian 3.3: Jalur.
Pastikan bahwa jalur di URL permintaan HTTP yang dikirim oleh aplikasi
klien ke
Apigee tidak berisi karakter apa pun yang tidak diizinkan sebagai
per RFC 3986, bagian 3.3: Jalur.
protocol.http.TooBigBody
Kode status HTTP:
413 Request Entity Too Large
Pesan error:
Body buffer overflow
Kemungkinan penyebab:
Error ini terjadi jika ukuran payload yang dikirim oleh aplikasi klien sebagai bagian dari permintaan HTTP ke Apigee lebih besar dari batas yang diizinkan di Apigee.
Ukuran total semua header permintaan yang dikirim oleh aplikasi
klien sebagai bagian dari permintaan HTTP ke Apigee lebih besar dari batas
yang diizinkan di Apigee.
Error ini terjadi jika ukuran baris permintaan yang dikirim oleh aplikasi klien sebagai bagian dari permintaan HTTP ke Apigee lebih besar dari batas yang diizinkan di Apigee.
Error ini terjadi jika header Content-Encoding yang dikirim oleh klien
sebagai bagian dari respons HTTP berisi format encoding/payload yang tidak
didukung oleh Apigee.
Error ini terjadi jika URL permintaan server backend, yang diwakili oleh variabel alur target.url, berisi jalur yang dimulai dengan tanda tanya (?), bukan garis miring (/), yang tidak valid.
Error ini terjadi jika header HTTP tertentu yang tidak diizinkan untuk memiliki duplikat
di Apigee, muncul lebih dari sekali dengan nilai yang sama atau berbeda sebagai bagian dari
respons HTTP yang dikirim oleh server backend ke Apigee.
Pastikan respons HTTP yang dikirim oleh server backend ke Apigee selalu berisi nama header yang valid sesuai dengan
RFC 7230, bagian 3.2: Kolom Header.
protocol.http.EmptyPath
Kode status HTTP:
500 Internal Server Error
Pesan error:
Request path cannot be empty
Kemungkinan penyebab:
Error ini terjadi jika URL permintaan HTTP server backend, yang diwakili oleh variabel alur target.url, berisi jalur kosong.
Header {header_name} contains invalid character {character}
Kemungkinan penyebab:
Error ini terjadi jika nama header yang dikirim oleh server backend sebagai bagian dari respons HTTP,
berisi karakter yang tidak valid seperti sama dengan (=), koma (,), titik koma (;), tab,
CRLF, dan karakter Newline.
Proxy refused to create tunnel with response status {status code}
Kemungkinan penyebab:
Error ini terjadi selama pembuatan tunnel antara Apigee dan
server backend oleh server proxy karena masalah firewall, ACL (Daftar Kontrol Akses), DNS, ketersediaan server backend, dll.
Catatan:Kode status dalam pesan error
(faultstring) memberikan penyebab masalah tingkat tinggi.
protocol.http.Response306Reserved
Kode status HTTP:
502 Bad Gateway
Pesan error:
Response Status code 306 is reserved, so can't be used.
Kemungkinan penyebab:
Error ini terjadi jika server backend merespons kembali dengan kode status 306 ke Apigee.
Kode status 306 ditentukan dalam versi sebelumnya dari
spesifikasi HTTP. Sesuai dengan spesifikasi HTTP saat ini, kode ini
dicadangkan dan tidak boleh digunakan.
Error ini terjadi jika respons HTTP dari server backend ke Apigee adalah
204 No Content atau
205 Reset Content, tetapi berisi
isi respons dan/atau satu atau beberapa header berikut:
Error ini terjadi jika ukuran payload yang dikirim oleh aplikasi klien sebagai bagian dari permintaan HTTP ke Apigee lebih besar dari batas yang diizinkan di Apigee.
Error ini terjadi jika total ukuran semua header respons yang dikirim oleh
server backend sebagai bagian dari respons HTTP ke Apigee lebih besar dari
batas yang diizinkan di Apigee.
Error ini terjadi jika ukuran baris respons yang dikirim oleh server backend sebagai
bagian dari respons HTTP ke Apigee lebih besar dari batas yang diizinkan di Apigee
Edge.
Error ini terjadi jika header Content-Encoding yang dikirim oleh
server backend sebagai bagian dari respons HTTP berisi format encoding/payload
yang tidak didukung oleh Apigee.
KeyAlias {KeyAlias_name} is not found in
Keystore {Keystore_Name}
Kemungkinan penyebab:
Error ini terjadi jika KeyAlias tertentu yang dirujuk di TargetEndpoint
atau TargetServer tidak ditemukan di Keystore tertentu.
Perbaiki
Pastikan KeyAlias yang ditentukan di TargetEndpoint atau TargetServer
ada dan merupakan bagian dari Keystore tertentu.
security.util.TrustStoreWithNoCertificates
Kode status HTTP:
500 Internal Server Error
Pesan error:
TrustStore {truststore_name} has no certificates
Kemungkinan penyebab:
Error ini terjadi jika Truststore tertentu yang dirujuk di TargetEndpoint atau
TargetServer tidak berisi sertifikat apa pun.
Perbaiki
Jika Anda ingin memvalidasi sertifikat server backend dan
ingin menggunakan Truststore di TargetEndpoint atau TargetServer, pastikan Truststore berisi sertifikat server backend yang valid.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2024-12-22 UTC."],[],[]]