Halaman ini diterjemahkan oleh Cloud Translation API.

Error Server Internal 500 - EmptyPath

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

Gejala

Aplikasi klien mendapatkan kode status HTTP 500 Internal Server Error dengan kode error protocol.http.EmptyPath sebagai respons untuk panggilan API.

Pesan error

Aplikasi klien mendapatkan kode respons berikut:

HTTP/1.1 500 Internal Server Error

Selain itu, Anda mungkin melihat pesan error berikut:

{
   "fault":{
      "faultstring":"Request path cannot be empty",
      "detail":{
         "errorcode":"protocol.http.EmptyPath"
      }
   }
}

Kemungkinan penyebab

Error ini terjadi jika URL permintaan server backend, diwakili oleh variabel alur target.url, berisi jalur kosong.

Sesuai dengan spesifikasi RFC 3986, bagian 3: Komponen Sintaksis dan RFC 3986, bagian 3.3: Jalur:

Sintaksis URI memiliki komponen berikut:

        foo://example.com:8042/over/there?name=ferret#nose
        \_/   \______________/\_________/ \_________/ \__/
         |            |            |            |       |
      scheme      authority       path        query   fragment

Komponen path wajib dan HARUS selalu memiliki garis miring ke depan (/), meskipun tidak ada karakter lain sebagai bagian dari jalur.

Oleh karena itu, jika URL permintaan server backend tidak memiliki path sama sekali, yaitu tidak memiliki garis miring ke depan (/), kemudian Apigee Edge merespons dengan 500 Internal Server Error dan kode error protocol.http.EmptyPath.

Misalnya: Jika target.url memiliki nilai https://www.mocktarget.apigee.net, error ini akan terjadi sebagai path komponen kosong atau tidak ada.

Penyebab	Deskripsi	Petunjuk pemecahan masalah berlaku untuk
URL server backend (target.url) memiliki jalur kosong	URL server Backend yang diwakili oleh variabel alur `target.url` memiliki jalur kosong.	Pengguna Edge Public dan Private Cloud

Langkah-langkah diagnosis umum

Gunakan salah satu alat/teknik berikut untuk mendiagnosis error ini:

Pemantauan API

Prosedur #1: Menggunakan Pemantauan API

Untuk mendiagnosis error menggunakan Pemantauan API:

Login ke UI Apigee Edge sebagai pengguna dengan peran yang sesuai.
Beralihlah ke organisasi tempat Anda ingin menyelidiki masalah tersebut.
Buka Analyze > Pemantauan API > Investigasi.
Pilih jangka waktu tertentu saat Anda melihat error.
Gambarkan Kode Kesalahan terhadap Waktu.

Catatan: Anda juga dapat memetakan Kode Status terhadap Waktu.
Pilih sel yang memiliki kode kesalahan protocol.http.EmptyPath seperti yang ditunjukkan di bawah:
Informasi tentang kode kesalahan protocol.http.EmptyPath ditampilkan sebagai yang ditampilkan di bawah ini:
Klik Lihat log untuk meluaskan baris permintaan yang gagal.
Dari jendela Logs, perhatikan detail berikut:
- Kode Status: 500
- Sumber Kesalahan: target
- Kode Kesalahan: protocol.http.EmptyPath
Jika Sumber Kesalahan adalah target dan Kode Kesalahan adalah protocol.http.EmptyPath, hal ini menunjukkan bahwa URL server backend memiliki jalur kosong.

Trace

Prosedur #2: Menggunakan alat Rekaman Aktivitas

Untuk mendiagnosis error menggunakan alat Trace:

Aktifkan sesi rekaman aktivitas dan
- Tunggu hingga error 500 Internal Server Error terjadi, atau
- Jika Anda dapat mereproduksi masalah, lakukan panggilan API untuk mereproduksi masalah 500 Internal Server Error
Pastikan Tampilkan semua FlowInfos diaktifkan:
Pilih salah satu permintaan yang gagal dan periksa rekaman aktivitasnya.
Menavigasi melalui berbagai fase pelacakan dan menemukan tempat terjadinya kegagalan.
Anda akan menemukan error ini biasanya dalam alur setelah Alur Permintaan Target Dimulai seperti yang ditunjukkan di bawah ini:
Perhatikan nilai error dari trace.

error: Jalur permintaan tidak boleh kosong

