500 सर्वर में गड़बड़ी - बैडपाथ

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

समस्या का ब्यौरा

क्लाइंट ऐप्लिकेशन को 500 Internal Server Error का एचटीटीपी स्टेटस कोड मिलता है: एपीआई कॉल के रिस्पॉन्स के तौर पर गड़बड़ी कोड protocol.http.BadPath.

गड़बड़ी का मैसेज

क्लाइंट ऐप्लिकेशन को यह रिस्पॉन्स कोड मिलता है:

HTTP/1.1 500 Internal Server Error

इसके अलावा, आपको गड़बड़ी का यह मैसेज भी दिख सकता है:

{
   "fault":{
      "faultstring":"Invalid request path",
      "detail":{
         "errorcode":"protocol.http.BadPath"
      }
   }
}

संभावित कारण

यह गड़बड़ी तब होती है, जब बैकएंड सर्वर का अनुरोध यूआरएल, फ़्लो वैरिएबल से दिखाया जाता है target.url, ऐसा path है जो इसके बजाय प्रश्नवाचक चिह्न (?) से शुरू होता है एक फ़ॉरवर्ड स्लैश (/) है, जो अमान्य है.

निर्देशों के मुताबिक आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ:

1. यूआरआई सिंटैक्स में ये कॉम्पोनेंट होते हैं:

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

2. path घटक ज़रूरी है और इसे इससे शुरू होना चाहिए और हमेशा फ़ॉरवर्ड स्लैश (/) होता है.

इसलिए, अगर बैकएंड सर्वर के अनुरोध वाले यूआरएल में path कॉम्पोनेंट शुरू होता है, तो फ़ॉरवर्ड स्लैश (/) के बजाय, सवाल का निशान (?) लगाएं. इसके बाद, Apigee Edge, 500 Internal Server Error और गड़बड़ी कोड के साथ जवाब देता है protocol.http.BadPath.

उदाहरण के लिए: अगर target.url की वैल्यू https://www.mocktarget.apigee.net?json है, तो यह गड़बड़ी इस तरह दिखती है path अमान्य है,क्योंकि इसकी शुरुआत सवाल के निशान से होती है फ़ॉरवर्ड स्लैश (/) के बजाय, (?) का इस्तेमाल करें.

गड़बड़ी की जांच करने के सामान्य तरीके

इस गड़बड़ी का पता लगाने के लिए, इनमें से किसी एक टूल/तकनीक का इस्तेमाल करें:

वजह: बैकएंड सर्वर यूआरएल (target.url) में अमान्य पाथ है

संक्रमण की जांच

1. यहां बताए गए तरीके से, एपीआई मॉनिटरिंग, ट्रेस टूल या NGINX ऐक्सेस लॉग का इस्तेमाल करके, 500 Internal Server Error के लिए गलत कोड और गलत सोर्स का पता लगाएं डाइग्नोस्टिक्स के सामान्य तरीके.
2. अगर गलत कोड protocol.http.BadPath है और गलत सोर्स में वैल्यू target है, तो इससे पता चलता है कि बैकएंड सर्वर के यूआरएल में अमान्य है पाथ.

3. बैकएंड सर्वर का यूआरएल, Apigee में मौजूद फ़्लो वैरिएबल target.url से दिखाया जाता है किनारे. आम तौर पर यह गड़बड़ी तब होती है, जब बैकएंड सर्वर का यूआरएल अपडेट करने की कोशिश की जाती है (target.url) डाइनैमिक तौर पर किसी भी नीति का इस्तेमाल करके (इनमें प्रॉक्सी/शेयर किया गया फ़्लो) को इस तरह से सेट करें कि उसका अमान्य पाथ हो.

