415 Nieobsługiwany typ multimediów – nieobsługiwane kodowanie

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Krótki opis problemu

Aplikacja kliencka otrzymuje kod stanu HTTP 415 Unsupported Media Type z kodu błędu protocol.http.UnsupportedEncoding w odpowiedzi na wywołania interfejsu API.

Komunikat o błędzie

Aplikacja kliencka otrzymuje ten kod odpowiedzi:

HTTP/1.1 415 Unsupported Media Type

Możesz też zobaczyć komunikat o błędzie podobny do tego poniżej:

{
   "fault":{
      "faultstring":"Unsupported Encoding \"UTF-8\"",
      "detail":{
         "errorcode":"protocol.http.UnsupportedEncoding"
      }
   }
}

Możliwe przyczyny

Ten błąd występuje, jeśli wartość nagłówka Content-Encoding określona w parametrze żądanie HTTP wysłane przez klienta do Apigee lub odpowiedź HTTP wysłana przez serwer backendu do Apigee nie zawiera kodowanie obsługiwane przez Apigee zgodnie ze specyfikacją . RFC 7231, sekcja 6.5.13: 415 Nieobsługiwany typ nośnika.

Możliwe przyczyny tego błędu są następujące:

Typowe kroki diagnostyki

Aby zdiagnozować błąd, możesz skorzystać z dowolnej z tych metod:

Przyczyna: nieobsługiwane kodowanie w żądaniu

Diagnostyka

1. Określ kod błędu i źródło błędu dla błędu zaobserwowanego za pomocą interfejsu API. Monitorowanie lub logi dostępu NGINX zgodnie z opisem w sekcji Najczęstsze czynności diagnostyczne.
2. Jeśli kod błędu to protocol.http.UnsupportedEncoding, a Błąd Źródło ma wartość apigee lub MP, co oznacza, że żądanie wysłane przez aplikację kliencką zawiera w nagłówku żądania nieobsługiwane kodowanie Content-Encoding.
3. Możesz ustalić wartość nieobsługiwanego kodowania przekazanego w żądaniu HTTP korzystając z jednej z tych metod:

   Komunikat o błędzie

   Korzystanie z komunikatu o błędzie:

   1. Jeśli masz dostęp do pełnego komunikatu o błędzie otrzymanego z Apigee Edge, zapoznaj się z artykułem do: faultstring. faultstring zawiera wartość nieobsługiwanej funkcji kodowanie.

      Przykładowy komunikat o błędzie:

      "faultstring":"Unsupported Encoding \"UTF-8\""

   2. Zwróć uwagę, że w powyższym komunikacie o błędzie wartość nieobsługiwanego kodowania to “UTF-8”: faultstring.

      To żądanie nie jest obsługiwane w Apigee Edge, ponieważ kodowanie “UTF-8” nie jest obsługiwane kończy się wystąpieniem błędu 415 Unsupported Media Type i kodem błędu: protocol.http.UnsupportedEncoding

   Rzeczywiste żądanie

   Na podstawie rzeczywistego żądania:

   1. Jeśli nie masz dostępu do rzeczywistego żądania wysłanego przez aplikację kliencką, otwórz Rozwiązanie.
   2. Jeśli masz dostęp do rzeczywistego żądania wysłanego przez aplikację kliencką, wykonaj następujące kroki:
      1. Określ wartość przekazywaną do nagłówka żądania Content-Encoding.
      2. Jeśli wartość przekazywana do nagłówka żądania Content-Encoding nie wynosi 1 wartości wymienionych w sekcji Obsługiwane kodowanie, to przyczyny tego błędu.

         Przykładowe żądanie:

         curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: UTF-8" -X POST -d @request_payload.gz

         Powyższe przykładowe żądanie wysyła wartość "UTF-8" do nagłówka Content- Encoding, który nie jest Kodowanie obsługiwane w Apigee Edge. Dlatego to żądanie kończy się niepowodzeniem i wyświetlony jest błąd 415 Unsupported Media Type z kodem błędu: protocol.http.UnsupportedEncoding

Rozdzielczość

1. Zapoznaj się z listą kodowania obsługiwanego przez Apigee w Obsługiwane kodowanie
2. Upewnij się, że aplikacja kliencka zawsze wysyła to:
   • Tylko obsługiwane kodowanie jako wartość nagłówka Content-Encoding w: prośba
   • Ładunek żądania w obsługiwanym formacie do Apigee Edge i zgodny z formatem określono w nagłówku Content-Encoding

3. W powyższym przykładzie ładunek żądania ma rozszerzenie gz, które wskazuje, że treść musi być typu gzip. Możesz rozwiązać problem, wysyłając nagłówek żądania jako Content-Encoding: gzip oraz ładunek żądania w formacie gzip:

   curl -v "https://HOSTALIAS/v1/testgzip" -H "Content-Encoding: gzip" -X POST -d @request_payload.gz
   