Karena error dimunculkan oleh Apigee Edge setelah fase Alur Permintaan Target Dimulai, hal ini menunjukkan bahwa path di URL server backend kosong. Ini akan kemungkinan besar terjadi jika variabel alur target.url (yang mewakili URL untuk server backend ) mungkin telah diperbarui dengan jalur kosong melalui salah satu kebijakan di alur permintaan.
Periksa bagian Variabel Dibaca dan Ditetapkan di setiap alur mundur dari error pada fase Alur Permintaan Target Dimulai.
Tentukan kebijakan tempat variabel alur target.url diperbarui.

Contoh rekaman aktivitas yang menunjukkan kebijakan JavaScript memperbarui variabel alur target.url:

Dalam contoh trace yang ditampilkan di atas, perhatikan nilai variabel variabel flow target.url diperbarui dalam kebijakan JavaScript bernama SetTargetURL sebagai berikut ini:
```
target.url : https://mocktarget.apigee.net
```
Perhatikan bahwa target.url memiliki komponen berikut:
- skema: https://mocktarget.apigee.net
- path: kosong
Oleh karena itu, Anda akan mendapatkan error Request path cannot be empty.
Buka Fase AX (Data Analytics Direkam) di rekaman aktivitas, lalu klik Fase tersebut.
Scroll ke bawah ke bagian Detail Fase - Header Error, lalu tentukan X-Apigee-fault-code dan X-Apigee-fault-source seperti yang ditunjukkan di bawah ini:
Anda akan melihat nilai X-Apigee-fault-code dan X-Apigee-fault-source sebagai protocol.http.EmptyPath dan target , yang menunjukkan bahwa error ini terjadi karena URL server backend memiliki jalur yang kosong.

Header Respons Nilai

X-Apigee-fault-code protocol.http.EmptyPath

X-Apigee-fault-source target

Header Respons	Nilai
X-Apigee-fault-code	`protocol.http.EmptyPath`
X-Apigee-fault-source	`target`

NGINX

Prosedur #3: Menggunakan Log Akses NGINX

Untuk mendiagnosis error menggunakan log akses NGINX:

Jika Anda adalah pengguna Private Cloud, Anda dapat menggunakan log akses NGINX untuk menentukan informasi penting tentang HTTP 500 Internal Server Error.
Periksa log akses NGINX:

/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

Catatan: Ganti ORG, ENV, dan PORT# dengan nilai sebenarnya.
Telusuri apakah ada 500 error dengan kode error protocol.http.EmptyPath selama durasi tertentu (jika masalah terjadi di sudah lewat) atau jika ada permintaan yang masih gagal dengan 500.
Jika Anda menemukan error 500 dengan pencocokan X-Apigee-fault-code nilai protocol.http.EmptyPath, lalu tentukan nilai atribut X-Apigee-fault-source.

Contoh error 500 dari log akses NGINX:

Contoh entri di atas dari log akses NGINX memiliki nilai berikut untuk X- Apigee-fault-code dan X-Apigee-fault-source:

Header Nilai

X-Apigee-fault-code protocol.http.EmptyPath

X-Apigee-fault-source target

Perhatikan bahwa nilai X-Apigee-fault-code dan X-Apigee-fault-source adalah protocol.http.EmptyPath dan target , yang menunjukkan bahwa error ini terjadi karena URL server backend memiliki jalur kosong.

Header	Nilai
X-Apigee-fault-code	`protocol.http.EmptyPath`
X-Apigee-fault-source	`target`

Penyebab: URL server backend (target.url) memiliki jalur yang kosong

Diagnosis

Tentukan Fault Code dan Fault Source untuk 500 Internal Server Error menggunakan Pemantauan API, Trace Tool, atau log akses NGINX seperti yang dijelaskan dalam Langkah-langkah diagnosis umum.
Jika Kode Kesalahan adalah protocol.http.EmptyPath dan Sumber Kesalahan memiliki nilai target, ini menunjukkan bahwa URL server backend memiliki kolom kosong jalur.
URL server backend direpresentasikan oleh variabel alur target.url di Apigee Edge. Error ini biasanya terjadi jika Anda mencoba memperbarui URL server backend, yaitu, target.url secara dinamis menggunakan salah satu kebijakan (dalam Alur proxy/bersama) di alur permintaan Target, sehingga memiliki jalur kosong.

Catatan: Apigee Edge mengharapkan path di URL server backend menjadi tidak kosong, itu adalah jalur yang setidaknya harus memiliki garis miring (/), sesuai spesifikasi URL RFC 3986, bagian 3: Komponen Sintaksis.
Tentukan apakah variabel flow target.url memang memiliki jalur kosong dan sumber untuk nilainya menggunakan salah satu langkah berikut:
Trace

Menggunakan alat Trace