4. पता लगाएं कि फ़्लो वैरिएबल target.url में वाकई अमान्य है या नहीं इनमें से किसी एक तरीके का इस्तेमाल करके, path और इसके मान का स्रोत:

   ट्रेस

   ट्रेस टूल का इस्तेमाल करना

   अगर आपने इस गड़बड़ी के लिए कोई ट्रेस कैप्चर किया है, तो यहां बताए गए तरीके का इस्तेमाल करें ट्रेस टूल का इस्तेमाल करना और

   1. पक्का करें कि target.url का पाथ अमान्य हो. जैसे, यह शुरू होता है फ़ॉरवर्ड स्लैश (/) के बजाय, सवाल का निशान (?) लगा सकता है.

   2. अगर हां, तो उस नीति का पता लगाएं जिसने अमान्य पाथ शामिल करने के लिए target.url.

      JavaScript नीति दिखाने वाले सैंपल ट्रेस ने फ़्लो वैरिएबल को अपडेट कर दिया target.url

      
   3. ऊपर दिए गए सैंपल ट्रेस में देखें कि JavaScript नीति ने target.url की वैल्यू में बदलाव किया है या उसे अपडेट किया है, ताकि वह अमान्य पाथ शामिल कर सके.
   4. ध्यान दें कि target.url में ये कॉम्पोनेंट मौजूद हैं:
      • स्कीम: https
      • सर्टिफ़िकेट देने वाली संस्था या निकाय: mocktarget.apigee.net
      • पाथ: ?json

      पाथ, फ़ॉरवर्ड करने के बजाय सवाल के निशान (?) से शुरू होता है स्लैश (/), इसलिए, यह अमान्य है.

   लॉग

   अपने लॉग सर्वर में लॉग इस्तेमाल करना

   1. अगर आपको इस गड़बड़ी (बार-बार होने वाली समस्या) के लिए कोई ट्रेस नहीं मिलता है, तो देखें कि क्या आपने फ़्लो वैरिएबल की वैल्यू के बारे में जानकारी लॉग की है target.url की नीतियों का इस्तेमाल किया जा रहा है MessageLogging या अपने लॉग सर्वर पर सेवा कॉलआउट की नीति सेट करें.
   2. अगर आपके पास लॉग हैं, तो उनकी समीक्षा करें और
      1. पुष्टि करें कि target.url का पाथ अमान्य है या नहीं, और
      2. देखें कि क्या आप बदलाव वाली नीति के बारे में जानकारी हासिल कर सकते हैं अमान्य पाथ शामिल करने के लिए target.url

   एपीआई प्रॉक्सी

   काम न करने वाले एपीआई प्रॉक्सी की समीक्षा करना

   अगर आपके पास इस गड़बड़ी के लिए कोई ट्रेस या लॉग नहीं हैं, तो काम न करने वाले एपीआई की समीक्षा करें प्रॉक्सी के ज़रिए यह पता लगाया जा सकता है कि फ़्लो वैरिएबल target.url में कौनसे बदलाव किए गए या कौनसे अपडेट हुए ताकि अमान्य पाथ शामिल न हो. इनकी जांच करें:

   • एपीआई प्रॉक्सी में मौजूद नीति
   • प्रॉक्सी सर्वर से शुरू किया गया कोई भी शेयर किया गया फ़्लो

