414 Request-URI ארוך מדי - ToBigLine

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

תיאור הבעיה

אפליקציית הלקוח מקבלת קוד סטטוס HTTP של 414 Request-URI Too Long עם קוד שגיאה protocol.http.TooBigLine כתגובה לקריאות ל-API.

הודעת שגיאה

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

HTTP/1.1 414 Request-URI Too Long

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

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

לתשומת ליבך: ה-faultstring בהודעת השגיאה שלמעלה מכיל את המגבלה המותרת לשורת הבקשה ב-Apigee Edge, שהיא 7168 bytes (7 KB).

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

השגיאה הזו מתקבלת אם גודל שורת הבקשה שנשלחה על ידי אפליקציית הלקוח ל-Apigee Edge כחלק מבקשת HTTP גדולה מהמגבלה המותרת ב-Apigee Edge.

לפני שנבדוק את הסיבות האפשריות לשגיאה הזו, יש להבין מהי שורת הבקשה ואיך לבדוק את הגודל שלו.

הסבר על שורת הבקשה

בקשת HTTP אופיינית מורכבת משלושה חלקים:

1. שורת בקשה
2. ( קבוצה של כותרות HTTP )
3. [ גוף ]

שורת הבקשה מורכבת משלושה חלקים כפי שמוצג בהמשך.

Request-Line = <Method> <Request-URI> <HTTP-Version>

כשאפליקציית הלקוח שולחת בקשת HTTP אל שרת, השורה הראשונה שמועברת אל השרת מכיל את שורת הבקשה שמתוארת למעלה. אחריו מופיע וגוף הבקשה/מטען ייעודי (payload).

בצילום המסך לדוגמה הבא מוצגת בקשה אופיינית של curl, הבקשה החלק (יחד עם Request-Line) והחלק Response.

הסבר על הגודל של שורת הבקשה

1. בדוגמה שלמעלה, שורת start (השורה הראשונה) בבקשה, גם היא שנקרא Request-Line, הוא כך:

   GET /test/ HTTP/1.1

   הגודל של שורת הבקשה הוא ~19 bytes מפני שהיא מכילה 19 ASCII characters. מאחר שזו בתוך מותרת ב-Apigee Edge, הבקשה תעובד ללא שגיאות ומקבלים תשובה מוצלחת.

2. באופן דומה, אם מסתכלים על faultstring בשדה הודעת השגיאה שמוצגת למעלה. היא מכילה "request line size exceeding 7,168". הדבר מציין ששורת הבקשה בבקשת ה-HTTP שנשלחה על ידי הלקוח חרגה 7,168 בייטים.

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

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

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

הסיבה: גודל המטען הייעודי (payload) של הבקשה חורג מהמגבלה המותרת

אבחון

1. קובעים את Fault Code (קוד התקלה), Fault Source וגודל בקשה-אורך של שגיאה שזוהתה באמצעות יומני API Monitoring, Trace Tool או NGINX Access כמו שמוסבר ב- שלבי האבחון הנפוצים.
2. אם מקור התקלה מכיל את הערך apigee או MP, הערך הזה מציין שגודל הבקשה שנשלח על ידי אפליקציית הלקוח ל-Apigee גדול מ- המגבלה המותרת ב-Apigee Edge.
3. אפשר לוודא שגודל שורת הבקשה חרג מהמגבלה המותרת של 7 KB באמצעות אחת מהאפשרויות הבאות: אחת מהשיטות הבאות:

   הודעת שגיאה

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

   אם יש לכם גישה להודעת השגיאה המלאה שהתקבלה מ-Apigee Edge, יש לעיין בfaultstring. faultstring מציין הגודל של שורת הבקשה חורג מהמגבלה המותרת של 7KB.

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

   "faultstring":"request line size exceeding 7,168"

   הבקשה בפועל

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

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

   1. אימות גודל ה-URI שהועבר בבקשה.

   2. אם גודל ה-URI גדול מ המגבלה המותרת ב-Apigee Edge, אז היא את הגורם לבעיה.

      בקשה לדוגמה:

      curl http://<hostalias>/testtoobigline?_qparam=000000000000000000……..000000<trimmed> -k -X POST
      

      במקרה שלמעלה, הערך של פרמטר השאילתה qparam גדול מ-7KB, כלומר הוא מכיל יותר מ-7 K תווי ASCII.

      אם אתם משתמשים בלקוח אחר, אפשר לבדוק את יומני הלקוח לנסות לברר את הגודל של שורת הבקשה שנשלחת ל-Apigee Edge.

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

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

   אם אתם משתמשים בענן פרטי, אתם יכולים להשתמש ביומנים של מעבד ההודעות כדי: לאמת אם הגודל של שורת הבקשה חרג המגבלה המותרת ב-Apigee Edge.

   1. בודקים את יומני מעבד ההודעות:

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

   2. אפשר לחפש כדי לראות אם יש שגיאות 414 במהלך משך הזמן (אם הבעיה התרחשה בעבר) או אם יש בקשות כלשהן עדיין נכשל עם 414. אפשר להשתמש במחרוזות החיפוש הבאות.

      grep -ri "exceeding"
      

      grep -ri "RequestURITooLong"
      

   3. יופיעו שורות מ-system.log שדומות לאלה:

      2021-07-12 08:53:31,461  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:null, uri:null,
      message Id:null, exception:com.apigee.errors.http.user.RequestURITooLong{
      code = protocol.http.TooBigLine, message = request line size exceeding 7,168,
      associated contexts = []}, context:Context@366f4217
      input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.195.90:8443
      Local:192.168.67.23:34256]@301912 useCount=1 bytesRead=0 bytesWritten=45849
      age=2254670ms lastIO=0ms isOpen=true)

      הטקסט message = request line size exceeding 7,168 במחרוזת הודעת השגיאה שלמעלה מציינת שגודל ה-URI של הבקשה גדול מ-7KB. לכן, Apigee Edge מקפיצה את החריג com.apigee.errors.http.user.RequestURITooLong והחזרות קוד סטטוס 414 עם קוד שגיאה protocol.http.TooBigline לאפליקציות לקוח.

רזולוציה

מגבלות

Apigee מצפה שאפליקציית הלקוח ושרת הקצה העורפי לא ישלחו בקשה/תגובה שהגדלים שלהם גדולים מהמגבלה המותרת לפי תיעוד של מגבלת שורות הבקשות/התגובה. במגבלות של Apigee Edge.

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

איך בודקים את המגבלה הנוכחית?

בקטע הזה מוסבר איך לאמת שהנכס HTTPRequest.line.limit כולל עודכן בערך חדש ב'מעבדי הודעות'.

1. במעבד הודעות, מחפשים את המאפיין. HTTPRequest.line.limit ב- ספריית /opt/apigee/edge-message-processor/conf ובדיקה רואים איזה ערך הוגדר באופן הבא:

   grep -ri "HTTPRequest.line.limit" /opt/apigee/edge-message-processor/conf
   

2. התוצאה לדוגמה מהפקודה שלמעלה היא:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.line.limit=7k

3. בפלט לדוגמה שלמעלה, שימו לב שהמאפיין HTTPRequest.line.limit הוגדר עם הערך 7k ב-http.properties.

   מציינת שהמגבלה של גודל שורת הבקשה שהוגדרה ב-Apigee לפרטי גודל הענן הוא 7KB.

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

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

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

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

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

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

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

• יומני גישה ל-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