Jika Anda telah merekam aktivitas error ini, gunakan langkah-langkah seperti yang dijelaskan di Menggunakan Alat Rekaman Aktivitas dan:
1. Verifikasi apakah target.url memiliki jalur kosong.
2. Jika ya, cari tahu kebijakan mana yang mengubah atau memperbarui nilai target.url untuk memuat jalur kosong.
  
  Contoh rekaman aktivitas yang menunjukkan kebijakan JavaScript memperbarui variabel alur target.url:
3. Dalam contoh rekaman aktivitas di atas, perhatikan bahwa kebijakan JavaScript telah mengubah atau memperbarui nilai target.url agar berisi jalur kosong.
4. Perhatikan bahwa target.url memiliki komponen berikut:
  - skema: https://mocktarget.apigee.net
  - path: kosong
Log

Menggunakan log di server log Anda
1. Jika tidak ada trace untuk error ini (masalah yang terputus-putus), periksa ke melihat apakah Anda telah mencatat informasi tentang nilai variabel alur ke dalam log target.url, menggunakan kebijakan seperti MessageLogging atau ServiceKeterangan ke server log Anda.
2. Jika Anda memiliki log tersebut, tinjau log tersebut dan:
  1. Verifikasi apakah target.url memiliki jalur kosong, dan
  2. Lihat apakah Anda dapat menentukan kebijakan mana yang mengubah target.url untuk memuat jalur kosong
Proxy API

Meninjau proxy API yang gagal

Jika Anda tidak memiliki trace atau log untuk error ini, tinjau API yang gagal proxy untuk menentukan apa yang mengubah atau memperbarui variabel alur target.url berisi jalur yang tidak valid. Periksa hal-hal berikut:
- Kebijakan dalam proxy API
- Setiap alur bersama yang dipanggil dari proxy
Periksa kebijakan tertentu (misalnya, TetapkanMessage atau JavaScript) yang mengubah atau memperbarui variabel alur target.url dengan cermat dan menentukan penyebab pembaruan target.url untuk memiliki jalur kosong.

Berikut beberapa contoh kebijakan yang memperbarui variabel alur target.url salah memuat jalur kosong yang mengarah ke {i>error<i} ini.
Contoh #1

Contoh #1: Kebijakan JavaScript memperbarui variabel target.url
```
var url = "https://mocktarget.apigee.net"
context.setVariable("target.url", url);
```
Dalam contoh di atas, perhatikan bahwa variabel alur target.url diperbarui dengan nilai https://mocktarget.apigee.net yang terdapat dalam variabel lain url.

Perhatikan bahwa target.url memiliki komponen berikut:
- skema: https://mocktarget.apigee.net
- path: kosong
Karena jalur ini kosong, Apigee Edge menampilkan 500 Internal Server Error dengan kode error protocol.http.EmptyPath.
Contoh #2

Contoh #2: Kebijakan JavaScript memperbarui variabel target.url
```
var path = context.getVariable("request.header.Path");
var url = "https://mocktarget.apigee.net" + path
context.setVariable("target.url", url);
```
Dalam contoh di atas, perhatikan bahwa variabel alur target.url diperbarui oleh menggabungkan nilai https://mocktarget.apigee.net yang terdapat dalam variabel url dan nilai variabel lain path, yang nilai diambil dari request.header.Path.

Jika memiliki akses ke permintaan atau trace yang sebenarnya, Anda dapat memverifikasi nilai sebenarnya diteruskan ke request.header.Path.

Contoh Permintaan yang dibuat pengguna:
```
curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token>
```
Dalam contoh ini, jalur header tidak dikirim sebagai bagian dari permintaan. Oleh karena itu, nilai jalur variabel dalam kebijakan JavaScript adalah null.

Jadi:
- url = https://mocktarget.apigee.net + path
- url = https://mocktarget.apigee.net + null
- target.url = https://mocktarget.apigee.netnull
Perhatikan bahwa target.url memiliki komponen berikut:
- skema: https://mocktarget.apigee.netnull
- path: kosong
Contoh #3

Contoh #3: Kebijakan MenetapkanMessage memperbarui variabel target.url melalui variabel lainnya
```
<AssignMessage async="false" continueOnError="false" enabled="true" name=">AM-SetTargetURL">
    <DisplayName>AM-SetTargetURL</DisplayName>
    <AssignVariable>
         <Name>target.url</Name>
         <Value>https://mocktarget.apigee.net</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
```
Perhatikan bahwa target.url memiliki komponen berikut:
- skema: https://mocktarget.apigee.net
- path: kosong
Dalam semua contoh di atas, jalur di URL server backend, yaitu target.url kosong, sehingga Apigee Edge menampilkan 500 Internal Server Error dengan kode error protocol.http.EmptyPath.