Przyczyna: nieobsługiwane kodowanie w odpowiedzi

Diagnostyka

1. Określ kod błędu i źródło błędu dla błędu zaobserwowanego za pomocą interfejsu API. Logi dostępu monitorowania, narzędzia śledzenia lub NGINX opisane w Najczęstsze czynności diagnostyczne.
2. Jeśli Źródło błędu ma wartość target, oznacza to, że odpowiedź wysłana przez serwer backendu zawiera nieobsługiwane kodowanie w polu Content-Encoding.
3. Możesz określić wartość nieobsługiwanego kodowania przekazanego w odpowiedzi HTTP z do serwera backendu za pomocą jednej z tych metod:

   Komunikat o błędzie

   Korzystanie z komunikatu o błędzie:

   1. Jeśli masz dostęp do pełnego komunikatu o błędzie otrzymanego z Apigee Edge, przeczytaj faultstring. faultstring zawiera wartość atrybutu nieobsługiwane kodowanie.

      Przykładowy komunikat o błędzie:

      "faultstring":"Unsupported Encoding \"UTF-8\""

   2. Zwróć uwagę, że w powyższym komunikacie o błędzie wartość nieobsługiwanego kodowania to “UTF-8”: faultstring.

      Ponieważ “UTF-8” nie jest obsługiwane w Apigee Edge, ten żądanie kończy się niepowodzeniem i jest wyświetlany błąd 415 Unsupported Media Type z kodem błędu: protocol.http.UnsupportedEncoding

   Narzędzie śledzenia

   Za pomocą logu czasu:

   1. Jeśli nie masz danych śledzenia nieudanego żądania, otwórz Rozwiązanie.
   2. Jeśli zapiszesz ślad błędu, możesz określić, który z nich kodowanie przekazywane przez serwer backendu w odpowiedzi Content-Encoding zgodnie z opisem w narzędziu Ślad.

Rozdzielczość

1. Zapoznaj się z listą kodowania obsługiwanego przez Apigee w Obsługiwane kodowanie
2. Zadbaj o to, aby serwer backendu zawsze wysyłał te dane:
   • Tylko obsługiwane kodowanie jako wartość parametru Nagłówek Content-Encoding w żądaniu
   • Ładunek odpowiedzi w obsługiwanym formacie do Apigee Edge i zgodny z formatem określono w nagłówku Content-Encoding

Obsługiwane kodowanie

W tej tabeli znajdziesz format kodowania obsługiwany przez Apigee Edge:

Specyfikacja

Apigee odpowiada odpowiedzią błędu 415 Unsupported Media Type zgodnie z zgodnie ze specyfikacją RFC:

Najważniejsze kwestie

Pamiętaj:

• Jeśli Apigee zwraca błąd 415 z powodu przekazania nieobsługiwanego kodowania nagłówek Content-Encoding jako część żądania do interfejsu API, a potem:
  • Nie będzie można przechwycić logu czasu dla takich żądań.

  • Nie będzie można zmienić formatu ani treści odpowiedzi na błąd wysłanej przez Apigee Edge przy użyciu zasad takich jak RaiseFault i AssignMessage.

  Dzieje się tak, ponieważ ten błąd występuje na wczesnych etapach procesora wiadomości przed który można wykonać.

• Jeśli Apigee zwraca błąd 415 z powodu przekazania nieobsługiwanego kodowania w nagłówku odpowiedzi serwera backendu, musi zostać naprawiony w z serwera backendu, aby uniknąć tego błędu. Współpracuj z zespołem backendu, aby: napraw ten problem.

Jeśli nadal potrzebujesz wsparcia zespołu pomocy Apigee Edge, przeczytaj artykuł Wymagane jest zbieranie informacji diagnostycznych.

Musi zbierać informacje diagnostyczne

Jeśli nadal potrzebujesz pomocy zespołu pomocy Apigee, przygotuj te informacje informacje diagnostyczne, a następnie skontaktuj się z zespołem pomocy Apigee Edge:

Jeśli jesteś użytkownikiem Public Cloud, podaj te informacje:

• Nazwa organizacji
• Nazwa środowiska
• Nazwa serwera proxy interfejsu API
• Wykonaj polecenie curl użyte do odtworzenia błędu 415
• Plik śledzenia żądań do interfejsu API

Jeśli jesteś użytkownikiem Private Cloud, podaj te informacje:

• Pełny komunikat o błędzie zaobserwowany dla nieudanych żądań
• Nazwa środowiska
• Pakiet serwera proxy interfejsu API
• Plik śledzenia żądań do interfejsu API

• Logi dostępu NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Gdzie: ORG, ENV i PORT# są zastępowane przez wartości rzeczywiste.

• Dzienniki systemowe procesora wiadomości /opt/apigee/var/log/edge-message- processor/logs/system.log