خلاصه: خطای CORS مخفف Cross-Origin Resource Sharing است و زمانی رخ میدهد که مرورگر اجازه دسترسی یک صفحه وب به منابع مبدأ دیگری را صادر نکند. برای مثال، ممکن است یک سایت روی دامنهای اجرا شود، اما اطلاعات موردنیاز خود را از یک API روی دامنه دیگری دریافت کند. در چنین شرایطی، سرور مقصد باید با استفاده از هدرهای مناسب مشخص کند که درخواست از مبدأ موردنظر مجاز است یا خیر.
برای مثال، فرض کنید صفحه ثبت سفارش از دامنه example.com اطلاعات محصولات را از API دامنه api.example.net دریافت میکند. اگر سرور API مبدأ سایت را مجاز نداند یا هدرهای لازم را ارسال نکند، مرورگر دسترسی به پاسخ را مسدود میکند و ممکن است خطای CORS در کنسول توسعهدهنده نمایش داده شود.
دلایل رایج بروز این خطا عبارتاند از:
- تنظیم نادرست هدر Access-Control-Allow-Origin در سرور مقصد.
- مجاز نبودن دامنه، زیردامنه یا پورت ارسالکننده درخواست.
- پیکربندی ناقص درخواستهای پیشبررسی (Preflight).
- استفاده نادرست از اعتبارنامهها، مانند کوکیها، در درخواستهای بینمبدأیی.
- تفاوت تنظیمات محیط توسعه و نسخه اصلی سایت.
روشهای رفع خطا
برای رفع مشکل، ابتدا درخواست ناموفق و هدرهای پاسخ را در بخش Network ابزار توسعه مرورگر بررسی کنید. سپس تنظیمات CORS را در سرور یا API مقصد اصلاح کنید تا مبدأهای مجاز و روشهای موردنیاز بهدرستی تعریف شوند.
اگر درخواست از کوکی یا اعتبارنامه استفاده میکند، تنظیمات مربوط به ارسال اعتبارنامه و هدرهای پاسخ نیز باید با یکدیگر سازگار باشند.
نکته مهم این است که افزودن هدرهای امنیتی بهصورت تصادفی یا استفاده از علامت * برای مجاز کردن همه مبدأها، بهخصوص هنگام ارسال اعتبارنامه، راهحل مناسبی نیست. خطای CORS معمولاً بهخودیخود جریمه سئو محسوب نمیشود؛ اما اگر مانع بارگذاری محتوا یا عملکرد بخش مهمی از سایت شود، میتواند تجربه کاربر را تحت تأثیر قرار دهد.