أكثر 5 أخطاء شيوعًا في JSON (وكيفية إصلاحها)

By فريق JSONValidator.dev 2025-07-04

مقدمة: لماذا الأخطاء في JSON شائعة جدًا

تُعد JSON من أكثر صيغ البيانات شيوعًا في واجهات برمجة التطبيقات، التهيئة، وتبادل البيانات. ومع ذلك، حتى الأخطاء الصغيرة في JSON يمكن أن تسبب تعطل التطبيقات، توقف التكاملات، أو تعقيد عملية تصحيح الأخطاء. فيما يلي أكثر خمسة أخطاء شائعة في JSON (مع أمثلة حقيقية) وكيفية إصلاحها.

1. الفاصلة الزائدة في النهاية

في JSON، لا يُسمح بوضع فاصلة بعد العنصر الأخير في كائن أو مصفوفة. هذا خطأ شائع يحدث أثناء التحرير اليدوي.

Before:
{
  "name": "Alice",
  "age": 30,
}
After:
{
  "name": "Alice",
  "age": 30
}
نصيحة: العديد من محررات الشفرات (وأدوات JSON الإلكترونية الخاصة بنا) تقوم بتمييز أو تصحيح الفواصل الزائدة تلقائيًا.

2. علامات الاقتباس المفردة مقابل المزدوجة

تتطلب JSON أن تستخدم جميع المفاتيح والقيم النصية علامات اقتباس مزدوجة فقط. علامات الاقتباس المفردة غير صالحة.

Before:
{
  'name': 'Bob'
}
After:
{
  "name": "Bob"
}
لا تستخدم علامات الاقتباس المفردة — حتى لو كانت مسموحة في لغة البرمجة الخاصة بك! صيغة JSON أكثر صرامة من جافا سكريبت أو بايثون.

3. الأحرف غير المهربة

يجب هروب بعض الأحرف (مثل الأسطر الجديدة، علامات الجدولة، أو علامات الاقتباس داخل النص) بشكل صحيح باستخدام الشرطة المائلة العكسية.

Before:
{
  "note": "This will break: "hello""
}
After:
{
  "note": "This will work: \"hello\""
}
إذا رأيت 'رمز غير متوقع' أو 'سلسلة غير منتهية'، تحقق من الهروب المفقود في بياناتك.

4. الأقواس أو الأقواس المفقودة

يجب أن تتطابق كل قوس أو قوس مع مناظره المغلق. وجود قوس مفقود أو زائد يؤدي دائمًا إلى JSON غير صالح.

Before:
{
  "name": "Eve",
  "items": [1, 2, 3
}
After:
{
  "name": "Eve",
  "items": [1, 2, 3]
}
استخدم مدقق JSON عبر الإنترنت للكشف الفوري عن الأقواس المفقودة أو الزائدة.

5. أخطاء نوع البيانات

الأرقام، القيم المنطقية، والقيم null لا يجب أن تكون محاطة بعلامات اقتباس. على سبيل المثال، 42 صحيح، ولكن "42" هو نص وليس رقم.

  • "true" (نص) ليست مثل true (قيمة منطقية)
  • "null" (نص) ليست مثل null (القيمة الفارغة)
  • "42" (نص) ليست مثل 42 (رقم)
Before:
{
  "age": "42",
  "active": "true"
}
After:
{
  "age": 42,
  "active": true
}

كيف يمكن لأدواتنا مساعدتك

الصق JSON الخاص بك في مدقق JSON أو أداة الإصلاح لاكتشاف وإصلاح هذه الأخطاء فورًا. أدواتنا تشير إلى المشكلة بدقة وحتى تقترح إصلاحات تلقائية للعديد من الأخطاء الشائعة.