सामान्य JSON सिंटैक्स त्रुटियों को समझना और ठीक करना: RFC 8259 गाइड
1. सिंटैक्स सत्यापन बनाम JSON Schema बनाम व्यावसायिक नियम (Business Rules)
डेवलपर्स के बीच एक आम भ्रम सभी प्रकार के JSON डेटा सत्यापन को एक ही प्रक्रिया मानना है। आधुनिक सॉफ्टवेयर इंजीनियरिंग में तीन अलग-अलग सत्यापन स्तर स्पष्ट रूप से कार्य करते हैं:
- RFC 8259 सिंटैक्स सत्यापन (Syntax Validation): यह जांचता है कि डेटा पेलोड JSON के शाब्दिक व्याकरण का कड़ाई से पालन करता है या नहीं: घुंघराले कोष्ठक और वर्गाकार कोष्ठक का सही संतुलन, दोहरे उद्धरण चिह्नों में कुंजियाँ और स्ट्रिंग्स, विभाजक के रूप में अल्पविराम, और वैध आदिम मान (स्ट्रिंग्स, संख्याएँ, बूलियन, null)। यदि एक भी उद्धरण चिह्न या कोष्ठक गायब है, तो वह टेक्स्ट वैध JSON डेटा के रूप में मान्य नहीं हो सकता।
- JSON Schema सत्यापन: यह मूल्यांकन करता है कि सिंटैक्स रूप से सही JSON दस्तावेज़ किसी पूर्वनिर्धारित डेटा अनुबंध (
$schemaविनिर्देशों, आवश्यक प्रॉपर्टी प्रकारों, अनिवार्य फ़ील्ड्स, सरणी सीमाओं) का अनुपालन करता है या नहीं। कोई दस्तावेज़ सिंटैक्स में 100% सही होकर भी स्कीमा का उल्लंघन कर सकता है। - व्यावसायिक नियम सत्यापन (Business Rules): यह एप्लिकेशन के विशिष्ट डोमेन तर्क को लागू करता है (उदाहरण के लिए, बैंक शेष राशि नकारात्मक नहीं हो सकती या समाप्ति तिथि प्रारंभ तिथि के बाद होनी चाहिए)। न तो सिंटैक्स पार्सर और न ही सामान्य स्कीमा व्यावसायिक नियमों की वैधता की गारंटी देते हैं।
GoToolstack का टूल केवल सख्त RFC 8259 सिंटैक्स सत्यापन और AST (एब्सट्रैक्ट सिंटैक्स ट्री) फ़ॉर्मेटिंग करता है; यह JSON Schema या व्यावसायिक नियमों का मूल्यांकन नहीं करता है।
2. फ़ॉर्मेटिंग का अर्थ स्वचालित त्रुटि सुधार नहीं है
JSON फ़ॉर्मेटर्स (सुंदरीकरण और मिनिफ़ायर) पहले से मान्य एब्सट्रैक्ट सिंटैक्स ट्री (AST) पर रिक्त स्थान, नई पंक्तियों और इंडेंटेशन को पुनर्व्यवस्थित करते हैं। वे कोई स्वचालित त्रुटि-सुधार इंजन नहीं हैं।
जब कोई अमान्य इनपुट दर्ज किया जाता है, तो इंजन पहले अमान्य बाइट पर तुरंत रुक जाता है, एक स्पष्ट नैदानिक संदेश (जैसे Trailing comma in object is not allowed at position 45) प्रदर्शित करता है और आउटपुट पैनल को खाली कर देता है। यह टूल डेवलपर के इरादे का अनुमान नहीं लगाता, छूटे हुए कोष्ठक नहीं जोड़ता, अवैध अंतिम अल्पविराम को चुपचाप नहीं हटाता, और न ही एकल उद्धरण चिह्नों को स्वचालित रूप से बदलता है। फ़ॉर्मेटिंग सफल होने के लिए सिंटैक्स त्रुटि का मैन्युअल सुधार आवश्यक है।
3. 5 सबसे आम JSON सिंटैक्स विफलताएं
त्रुटि 1: ऑब्जेक्ट या सरणी में अंतिम अतिरिक्त अल्पविराम (Trailing Commas)
× अमान्य:
{
"name": "GoToolstack",
"active": true,
}इंजन निदान संदेश: Trailing comma in object is not allowed at position 45 (near "active": true,
}")
✓ सही समाधान: RFC 8259 में अल्पविराम केवल तत्वों को अलग करने वाले विभाजक हैं, टर्मिनेटर नहीं। अंतिम मान के बाद और बंद होने वाले } या ] से पहले वाले अल्पविराम को हटा दें।
त्रुटि 2: दोहरे उद्धरण चिह्नों के स्थान पर एकल उद्धरण चिह्न (Single Quotes)
× अमान्य:
{'status': 'success'}इंजन निदान संदेश: Expected string key in object at position 1 (near "{'status': 'success'}")
✓ सही समाधान: यद्यपि जावास्क्रिप्ट एकल उद्धरण चिह्नों की अनुमति देता है, RFC 8259 धारा 7 सभी ऑब्जेक्ट कुंजियों और स्ट्रिंग मानों के लिए अनिवार्य रूप से दोहरे उद्धरण चिह्न (") की मांग करती है ({"status": "success"})।
त्रुटि 3: उद्धरण चिह्नों के बिना ऑब्जेक्ट कुंजियाँ (Unquoted Keys)
× अमान्य:
{count: 42}इंजन निदान संदेश: Expected string key in object at position 1 (near "{count: 42}")
✓ सही समाधान: लचीले जावास्क्रिप्ट ऑब्जेक्ट्स के विपरीत, JSON में प्रत्येक प्रॉपर्टी नाम को दोहरे उद्धरण चिह्नों में संलग्न करना अनिवार्य है ({"count": 42})।
त्रुटि 4: अमान्य एस्केप अनुक्रम और अनएस्केप किए गए बैकस्लैश
× अमान्य:
{"path": "C:\programs\data.json"}इंजन निदान संदेश: Invalid escape sequence \p at position 13 (near "{"path": "C:\programs"}")
✓ सही समाधान: RFC 8259 केवल ", \\, /, , ,
,
, और 4-अंकीय हेक्साडेसिमल यूनिकोड अनुक्रम \uXXXX को मान्यता देता है। विंडोज फ़ाइल पाथ के बैकस्लैश को दोगुना एस्केप किया जाना चाहिए: {"path": "C:\\programs\\data.json"}।
त्रुटि 5: JSON पेलोड के भीतर टिप्पणियाँ (Comments)
× अमान्य:
// सर्वर सेटिंग्स
{"port": 8080}इंजन निदान संदेश: Unexpected token '/' at position 0 (near "// सर्वर सेटिंग्स")
✓ सही समाधान: मानक JSON में टिप्पणियों के लिए कोई सिंटैक्स (न // और न /* */) समर्थित नहीं है। डेटा भेजने या फ़ॉर्मेट करने से पहले सभी टिप्पणियों को पूरी तरह हटा दिया जाना चाहिए।
4. 64-बिट पूर्णांक जाल: हानिरहित टोकन संरक्षण बनाम डाउनस्ट्रीम सिस्टम में परिशुद्धता हानि का जोखिम
मानक जावास्क्रिप्ट वातावरण में संख्याएँ IEEE 754 64-बिट डबल-प्रिसिजन फ्लोटिंग-पॉइंट प्रारूप में संग्रहीत की जाती हैं। सुरक्षित पूर्णांकों की अधिकतम सीमा है:
Number.MAX_SAFE_INTEGER = 9,007,199,254,740,991 (2^53 - 1)जब कोई API बड़े 64-बिट पहचानकर्ता, डेटाबेस प्राथमिक कुंजियाँ या ब्लॉकचेन लेनदेन हैश (जैसे 9007199254740993) प्रदान करता है, तो एक सामान्य JSON.parse() कॉल बिना कोई त्रुटि दिए चुपचाप मान को 9007199254740992 में पूर्णांकित कर देता है, जिससे डेटा दूषित हो जाता है।
GoToolstack इंजन एक कस्टम दोषरहित (lossless) पार्सर का उपयोग करता है जो संख्यात्मक लिटरल्स को AST पर सटीक टेक्स्ट टोकन के रूप में सहेजता है। इस प्रकार फ़ॉर्मेट करते समय मूल संख्याएँ पूरी तरह सुरक्षित रहती हैं। हालाँकि, यह स्थानीय सुरक्षा बाहरी डाउनस्ट्रीम सिस्टम की सुरक्षा की गारंटी नहीं देती है: यदि कोई डाउनस्ट्रीम माइक्रोसर्विस, डेटाबेस ड्राइवर या क्लाइंट मानक float64 पार्सर के साथ JSON का विश्लेषण करता है, तो परिशुद्धता हानि उसी समय होगी। वितरित प्रणालियों में, 64-बिट पहचानकर्ताओं को स्ट्रिंग्स (उदा. "9007199254740993") के रूप में प्रसारित करने की अनुशंसा की जाती है।
5. डुप्लिकेट ऑब्जेक्ट कुंजियाँ और RFC 8259 के तहत व्याख्या की अस्पष्टता
समान ऑब्जेक्ट के भीतर डुप्लिकेट कुंजियों वाली संरचना पर विचार करें:
{"user": "alice", "user": "bob"}GoToolstack का AST पार्सर प्रत्येक कुंजी-मान युग्म को बिना किसी पिछले मान को हटाए क्रमबद्ध तरीके से सुरक्षित रखता है। हालाँकि, RFC 8259 की धारा 4 स्पष्ट रूप से बताती है कि डुप्लिकेट कुंजियों पर विभिन्न पार्सर्स का व्यवहार अप्रत्याशित होता है:
- कुछ पार्सर केवल पहली कुंजी को बनाए रखते हैं और बाद की प्रविष्टियों को अनदेखा करते हैं।
- मानक लाइब्रेरीज़ (जैसे JS में
JSON.parse()और Python मेंjson.loads()) पिछले मान को अधिलेखित कर देती हैं और केवल अंतिम कुंजी रखती हैं। - कुछ सख्त पार्सर दस्तावेज़ को तुरंत अस्वीकार कर देते हैं और सिंटैक्स त्रुटि देते हैं।
GoToolstack द्वारा डुप्लिकेट कुंजियों को बनाए रखने का अर्थ यह नहीं है कि प्राप्तकर्ता सिस्टम उन्हें समान रूप से व्याख्या करेंगे। प्रोडक्शन वातावरण में, प्रत्येक ऑब्जेक्ट कुंजी अद्वितीय होनी चाहिए।
6. तकनीकी सीमाएं और टूल की कार्य-सीमाएं
ब्राउज़र मेमोरी और बड़े पेलोड: 50 MB से अधिक आकार के मिनिफ़ाइड JSON को फ़ॉर्मेट करते समय DOM टेक्स्ट क्षेत्र रेंडरिंग के दौरान ब्राउज़र का UI थ्रेड कुछ पलों के लिए रुक सकता है। कई गीगाबाइट आकार के लॉग के लिए jq जैसे कमांड-लाइन टूल का उपयोग करें।
- कोई ट्री व्यू या स्कीमा सत्यापन नहीं: यह टूल रीयल-टाइम डायग्नोस्टिक्स के साथ एक स्वच्छ, दो-फलक वाला सादा टेक्स्ट एडिटर प्रदान करता है। इसमें बंधनेवाला DOM ट्री व्यूअर या JSON Schema सत्यापनकर्ता शामिल नहीं है।
- अस्वीकृत मान:
NaN,Infinity, और-InfinityRFC 8259 में अनुमत नहीं हैं। जावास्क्रिप्टundefined, फ़ंक्शंस, और सर्कुलर संदर्भों को JSON में क्रमबद्ध नहीं किया जा सकता है। - क्लाइंट-साइड निष्पादन: सभी पार्सिंग और AST फ़ॉर्मेटिंग केवल उपयोगकर्ता के ब्राउज़र मेमोरी में स्थानीय रूप से चलती है; कोई भी डेटा बाहरी सर्वर पर नहीं भेजा जाता है।