5. नीति में बदलाव करने वाली उस नीति को ध्यान से पढ़ें (उदाहरण के लिए: assignMessage या JavaScript) फ़्लो वैरिएबल target.url को अपडेट करता है और इसकी वजह तय करता है target.url को अमान्य पाथ के लिए अपडेट किया जा रहा है.

   फ़्लो वैरिएबल target.url को अपडेट करने वाली नीतियों के कुछ उदाहरण यहां दिए गए हैं .

   सैंपल #1

   सैंपल #1: target.url वैरिएबल को अपडेट करने वाली JavaScript नीति

   var url = "https://mocktarget.apigee.net?json"
   context.setVariable("target.url", url);

   ऊपर दिए गए नमूने में, ध्यान दें कि फ़्लो वैरिएबल target.url को अपडेट किया गया है किसी दूसरी वैल्यू में https://mocktarget.apigee.net?json मौजूद है वैरिएबल url.

   ध्यान दें कि url की वैल्यू में ये कॉम्पोनेंट होते हैं:

   • स्कीम: https
   • सर्टिफ़िकेट देने वाली संस्था या निकाय: mocktarget.apigee.net
   • पाथ: ?json

   पाथ, फ़ॉरवर्ड स्लैश के बजाय सवाल के निशान (?) से शुरू होता है (/), जो अमान्य है. इसलिए, Apigee Edge protocol.http.BadPath गड़बड़ी कोड के साथ 500 Internal Server Error.

   सैंपल #2

   सैंपल #2: target.url वैरिएबल को अपडेट करने वाली JavaScript नीति उसके हेडर में मौजूद वैल्यू के आधार पर

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   ऊपर दिए गए नमूने में, ध्यान दें कि फ़्लो वैरिएबल target.url को अपडेट किया गया है इसमें मौजूद मान https://mocktarget.apigee.net को जोड़कर, वैरिएबल url और किसी अन्य वैरिएबल path की वैल्यू, जिसका मान request.header.Path. से लिया गया है

   अगर आपके पास असल अनुरोध या ट्रेस का ऐक्सेस है, तो असल वैल्यू की पुष्टि की जा सकती है request.header.Path को पास किया गया.

   उपयोगकर्ता के किए गए अनुरोध का सैंपल

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: ?user"
   

   इस उदाहरण में, हेडर पाथ को अनुरोध के हिस्से के तौर पर नहीं भेजा गया है. इसलिए, मान JavaScript नीति में वैरिएबल path का प्रतिशत null है.

   इसलिए:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + "?user"
   • target.url = https://mocktarget.apigee.net?user

   ध्यान दें कि target.url की वैल्यू में ये कॉम्पोनेंट होते हैं:

   • स्कीम: https
   • सर्टिफ़िकेट देने वाली संस्था या निकाय: mocktarget.apigee.net
   • पाथ: ?user

   पाथ, फ़ॉरवर्ड स्लैश के बजाय सवाल के निशान (?) से शुरू होता है (/), जो अमान्य है. इस वजह से, Apigee Edge, गड़बड़ी के कोड protocol.http.BadPath के साथ 500 Internal Server Error दिखाता है.

   सैंपल #3

   सैंपल #3: assignMessage नीति target.url वैरिएबल को अपडेट करना

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net?echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   ध्यान दें कि url की वैल्यू में ये कॉम्पोनेंट शामिल होते हैं:

   • स्कीम: https
   • सर्टिफ़िकेट देने वाली संस्था या निकाय: mocktarget.apigee.net
   • पाथ: ?echo

   इस उदाहरण में फिर से, पाथ एक सवाल के निशान (?) से शुरू होता है के बजाय, फ़ॉरवर्ड स्लैश (/) का इस्तेमाल करें. यह अमान्य है. इसलिए, Apigee Edge, गड़बड़ी के कोड के साथ 500 Internal Server Error दिखाता है protocol.http.BadPath.

रिज़ॉल्यूशन

यूआरएल की खास बातों के मुताबिक आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट, path कॉम्पोनेंट ज़रूरी है और यह हमेशा "/" से शुरू होना चाहिए. इसलिए इस समस्या को ठीक करने के लिए नीचे दिए गए तरीके अपनाएं:

1. पक्का करें कि बैकएंड सर्वर यूआरएल, फ़्लो वैरिएबल से दिखाया जाता है target.url का हमेशा एक मान्य पाथ होता है और यह हमेशा फ़ॉरवर्ड स्लैश (/).
   1. कुछ मामलों में, हो सकता है कि आपके पाथ में संसाधन का नाम न हो. इसके बाद, पक्का करें कि पथ में कम से कम एक फ़ॉरवर्ड स्लैश (/) है.
   2. अगर फ़्लो वैरिएबल की वैल्यू तय करने के लिए, किसी अन्य वैरिएबल का इस्तेमाल किया जाता है target.url. इसके बाद, पक्का करें कि दूसरे वैरिएबल में अमान्य पाथ.
   3. अगर फ़्लो वैरिएबल की वैल्यू पता करने के लिए, स्ट्रिंग में कोई कार्रवाई की जाती है target.url, इसके बाद पक्का करें कि स्ट्रिंग का नतीजा या नतीजा हो कार्रवाइयों का अमान्य पाथ नहीं होता है.

