400 Bad Request – DeדחיסתionFailureAtRequest

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

תיאור הבעיה

אפליקציית הלקוח מקבלת קוד סטטוס HTTP של 400 Bad Request עם קוד שגיאה messaging.adaptors.http.flow.DecompressionFailureAtRequest כתגובה ל-API שיחות.

הודעת שגיאה

אפליקציית הלקוח מקבלת את קוד התגובה הבא:

HTTP/1.1 400 Bad Request

בנוסף, יכול להיות שתופיע הודעת שגיאה שדומה להודעה שמוצגת בהמשך:

{
   "fault":{
      "faultstring":"Decompression failure at request",
      "detail":{
         "errorcode":"messaging.adaptors.http.flow.DecompressionFailureAtRequest"
      }
   }
}

גורמים אפשריים

השגיאה הזו מתקבלת רק אם:

• הקידוד שצוין בכותרת בקשת HTTP Content-Encoding חוקי ו- שנתמכות ב-Apigee Edge,

אבל

• פורמט המטען הייעודי (Payload) שהלקוח שולח כחלק מבקשת ה-HTTP לא להתאים לפורמט הקידוד שצוין בכותרת Content-Encoding

הסיבה לכך היא ש-Apigee Edge לא מצליחה לפענח את המטען הייעודי (payload) באמצעות הקידוד שצוין, של המטען הייעודי (Payload) אינו בפורמט זהה לזה של הקידוד שצוין הכותרת Content-Encoding.

הנה כמה דוגמאות לערכים נתמכים של Content-Encoding ולאופן השימוש ב-Apigee Edge מצפה שפורמט המטען הייעודי (Payload) יהיה במקרים האלה:

הסיבות האפשריות לשגיאה הזו הן:

שלבי אבחון נפוצים

יש להשתמש באחד מהכלים או השיטות הבאים כדי לאבחן את השגיאה:

הסיבה: פורמט המטען הייעודי (payload) של הבקשה לא תואם לקידוד שצוין בכותרת Content-Encoding

כברירת מחדל, ב-Apigee Edge תמיד מבטל את הדחיסה של המטען הייעודי (payload) אם כותרת הבקשה Content-Encoding מכיל ערך תקין של בקידוד נתמך. לכן, צפוי שהפורמט של המטען הייעודי (Payload) של הבקשה יהיה חייב להיות תואם לקידוד שצוין בכותרת הבקשה Content-Encoding. אם יש חוסר התאמה, מקבלים את השגיאה הזו.

אבחון

1. מגדירים את קוד השגיאה ואת מקור התקלה של השגיאה שזוהתה באמצעות ה-API יומני Monitoring, כלי מעקב או יומני גישה ל-NGINX, כמו שמוסבר ב שלבי האבחון הנפוצים.
2. אם קוד השגיאה הוא messaging.adaptors.http.flow.DecompressionFailureAtRequest וגם ל-Fault Source יש את הערך policy או proxy, ואז זה מציין שהבקשה שנשלחה על ידי אפליקציית הלקוח מכילה מטען ייעודי (payload) שלא תואם הקידוד הנתמך שצוין בכותרת הבקשה Content-Encoding.

