Saat permintaan API dibuat melalui Apigee Edge, komponen Apigee Edge, yaitu Router dan Pemroses Pesan, atau server backend dapat menampilkan error ke aplikasi klien.
Error dari Pemroses Pesan
Message Processor adalah komponen inti Apigee Edge yang memproses kebijakan dan berinteraksi dengan server backend. API ini dapat menampilkan error jika mendeteksi masalah seperti:
Masalah konektivitas jaringan, kegagalan TLS handshake, server backend tidak tersedia,
kurangnya respons selama komunikasi dengan server backend
Kegagalan selama eksekusi kebijakan
Header HTTP, encoding, jalur yang tidak valid, tidak mematuhi spesifikasi HTTP, melampaui batas produk, dll.:
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
Message Processor selalu menampilkan kode status HTTP yang 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.1414Request-URI Too Long
Respons error dari Pemroses Pesan muncul dalam format berikut:
Berisi pesan error yang menjelaskan kemungkinan penyebab error
errorcode
Kode error (juga disebut sebagai kode kesalahan) yang terkait dengan
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 Message Processor Apigee Edge. Informasi berikut disertakan untuk setiap kode error:
Kode Status HTTP
Pesan error
Kemungkinan penyebab error
Spesifikasi HTTP dan/atau batas produk 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 Penelusuran 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 mana 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 yang lama karena operasi yang intensif secara komputasi, beban tinggi, atau performa yang buruk.
Catatan: Playbook ini memberikan petunjuk untuk memecahkan masalah kode error
messaging.adaptors.http.flow.GatewayTimeout; namun, Anda dapat menggunakan
playbook yang sama untuk memecahkan masalah kode error flow.APITimedOut.
Encoding yang ditentukan dalam header permintaan HTTP
Content-Encoding valid dan
didukung oleh Apigee Edge,
BUT
Format payload yang dikirim oleh klien sebagai bagian dari permintaan HTTP tidak cocok dengan format encoding yang ditentukan di header Content-Encoding
Encoding yang ditentukan di header respons HTTP Content-Encoding
server backend/target valid dan
didukung oleh Apigee Edge,
BUT
Format payload yang dikirim oleh server backend/target sebagai
bagian dari respons HTTP tidak cocok dengan format encoding yang ditentukan di header
Content-Encoding
Pesan Error dan format dapat bervariasi bergantung pada penerapan server backend.
Kemungkinan penyebab:
Error ini terjadi jika server backend merespons dengan kode
status 504 ke Apigee Edge.
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 Edge setiap kali server backend
merespons dengan error dan salah satu kode status 4XX atau 5XX. Anda dapat melihat kode error ini di Pemantauan API, log akses NGINX, atau database analisis.
messaging.adaptors.http.flow.GatewayTimeout
Kode status HTTP:
504 Gateway Timeout
Pesan error:
Gateway Timeout
Kemungkinan penyebab:
Error ini terjadi jika server backend tidak merespons
Prosesor Pesan Apigee Edge dalam
periode waktu tunggu I/O yang dikonfigurasi di Prosesor Pesan.
Error ini terjadi jika header Content-Length tidak diteruskan oleh
aplikasi klien sebagai bagian dari permintaan POST dan PUT HTTP
yang dikirim ke Apigee Edge.
Catatan: Permintaan yang gagal dengan error ini tidak dapat direkam di alat Trace, karena Pemroses Pesan melakukan validasi ini pada tahap yang sangat awal, jauh sebelum memproses permintaan dan menjalankan kebijakan apa pun di Proxy API.
Error ini terjadi jika Message Processor Apigee Edge tidak menerima
payload permintaan dari aplikasi klien untuk
periode waktu tunggu I/O yang dikonfigurasi pada komponen Message Processor.
Perbaiki
Pastikan aplikasi klien mengirimkan payload permintaan dalam
periode waktu tunggu I/O yang dikonfigurasi pada komponen Message Processor Apigee Edge.
messaging.adaptors.http.flow.ServiceUnavailable
Kode status HTTP:
503 Service Unavailable
Pesan error:
The Service is temporarily unavailable
Kemungkinan penyebab:
Error ini terjadi dalam salah satu skenario berikut:
Resolusi DNS yang salah dari host server backend
oleh server otorisasi kustom mengakibatkan alamat IP yang salah sehingga
menyebabkan error koneksi.
Error waktu tunggu koneksi karena:
Pembatasan firewall di server backend mencegah
Apigee Edge terhubung ke server backend.
Masalah konektivitas jaringan antara Apigee Edge dan server backend.
Host server target yang ditentukan di Target Endpoint salah atau memiliki karakter yang tidak diinginkan (seperti spasi).
Error ini juga dapat terjadi jika server backend menutup koneksi terlalu cepat saat Pemroses Pesan masih mengirimkan payload permintaan ke server backend.
Error ini terjadi jika Apigee Edge tidak dapat merutekan permintaan ke salah satu
TargetEndpoint 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 syarat apa pun)
Perbaiki
Untuk mengatasi error ini, ikuti petunjuk berikut:
Tinjau aturan rute yang ditentukan di ProxyEndpoint Anda dan ubah untuk memastikan
ada setidaknya satu kondisi aturan rute yang cocok dengan permintaan Anda.
Sebaiknya tentukan aturan rute default tanpa kondisi
jika Anda memiliki beberapa RouteRule.
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.
messaging.runtime.SenseRaiseFault
Kode status HTTP:
403 Forbidden
Pesan error:
Sense Fault
Kemungkinan penyebab:
Error ini terjadi jika permintaan API dibuat dari alamat IP klien tertentu yang diblokir sebagai bagian dari aturan Apigee Sense.
Perbaiki
Untuk mengatasi error ini, ikuti petunjuk berikut:
Jika alamat IP klien tertentu tidak diblokir, tetapi Anda masih
mendapatkan error ini, hubungi Dukungan Apigee Edge.
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 Edge
berisi:
Content-Type: application/x-www-form-urlencoded,
dan
Data formulir dengan tanda persen (%), atau tanda persen (%) diikuti dengan karakter heksadesimal tidak valid yang tidak diizinkan sesuai dengan
Formulir - Bagian 17.13.4.1.
Proxy API di Apigee Edge membaca parameter
formulir tertentu yang berisi karakter yang tidak diizinkan menggunakan
kebijakan ExtractVariables atau AssignMessage dalam alur permintaan.
Error ini terjadi jika header HTTP tertentu yang tidak diizinkan memiliki duplikat
di Apigee Edge, muncul lebih dari sekali dengan nilai yang sama atau berbeda sebagai bagian dari
permintaan HTTP yang dikirim oleh aplikasi klien ke Apigee Edge.
Pastikan permintaan HTTP yang dikirim oleh aplikasi klien
ke Apigee Edge selalu berisi nama header yang valid sesuai dengan
RFC 7230, bagian 3.2: Header Fields.
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 Edge 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 Edge berisi karakter yang tidak valid seperti
sama dengan (=), koma (,), titik koma (;), tab, CRLF, dan karakter Baris Baru.
Pastikan permintaan HTTP yang dikirim oleh aplikasi klien ke Apigee Edge tidak
berisi karakter yang tidak valid dalam nama header sesuai dengan
RFC 7230, bagian 3.2.6: Komponen Nilai Kolom
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 Edge berisi karakter yang tidak diizinkan sesuai dengan spesifikasi
RFC 3986, bagian 3.3: Path.
Pastikan bahwa jalur di URL permintaan HTTP yang dikirim oleh aplikasi
klien ke
Apigee Edge tidak berisi karakter yang tidak diizinkan sebagai
per RFC 3986, bagian 3.3: Path.
protocol.http.MessageReadError
Kode status HTTP:
502 Bad Gateway
Pesan error:
Unexpected I/O after message headers have been read.
Kemungkinan penyebab:
Error langka ini terjadi saat MP
menerima I/O di saluran saat tidak mengharapkannya. MP sedang membaca permintaan, telah membaca semua header, dan disetel untuk membaca payload permintaan. Kemudian, peristiwa I/O
yang tampaknya untuk header yang sama akan terjadi.
Perbaiki
Temukan pesan log untuk mengetahui informasi selengkapnya tentang apa yang terjadi.
logger.atSevere().log(
"Unexpected I/O after message headers have been read. Channel diagnostics=%s."
+ " HeartBeat=%s",
input.client().getDiagnostic(), message.getHeaders().isHeartBeat());
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 Edge lebih besar dari batas yang diizinkan di Apigee Edge.
Ukuran total semua header permintaan yang dikirim oleh aplikasi klien sebagai bagian dari permintaan HTTP ke Apigee Edge lebih besar daripada batas yang diizinkan di Apigee Edge.
Error ini terjadi jika ukuran baris permintaan yang dikirim oleh aplikasi klien
sebagai bagian dari permintaan HTTP ke Apigee Edge lebih besar daripada batas yang diizinkan di
Apigee Edge.
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 Edge.
Error ini terjadi jika URL permintaan server backend, yang diwakili oleh
variabel alur target.url, berisi jalur yang dimulai dengan tanda tanya
(?) dan bukan garis miring (/), yang tidak valid.
Error ini terjadi jika header HTTP tertentu yang tidak diizinkan memiliki duplikat
di Apigee Edge, muncul lebih dari sekali dengan nilai yang sama atau berbeda sebagai bagian dari
respons HTTP yang dikirim oleh server backend ke Apigee Edge.
Pastikan respons HTTP yang dikirim oleh server backend ke Apigee Edge selalu berisi nama header yang valid sesuai dengan
RFC 7230, bagian 3.2: Header Fields.
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 Baris Baru.
Pastikan respons HTTP server backend yang dikirim ke Apigee Edge tidak berisi karakter yang tidak valid dalam nama header sesuai dengan
RFC 7230, bagian 3.2.6: Komponen Nilai Kolom
protocol.http.ProxyTunnelCreationFailed
Kode status HTTP:
503 Service Unavailable
Pesan error:
Proxy refused to create tunnel with response status {status code}
Kemungkinan penyebab:
Error ini terjadi selama pembuatan tunnel antara Apigee Edge 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 tingkat tinggi dari masalah tersebut.
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 Edge.
Kode status 306 ditentukan dalam versi spesifikasi HTTP sebelumnya. Sesuai dengan spesifikasi HTTP saat ini, kode ini dicadangkan dan tidak boleh digunakan.
Error ini terjadi jika respons HTTP dari server backend ke Apigee Edge 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 Edge lebih besar dari batas yang diizinkan di Apigee Edge.
Error ini terjadi jika total ukuran semua header respons yang dikirim oleh
server backend sebagai bagian dari respons HTTP ke Apigee Edge lebih besar daripada
batas yang diizinkan di Apigee Edge.
Error ini terjadi jika ukuran baris respons yang dikirim oleh server backend sebagai
bagian dari respons HTTP ke Apigee Edge lebih besar daripada 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 Edge.
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, maka
pastikan Truststore berisi sertifikat valid server backend.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-07 UTC."],[],[]]