वेब पुश से जुड़ी किसी समस्या को डीबग करना या उससे जुड़ी मदद पाना मुश्किल हो सकता है. इस दस्तावेज़ में कुछ सामान्य समस्याओं के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि Chrome या Firefox में कोई गड़बड़ी मिलने पर आपको क्या करना चाहिए.
पुश डीबग करने से पहले, आपको सर्विस वर्कर को डीबग करने, फ़ाइल अपडेट न होने, रजिस्टर न होने या सामान्य तौर पर असामान्य व्यवहार से जुड़ी समस्याएं आ सकती हैं. सर्विस वर्कर को डीबग करने के बारे में एक शानदार दस्तावेज़ है. अगर आप सर्विस वर्कर डेवलपमेंट के लिए नए हैं, तो हमारा सुझाव है कि आप इसे ज़रूर देखें.
वेब पुश को डेवलप और टेस्ट करते समय, दो अलग-अलग चरणों को पूरा करना होता है. हर चरण में, कुछ सामान्य समस्याएं आ सकती हैं:
- मैसेज भेजना: पक्का करें कि मैसेज भेजा जा रहा हो.
आपको 201 एचटीटीपी कोड मिलना चाहिए. अगर आप :
- अनुमति से जुड़ी गड़बड़ियां देखें: अगर आपको अनुमति से जुड़ी गड़बड़ी का मैसेज मिलता है, तो अनुमति से जुड़ी समस्याएं सेक्शन देखें.
- एपीआई से जुड़ी अन्य गड़बड़ियां: अगर आपको 201 के अलावा कोई और स्टेटस कोड मिलता है, तो समस्या की वजह जानने के लिए एचटीटीपी स्टेटस कोड सेक्शन देखें.
- मैसेज पाना: अगर मैसेज भेजने में कोई समस्या नहीं आ रही है, लेकिन ब्राउज़र पर मैसेज नहीं मिल रहा है, तो:
- एन्क्रिप्ट करने से जुड़ी समस्याएं देखें: पेलोड को एन्क्रिप्ट करने से जुड़ी समस्या वाला सेक्शन देखें.
- कनेक्शन से जुड़ी समस्याओं की जांच करें: अगर Chrome पर समस्या आ रही है, तो हो सकता है कि यह कनेक्शन की समस्या हो. ज़्यादा जानकारी के लिए, कनेक्शन से जुड़ी समस्याएं सेक्शन देखें.
अगर आपको पुश मैसेज भेजने और पाने में समस्या आ रही है और इस दस्तावेज़ में दिए गए सेक्शन से समस्या को डीबग करने में मदद नहीं मिल रही है, तो हो सकता है कि आपको पुश मैसेज भेजने के तरीके में ही कोई गड़बड़ी मिली हो. इस मामले में, गड़बड़ी की रिपोर्ट सबमिट करना सेक्शन देखें. इससे आपको गड़बड़ी की अच्छी रिपोर्ट सबमिट करने में मदद मिलेगी. इसमें सभी ज़रूरी जानकारी शामिल करें, ताकि गड़बड़ी को ठीक करने की प्रोसेस को तेज़ किया जा सके.
शुरू करने से पहले, मैं एक बात बताना चाहूंगा कि Firefox और Mozilla AutoPush Service में गड़बड़ी के मैसेज बहुत अच्छे होते हैं. अगर आपको कोई समस्या आ रही है और आपको नहीं पता कि समस्या क्या है, तो Firefox में टेस्ट करें और देखें कि क्या आपको गड़बड़ी का कोई ज़्यादा मददगार मैसेज मिलता है.
अनुमति से जुड़ी समस्याएं
वेब पुश का इस्तेमाल शुरू करते समय, डेवलपर को अनुमति से जुड़ी समस्याएं सबसे ज़्यादा आती हैं. आम तौर पर, यह समस्या किसी साइट की ऐप्लिकेशन सर्वर कुंजियों (इन्हें वीएपीआईडी कुंजियां भी कहा जाता है) के कॉन्फ़िगरेशन की वजह से होती है.
Firefox और Chrome, दोनों में पुश नोटिफ़िकेशन की सुविधा इस्तेमाल करने का सबसे आसान तरीका है कि subscribe() कॉल में applicationServerKey दिया जाए. इसका नुकसान यह है कि आपके फ़्रंट एंड और सर्वर की कुंजियों के बीच कोई भी अंतर होने पर, अनुमति से जुड़ी गड़बड़ी होगी.
Chrome और एफ़सीएम पर
Chrome के लिए, जो FCM का इस्तेमाल पुश सेवा के तौर पर करता है, आपको कई अलग-अलग गड़बड़ियों के लिए FCM से UnauthorizedRegistration जवाब मिलेगा. इन सभी गड़बड़ियों में ऐप्लिकेशन सर्वर की कुंजियां शामिल होती हैं.
इनमें से किसी भी स्थिति में, आपको UnauthorizedRegistration गड़बड़ी का मैसेज मिलेगा:
- अगर आपने एफ़सीएम को भेजे गए अनुरोध में
Authorizationहेडर तय नहीं किया है. - उपयोगकर्ता को सदस्यता देने के लिए इस्तेमाल की गई आपकी ऐप्लिकेशन कुंजी, अनुमति देने वाले हेडर पर हस्ताक्षर करने के लिए इस्तेमाल की गई कुंजी से मेल नहीं खाती.
- आपके JWT में समयसीमा खत्म होने की तारीख अमान्य है. इसका मतलब है कि समयसीमा खत्म होने की तारीख 24 घंटे से ज़्यादा है या JWT की समयसीमा खत्म हो गई है.
- JWT गलत है या इसमें अमान्य वैल्यू हैं.
गड़बड़ी का पूरा जवाब ऐसा दिखता है:
<html>
<head>
<title>UnauthorizedRegistration</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<h1>UnauthorizedRegistration</h1>
<h2>Error 400</h2>
</body>
</html>
अगर आपको Chrome में गड़बड़ी का यह मैसेज मिलता है, तो Firefox में टेस्ट करके देखें कि क्या इससे समस्या के बारे में ज़्यादा जानकारी मिलती है.
Firefox और Mozilla AutoPush
Firefox और Mozilla AutoPush, Authorization से जुड़ी समस्याओं के लिए, गड़बड़ी के मैसेज का एक आसान सेट उपलब्ध कराते हैं.
अगर आपके पुश अनुरोध में Authorization हेडर शामिल नहीं है, तो आपको Mozilla AutoPush से Unauthorized गड़बड़ी का मैसेज भी मिलेगा.
{
"errno": 109,
"message": "Request did not validate missing authorization header",
"code": 401,
"more_info": "http://autopush.readthedocs.io/en/latest/http.html#error-codes",
"error": "Unauthorized"
}
अगर आपके JWT की समयसीमा खत्म हो गई है, तो आपको Unauthorized गड़बड़ी का मैसेज भी मिलेगा. इसमें बताया जाएगा कि टोकन की समयसीमा खत्म हो गई है.
{
"code": 401,
"errno": 109,
"error": "Unauthorized",
"more_info": "http://autopush.readthedocs.io/en/latest/http.html#error-codes",
"message": "Request did not validate Invalid bearer token: Auth expired"
}
अगर उपयोगकर्ता की सदस्यता लेने और ऑथराइज़ेशन हेडर पर हस्ताक्षर करने के समय, ऐप्लिकेशन सर्वर की कुंजियां अलग-अलग हों, तो Not Found गड़बड़ी का मैसेज दिखेगा:
{
"errno": 102,
"message": "Request did not validate invalid token",
"code": 404,
"more_info": "http://autopush.readthedocs.io/en/latest/http.html#error-codes",
"error": "Not Found"
}
आखिर में, अगर आपके JWT में कोई अमान्य वैल्यू है (उदाहरण के लिए, अगर "alg" वैल्यू कोई अनचाही वैल्यू है), तो आपको Mozilla AutoPush से यह गड़बड़ी मिलेगी:
{
"code": 401,
"errno": 109,
"error": "Unauthorized",
"more_info": "http://autopush.readthedocs.io/en/latest/http.html#error-codes",
"message": "Request did not validate Invalid Authorization Header"
}
एचटीटीपी स्टेटस कोड
पुश सेवा से 201 के अलावा कोई और रिस्पॉन्स कोड मिलने की कई वजहें हो सकती हैं. यहां एचटीटीपी स्टेटस कोड की सूची दी गई है. साथ ही, यह बताया गया है कि वेब पुश के मामले में उनका क्या मतलब है.
| स्थिति कोड | ब्यौरा |
|---|---|
| 429 | कई अनुरोध किए गए. आपके ऐप्लिकेशन सर्वर ने पुश सेवा के साथ अनुरोध संख्या सीमित करने की सीमा पूरी कर ली है. सेवा से मिलने वाले रिस्पॉन्स में 'Retry-After' हेडर शामिल होना चाहिए. इससे पता चलता है कि अगला अनुरोध करने से पहले कितना इंतज़ार करना होगा. |
| 400 | अनुरोध अमान्य है. आपका कोई हेडर अमान्य है या उसका फ़ॉर्मैट खराब है. |
| 404 | नहीं मिला. इस मामले में, आपको अपने बैक एंड से PushSubscription को मिटा देना चाहिए. साथ ही, उपयोगकर्ता को फिर से सदस्यता लेने का मौका मिलने का इंतज़ार करना चाहिए. |
| 410 | चला गया. सदस्यता अब मान्य नहीं है और इसे आपके बैक एंड से हटा दिया जाना चाहिए. `PushSubscription` पर `unsubscribe()` को कॉल करके, इसे फिर से जनरेट किया जा सकता है. |
| 413 | पेलोड का साइज़ बहुत बड़ा है. पुश सेवा के लिए, पेलोड का साइज़ कम से कम 4096 बाइट (या 4 केबी) होना चाहिए. इससे बड़ी फ़ाइल अपलोड करने पर, यह गड़बड़ी हो सकती है. |
अगर एचटीटीपी स्टेटस कोड इस सूची में नहीं है और गड़बड़ी का मैसेज मददगार नहीं है, तो वेब पुश प्रोटोकॉल की खास जानकारी देखें. इससे आपको पता चलेगा कि स्टेटस कोड का रेफ़रंस दिया गया है या नहीं. साथ ही, यह भी पता चलेगा कि उस स्टेटस कोड का इस्तेमाल कब किया जा सकता है.
पेलोड को एन्क्रिप्ट (सुरक्षित) करने से जुड़ी समस्या
अगर आपको पुश मैसेज ट्रिगर करने में कामयाबी मिलती है (यानी कि वेब पुश सेवा को मैसेज भेजने और 201 रिस्पॉन्स कोड मिलने पर), लेकिन आपके सर्विस वर्कर में पुश इवेंट कभी ट्रिगर नहीं होता है, तो आम तौर पर इसका मतलब है कि ब्राउज़र को मिले मैसेज को डिक्रिप्ट नहीं किया जा सका.
अगर ऐसा है, तो आपको Firefox के DevTools कंसोल में गड़बड़ी का यह मैसेज दिखेगा:

यह देखने के लिए कि Chrome में यह समस्या है या नहीं, यह तरीका अपनाएं:
- about://gcm-internals पर जाएं और "रिकॉर्डिंग शुरू करें" बटन पर क्लिक करें.

- पुश मैसेज ट्रिगर करें और "मैसेज डिक्रिप्शन फ़ेलियर लॉग" में देखें.

अगर पेलोड को डिक्रिप्ट करने में कोई समस्या आती है, तो आपको ऊपर दिखाई गई गड़बड़ी जैसा ही कोई मैसेज दिखेगा. (जानकारी वाले कॉलम में AES-GCM decryption failed
मैसेज देखें.)
अगर आपको एन्क्रिप्ट (सुरक्षित) करने से जुड़ी समस्या आ रही है, तो यहां कुछ टूल दिए गए हैं. इनकी मदद से, एन्क्रिप्ट (सुरक्षित) करने से जुड़ी समस्या को डीबग किया जा सकता है:
कनेक्शन की समस्या
अगर आपको अपने सर्विस वर्कर में कोई पुश इवेंट नहीं मिल रहा है और आपको डिक्रिप्शन से जुड़ी कोई गड़बड़ी नहीं दिख रही है, तो हो सकता है कि ब्राउज़र, पुश सेवा से कनेक्ट न हो पा रहा हो.
Chrome में, यह देखा जा सकता है कि ब्राउज़र को मैसेज मिल रहे हैं या नहीं. इसके लिए, about://gcm-internals में 'मैसेज लॉग पाएं' (sic) की जांच करें.