3. אפשר לקבוע את חוסר ההתאמה כחלק מבקשת ה-HTTP באמצעות אחת מהאפשרויות הבאות אמצעי תשלום:

   הודעת שגיאה

   כדי לבצע אימות באמצעות הודעת השגיאה:

   1. אם יש לכם גישה להודעת השגיאה המלאה שהתקבלה מ-Apigee Edge, יש לעיין בfaultstring.

      הודעת שגיאה לדוגמה:

      "faultstring":"Decompression failure at request"

   2. בהודעת השגיאה שלמעלה, מופיע "Decompression failure at request", שמרמז על הבקשה לא ניתן לפרק באמצעות הקידוד שצוין כותרת Content-Encoding.

   Trace

   כדי לאמת באמצעות נתוני המעקב:

   1. קובעים את הערך של כותרת הבקשה Content-Encoding הנכס error.cause באמצעות Trace כפי שמוסבר בשלבי האבחון הנפוצים.

   2. הערכים מהמעקב לדוגמה הם:

      • קידוד תוכן: gzip
      • error.cause: Not in GZIP format

      הערך בכותרת הבקשה Content-Encoding הוא gzip; עם זאת, המטען הייעודי (payload) של הבקשה הוא לא בפורמט GZIP. (כפי שמצוין על ידי error.cause). לכן, Apigee Edge מגיבה 400 Bad Request וקוד השגיאה messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   הבקשה בפועל

   כדי לאמת באמצעות הבקשה עצמה:

   אם יש לכם גישה לבקשה שנשלחה בפועל על ידי הלקוח מבצעים את השלבים הבאים:

   1. קובעים את הערך שמועבר לכותרת הבקשה Content-Encoding.
   2. קובעים את הפורמט של המטען הייעודי (Payload) שנשלח כחלק מהבקשה.

   3. אם הערך של הכותרת Content-Encoding נמצא ברשימה של בקידוד נתמך אבל הפורמט של המטען הייעודי (Payload) של הבקשה לא תואם לקידוד שצוין בכותרת Content-Encoding, זאת הסיבה לבעיה.

      בקשה לדוגמה:

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

      בקשת הדוגמה שלמעלה שולחת את הערך gzip אל הכותרת Content-Encoding, בקידוד נתמך ב-Apigee Edge. עם זאת, המטען הייעודי (Payload) של הבקשה הקובץ request_payload.zip הוא בפורמט ZIP. לכן, הבקשה נכשל עם קוד הסטטוס 400 Bad Request וקוד השגיאה: messaging.adaptors.http.flow.DecompressionFailureAtRequest.

   יומני מעבד ההודעות

   כדי לאמת באמצעות יומני מעבד הודעות:

   אם אתם משתמשים ב-Private Cloud, תוכלו להשתמש ביומני עיבוד ההודעות. כדי לקבוע את המידע העיקרי לגבי שגיאות HTTP 400.

   1. קובעים את מזהה ההודעה של הבקשה שנכשלה באמצעות API Monitoring, כלי המעקב, או יומני גישה ל-NGINX, כמו שמוסבר בשלבי האבחון הנפוצים.

   2. מחפשים את מזהה ההודעה ביומן מעבד ההודעות:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   3. יופיע אחד מהחריגים הבאים:

      תרחיש מס' 1

      תרחיש מס' 1: כאשר בקשת API כוללת את הכותרת Content-Encoding: gzip

      2021-07-28 10:21:16,861  NIOThread@0 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-57-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.80.234:44284]@28469 useCount=1 bytesRead=0
      bytesWritten=28764 age=2739893ms  lastIO=0ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: Not in GZIP format
      
      2021-07-28 10:21:16,862  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rt-57-1, exception:java.util.zip.ZipException: Not in GZIP format,
      context:Context@71ea5ac input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.80.234:44284]@28469 useCount=1
      bytesRead=0 bytesWritten=28764 age=2739894ms  lastIO=0ms  isOpen=true)
      2021-07-28 10:21:16,862  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() :
      Exception java.util.zip.ZipException: Not in GZIP format occurred while writing
      to channel null
      2021-07-28 10:21:16,863  NIOThread@0 INFO  HTTP.SERVICE -
      ExceptionHandler.handleException() : Exception trace:
      java.util.zip.ZipException: Not in GZIP format
      

      השורה java.util.zip.ZipException: Not in GZIP format בהודעת השגיאה שלמעלה מציינת שהבקשה המטען הייעודי לא נשלח בפורמט GZIP, אבל Content-Encoding מוגדר כ-gzip. לכן, Apigee Edge זורקת את החריגה מחזירה קוד סטטוס 400 עם קוד שגיאה messaging.adaptors.http.flow.DecompressionFailureAtRequest לאפליקציות לקוח.

      תרחיש מס' 2

      תרחיש מס' 2: כאשר בקשת API כוללת את הכותרת Content-Encoding: deflate

      2021-07-28 15:26:31,893  NIOThread@1 ERROR HTTP.SERVER -
      HTTPServer$Context.onInputException() : Message id:rt-47875-1
      SSLClientChannel[Accepted: Remote:192.168.199.8:8443
      Local:192.168.81.72:45954]@29276 useCount=1 bytesRead=0
      bytesWritten=37230 age=3498856ms  lastIO=1ms
      isOpen=true.onExceptionRead exception: {}
      java.util.zip.ZipException: incorrect header check
                        ….
      Caused by: java.util.zip.DataFormatException: incorrect header check
             ..
      2021-07-28 15:26:31,894  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:POST, uri:/test,
      message Id:rrt-47875-1, exception:java.util.zip.ZipException:
      incorrect header check, context:Context@69b3ac45
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.199.8:8443 Local:192.168.81.72:45954]@29276
      useCount=1 byt	esRead=0 bytesWritten=37230 age=3498856ms
      lastIO=1ms  isOpen=true)
      

      השורות java.util.zip.ZipException: incorrect header check וגם Caused by: java.util.zip.DataFormatException: incorrect header check בהודעת השגיאה שלמעלה מציינים שהמטען הייעודי (Payload) של הבקשה לא נשלח. הוא לא תואם לקידוד שצוין הכותרת Content-Encoding של deflate. לכן, Apigee Edge זורקת את החריג ומחזירה קוד סטטוס 400 עם קוד השגיאה messaging.adaptors.http.flow.DecompressionFailureAtRequest לאפליקציות לקוח.