2. ऊपर बताए गए सैंपल में, नीचे बताए गए तरीके से इस समस्या को ठीक किया जा सकता है:

   सैंपल #1

   सैंपल #1: target.url वैरिएबल को अपडेट करने वाली JavaScript नीति

   URL में प्रश्नवाचक चिह्न (?) के बजाय फ़ॉरवर्ड स्लैश (/) का उपयोग करें इस समस्या को ठीक करने के लिए, वैरिएबल url को नीचे दिखाया गया है:

   var url = "https://mocktarget.apigee.net/json"
   context.setVariable("target.url", url);

   सैंपल #2

   सैंपल #2: target.url वैरिएबल को अपडेट करने वाली JavaScript नीति उसके हेडर में मौजूद वैल्यू के आधार पर

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   पक्का करें कि आपने मान्य पाथ पास किया हो. उदाहरण के लिए: अनुरोध के तौर पर /user इस समस्या को ठीक करने के लिए, Path हेडर का इस्तेमाल करें. जैसे:

   अनुरोध का सैंपल:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /user"
   

   सैंपल #3

   सैंपल #3: target.url वैरिएबल को लागू करने के लिए,assignMessage नीति को अपडेट करना

   ConsentMessage नीति के <Value> एलिमेंट में मान्य पाथ जोड़ें. इसका मतलब है कि सवाल के निशान (?) को से बदलें <Value> एलिमेंट में फ़ॉरवर्ड स्लैश (/) और इस समस्या को ठीक करने के लिए, इसे https://mocktarget.apigee.net/echo पर सेट करें, जैसा कि नीचे दिखाया गया है:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   खास जानकारी

   Apigee Edge, तो बैकएंड सर्वर के यूआरएल में path कॉम्पोनेंट की ज़रूरत होती है यहां दी गई शर्तों के मुताबिक, हमेशा फ़ॉरवर्ड स्लैश (/) से शुरू करना चाहिए विशेषताएं:

   खास जानकारी
   आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट
   आरएफ़सी 3986, सेक्शन 3.3: पाथ

   अगर आपको अब भी Apigee की सहायता टीम से कोई मदद चाहिए, तो इकट्ठा करना ज़रूरी है गड़बड़ी की जानकारी.

   ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़ी जानकारी इकट्ठा करना ज़रूरी है

   अगर ऊपर दिए गए निर्देशों का पालन करने के बाद भी समस्या बनी रहती है, तो यह जानकारी इकट्ठा करें और फिर Apigee Edge सहायता से संपर्क करें:

   अगर आप सार्वजनिक क्लाउड के उपयोगकर्ता हैं, तो यह जानकारी दें:

   • संगठन का नाम
   • परिवेश का नाम
   • एपीआई प्रॉक्सी का नाम
   • 500 Internal Server Error को गड़बड़ी कोड protocol.http.BadPath के साथ फिर से दिखाने के लिए इस्तेमाल किए गए curl निर्देश को पूरा करें
   • एपीआई अनुरोधों के लिए फ़ाइल ट्रेस करें

   अगर आप निजी Cloud उपयोगकर्ता हैं, तो यह जानकारी दें:

   • पूरे न हो पाने वाले अनुरोधों की वजह से, गड़बड़ी का पूरा मैसेज मिला
   • परिवेश का नाम
   • एपीआई प्रॉक्सी बंडल
   • एपीआई अनुरोधों के लिए फ़ाइल ट्रेस करें

   • 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

   रेफ़रंस

   फ़्लो वैरिएबल - टारगेट