Resolusi

Sesuai dengan spesifikasi RFC 3986, bagian 2: Komponen Sintaksis, komponen path wajib dan HARUS selalu memiliki garis miring (/), meskipun tidak karakter lain sebagai bagian dari path. Lakukan langkah-langkah berikut untuk memperbaiki masalah ini:

Pastikan URL server backend, yang diwakili oleh variabel alur target.url selalu memiliki jalur yang tidak kosong.
1. Dalam beberapa kasus, Anda mungkin tidak memiliki nama resource di jalur, lalu pastikan jalur tersebut setidaknya memiliki garis miring (/).
2. Jika Anda menggunakan variabel lain untuk menentukan nilai variabel alur target.url, lalu pastikan bahwa variabel lain tidak memiliki jalur kosong.
3. Jika Anda melakukan operasi string apa pun untuk menentukan nilai variabel flow target.url, lalu pastikan bahwa hasil atau hasil string tidak memiliki jalur kosong.
Dalam contoh yang dibahas di bagian Diagnosis, Anda dapat memperbaiki masalah ini sebagai dijelaskan di bawah ini:
Contoh #1

Contoh #1: Kebijakan JavaScript memperbarui variabel target.url

Tambahkan garis miring (/) ke variabel url untuk memperbaiki masalah ini seperti yang ditunjukkan di bawah ini:
```
var url = "https://mocktarget.apigee.net/"
context.setVariable("target.url", url);
```
Contoh #2

Contoh #2: Kebijakan JavaScript memperbarui variabel target.url
```
var path = context.getVariable("request.header.Path");
var url = "https://mocktarget.apigee.net" + path
context.setVariable("target.url", url);
```
Pastikan Anda meneruskan jalur yang valid, misalnya, /iloveapis sebagai bagian dari header permintaan Path untuk memperbaiki masalah ini seperti yang ditunjukkan di bawah:

Contoh permintaan:
```
curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /iloveapis"
```
Contoh #3

Contoh #3: Kebijakan MenetapkanMessage memperbarui variabel target.url melalui variabel lainnya

Tambahkan jalur yang valid di elemen <Value> kebijakan MenetapkanMessage. Sebagai misalnya, Anda dapat menggunakan /json sebagai jalur untuk MockTarget API. Artinya, ubah elemen <Value> untuk https://mocktarget.apigee.net/json seperti yang ditunjukkan di bawah ini:
```
<AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
    <DisplayName>AM-SetTargetURL</DisplayName>
    <AssignVariable>
         <Name>target.url</Name>
         <Value>https://mocktarget.apigee.net/json</Value>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
```

Spesifikasi

Apigee Edge mengharapkan bahwa URL server backend tidak memiliki jalur kosong sesuai spesifikasi berikut:

Spesifikasi
RFC 3986, bagian 3: Komponen Sintaksis
RFC 3986, bagian 3.3: Jalur

Jika Anda masih memerlukan bantuan dari Dukungan Apigee, buka Harus mengumpulkan informasi diagnostik.

Harus mengumpulkan informasi diagnostik

Jika masalah berlanjut bahkan setelah mengikuti instruksi di atas, kumpulkan informasi diagnostik, lalu hubungi Dukungan Apigee Edge.

Jika Anda adalah pengguna Cloud Publik, berikan informasi berikut:

Nama organisasi
Nama lingkungan
Nama Proxy API
Menyelesaikan perintah curl yang digunakan untuk mereproduksi 500 Internal Server Error dengan kode error protocol.http.EmptyPath
File rekaman aktivitas untuk permintaan API

Jika Anda adalah pengguna Private Cloud, berikan informasi berikut:

Pesan error lengkap yang diamati untuk permintaan yang gagal
Nama lingkungan
Paket proxy API
File rekaman aktivitas untuk permintaan API
Log akses NGINX:

/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

Di mana: ORG, ENV, dan PORT# diganti dengan nilai aktual.
Log sistem Pemroses Pesan /opt/apigee/var/log/edge-message- processor/logs/system.log

Referensi

Variabel Alur - target

Error Server Internal 500 - EmptyPath

Gejala

Pesan error

Kemungkinan penyebab

Langkah-langkah diagnosis umum

Pemantauan API

Trace

NGINX

Penyebab: URL server backend (target.url) memiliki jalur yang kosong

Diagnosis

Trace

Log

Proxy API

Contoh #1

Contoh #2

Contoh #3

Resolusi

Contoh #1

Contoh #2

Contoh #3

Spesifikasi

Harus mengumpulkan informasi diagnostik

Referensi