خلاصه: خطای Invalid JSON زمانی رخ میدهد که دادهای با قالب JSON ارسال یا دریافت شود، اما ساختار آن با قواعد این فرمت مطابقت نداشته باشد. JSON برای تبادل اطلاعات میان بخشهای مختلف نرمافزار، از جمله وبسایت، سرور و API، استفاده میشود. در این قالب، نام کلیدها و رشتههای متنی باید داخل علامت نقلقول دوتایی قرار بگیرند و آرایهها، آبجکتها و مقادیر نیز باید ساختار معتبری داشته باشند.
برای مثال، فرض کنید یک فرم ثبتنام اطلاعات کاربر را بهصورت JSON به سرور ارسال میکند، اما کد سایت بهجای تولید داده معتبر، از علامت نقلقول اشتباه یا ویرگول اضافی استفاده میکند. در این حالت، سرور ممکن است نتواند اطلاعات را پردازش کند و خطای Invalid JSON یا پیام مشابهی نمایش دهد.
دلایل رایج بروز این خطا عبارتاند از:
- وجود ویرگول اضافی یا جاافتادن ویرگول بین مقادیر.
- استفاده از علامت نقلقول تکی بهجای دوتایی در رشتهها.
- ناقص بودن پاسخ API یا ارسال داده با قالبی متفاوت از انتظار برنامه.
- بازگرداندن صفحه خطای HTML بهجای پاسخ JSON.
- تداخل افزونهها یا وجود خطا در کدهای سمت سرور.
روشهای رفع خطا
برای رفع مشکل، ابتدا متن واقعی درخواست و پاسخ را در ابزارهای توسعه مرورگر و بخش Network بررسی کنید. سپس ساختار JSON را با یک ابزار اعتبارسنجی آزمایش کنید و مطمئن شوید سرور نوع محتوای مناسب، مانند application/json، را ارسال میکند.
اگر پاسخ دریافتی بهجای JSON شامل پیام خطای PHP یا صفحه ورود باشد، باید علت تولید پاسخ نامعتبر را در سمت سرور پیدا کنید.
در وبسایتهای وردپرسی نیز خطای JSON هنگام ذخیره نوشته یا استفاده از ویرایشگر بلوکی ممکن است به تنظیمات پیوند یکتا، افزونهها، قالب یا پاسخ نادرست سرور مربوط باشد.
نکته مهم این است که خطای Invalid JSON همیشه ناشی از اشتباه در ساختار داده نیست؛ گاهی سرور بهجای پاسخ JSON، یک پیام خطای دیگر برمیگرداند. بنابراین، بررسی محتوای واقعی پاسخ دریافتی برای شناسایی علت اصلی ضروری است.