רזולוציה

1. אם אין צורך במטען הייעודי (payload) של הבקשה הדחוסה בתהליך ה-Proxy ל-API ב-Apigee Edge ובשרת הקצה העורפי, לא מעבירים את הכותרת Content-Encoding. אם צריך לדחוס את המטען הייעודי (payload) של הבקשה, עוברים לשלב 2.
2. צריך לוודא שאפליקציית הלקוח תמיד שולחת את הפרטים הבאים:
   • כל אחד מהתנאים הבאים קידוד נתמך כערך של הכותרת Content-Encoding בקידוד בקשה
   • המטען הייעודי (payload) של הבקשה בפורמט הנתמך ל-Apigee Edge תואם לקידוד הפורמט צוין בכותרת Content-Encoding
3. בדוגמה שלמעלה, המטען הייעודי (payload) של הבקשה הוא בפורמט ZIP, אבל כותרת הבקשה. מציין את הערך Content-Encoding: gzip. כדי לפתור את הבעיה, אפשר לשלוח את הבקשה הכותרת היא Content-Encoding: gzip והמטען הייעודי (payload) של הבקשה נמצא גם ב-gzip פורמט:

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

מפרט

התגובה של Apigee Edge עם קוד הסטטוס 400 Bad Request עם קוד השגיאה messaging.adaptors.http.flow.DecompressionFailureAtRequest בהתאם ל-RFC הבא מפרטים:

אם עדיין דרושה לך עזרה מהתמיכה של Apigee, צריך לעבור אל חובה לאסוף את פרטי האבחון.

חובה לאסוף פרטי אבחון

אוספים את פרטי האבחון הבאים ופונים לתמיכה של Apigee Edge:

אם אתם משתמשים ב-Public Cloud, עליכם לספק את הפרטים הבאים:

• שם הארגון
• שם הסביבה
• שם ה-API של ה-Proxy
• צריך להשלים את הפקודה curl ששימשה לשחזור השגיאה 400
• קובץ מעקב אחר בקשות ה-API

אם אתם משתמשים בענן פרטי, עליכם לספק את הפרטים הבאים:

• הודעת שגיאה מלאה שנצפתה בבקשות שנכשלו
• שם הסביבה
• חבילת API Proxy
• קובץ מעקב אחר בקשות ה-API

• יומני גישה ל-NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  איפה: ORG, ENV ו-PORT# מוחלפים ב: והערכים בפועל.

• יומני מערכת של מעבד ההודעות /opt/apigee/var/log/edge-message-processor/logs/system.log