अगर आपको समय पर मैसेज नहीं मिल रहा है, तो पक्का करें कि आपके ब्राउज़र का कनेक्शन स्टेटस CONNECTED हो:

अगर यह 'कनेक्ट नहीं है', तो आपको अपनी मौजूदा प्रोफ़ाइल मिटानी पड़ सकती है और नई प्रोफ़ाइल बनानी पड़ सकती है. अगर इससे भी समस्या हल नहीं होती है, तो कृपया यहां बताए गए तरीके से गड़बड़ी की रिपोर्ट करें.
गड़बड़ी की रिपोर्ट सबमिट करना
अगर ऊपर दिए गए किसी भी तरीके से आपकी समस्या हल नहीं होती है और समस्या की वजह का पता नहीं चलता है, तो कृपया उस ब्राउज़र के ख़िलाफ़ समस्या दर्ज करें जिसमें आपको समस्या आ रही है:
Chrome के लिए, यहां समस्या की शिकायत करें: https://bugs.chromium.org/p/chromium/issues/list Firefox के लिए, यहां समस्या की शिकायत करें: https://bugzilla.mozilla.org/
गड़बड़ी की रिपोर्ट में ये जानकारी शामिल होनी चाहिए:
- वे ब्राउज़र जिनमें आपने जांच की है. जैसे, Chrome वर्शन 50, Chrome वर्शन 51, Firefox वर्शन 50, Firefox वर्शन 51.
- उदाहरण के तौर पर, समस्या की जानकारी देने वाला
PushSubscription. - अनुरोधों के उदाहरण शामिल करें. जैसे, पुश सेवा को किए गए नेटवर्क अनुरोधों का कॉन्टेंट, जिसमें हेडर भी शामिल हों.
- नेटवर्क के अनुरोधों से मिले रिस्पॉन्स के उदाहरण भी शामिल करें.
अगर आपके पास समस्या को फिर से दिखाने वाला कोई उदाहरण है, तो उसे उपलब्ध कराएं. जैसे, सोर्स कोड या होस्ट की गई वेबसाइट. इससे समस्या का पता लगाने और उसे हल करने में अक्सर मदद मिलती है.
आगे क्या करना है
- वेब ऐप्लिकेशन से भेजे गए पुश नोटिफ़िकेशन के बारे में खास जानकारी
- पुश करने की सुविधा कैसे काम करती है
- किसी उपयोगकर्ता को सदस्यता देना
- अनुमति का यूएक्स
- वेब पुश लाइब्रेरी की मदद से मैसेज भेजना
- वेब पुश प्रोटोकॉल
- पुश इवेंट मैनेज करना
- सूचना दिखाना
- सूचनाओं के व्यवहार से जुड़ी नीति
- सूचनाओं के सामान्य पैटर्न
- पुश नोटिफ़िकेशन के बारे में अक्सर पूछे जाने वाले सवाल
- आम तौर पर होने वाली समस्याएं और गड़बड़ियों की शिकायत करना