تخطي إلى المحتوى الرئيسي
عاجل
التقنية دقيقتان قراءة 3 مشاهدة

فهم CORS (Cross-Origin Resource Sharing) وكيف تحل أخطاءه نهائياً

دليل مبسط لفهم سياسة نفس المصدر في المتصفح وتكوين ترويسات الخادم والوسيط المحلي بشكل سليم

فهم CORS (Cross-Origin Resource Sharing) وكيف تحل أخطاءه نهائياً
مشاركة المقال: واتساب تيليجرام إكس فيسبوك لينكد إن
إعلان ممول Google AdSense

مشاركة الموارد عبر المصادر (CORS) هي آلية أمان يفرضها المتصفح لتقييد طلبات JavaScript الموجهة إلى نطاق (Domain) أو منفذ (Port) أو بروتوكول مختلف عن موقعك الحالي. لحل أخطاء CORS نهائياً، يجب أن يرسل الخادم المستهدف ترويسة Access-Control-Allow-Origin مصرحةً بنطاقك، لأن الحظر يتم داخل المتصفح وليس داخل الواجهة البرمجية نفسها.

لماذا تظهر رسالة CORS رغم عمل الطلب في Postman؟

تطبيقات اختبار الواجهات مثل Postman وThunder Client أو طلبات الخادم-للخادم لا تخضع لسياسة نفس المصدر (Same-Origin Policy) لأنها ليست متصفحاً يحمي جلسة مستخدم. وعند إرسال طلبات معقدة (مثل POST بصيغة JSON أو وجود ترويسة Authorization)، يرسل المتصفح أولاً طلب فحص استباقي من نوع OPTIONS يُعرف بـ Preflight للتأكد من موافقة الخادم.

  • اختلاف الأصل (Origin): مجرد اختلاف البروتوكول (http مقابل https) أو المنفذ (3000 مقابل 5000) يُعد مصدراً مختلفاً.
  • المصادقة والكوكيز: إذا أرسلت credentials: 'include'، فلا يسمح المتصفح بوضع النجمة * في الترويسة، بل يشترط تحديد النطاق الصريح مع ترويسة Access-Control-Allow-Credentials: true.
  • الوكيل أثناء التطوير (Dev Proxy): يمكنك توجيه طلبات التطوير في Vite أو Next.js عبر نفس المنفذ لتجنب تعديل إعدادات الإنتاج مؤقتاً.

جدول أشهر ترويسات CORS ووظيفة كل منها

الترويسة (Header)الوظيفة الأمنيةالقيمة الشائعةAccess-Control-Allow-Originتحديد النطاقات المسموح لها بالقراءةhttps://egymonitor.com أو *Access-Control-Allow-Methodsتحديد طرق HTTP المسموحةGET, POST, PUT, DELETE, OPTIONSAccess-Control-Allow-Headersالترويسات المخصصة المسموح بإرسالهاContent-Type, AuthorizationAccess-Control-Allow-Credentialsالسماح بإرسال Cookies والتوكناتtrue

مثال كود: حل المشكلة في خادم Express ووسيط Vite

الحل الصحيح للإنتاج يكون في الخادم، بينما يسهل وسيط Vite عملية التطوير المحلي:

// في خادم Node.js / Express
import cors from 'cors';
app.use(cors({
  origin: 'https://egymonitor.com',
  credentials: true
}));

// أو في vite.config.ts للتطوير المحلي فقط
server: {
  proxy: { '/api': 'http://localhost:5000' }
}
تجنب الاعتماد على إضافات المتصفح التي تعطل CORS أثناء البرمجة؛ لأنها تخفي المشكلة عنك وتفاجئ المستخدمين عند نشر الموقع.

أسئلة شائعة

  • هل وضع النجمة (*) في Allow-Origin آمن؟ آمن فقط للواجهات العامة المجانية التي لا تستخدم كوكيز أو بيانات مستخدمين خاصة، أما المنصات ذات تسجيل الدخول فيجب تقييد النطاقات فيها.
  • لماذا أرى طلب OPTIONS قبل كل طلب POST؟ هذا هو طلب Preflight التلقائي من المتصفح للتحقق من الصلاحيات؛ ويمكن تقليل تكراره عبر ترويسة Access-Control-Max-Age.
  • هل يمكن حل خطأ CORS عبر تعديل كود الواجهة الأمامية فقط؟ في الإنتاج لا، ما لم تمرر الطلبات عبر خادم وسيط (Backend Proxy) تابع لنفس نطاقك.
إعلان ممول Google AdSense
عبدالرحمن شوقي

عبدالرحمن شوقي

كاتب في ايجي مونيتور

المدير العام لمنصة ايجي مونيتور.

ما رأيك بهذا المقال؟ سجل الدخول للتفاعل

التعليقات (0)

أضف تعليقك

كن أول من يعلق على هذا المقال!

مقالات ذات صلة

المزيد من التقنية
دقيقتان قراءة

الطوابير والمهام الخلفية في Laravel (Queues & Jobs) لتحسين سرعة الاستجابة

تعرّف على كيفية استخدام الطوابير والمهام الخلفية Queues & Jobs في Laravel مع Redis وHorizon لتسريع استجابة الموقع ومعالجة المهام الثقيلة بأمان.

دقيقتان قراءة

حل مشكلة N+1 Query في Laravel Eloquent عبر Eager Loading بأمثلة عملية

تعلّم كيفية اكتشاف وحل مشكلة N+1 Query في Laravel Eloquent عبر Eager Loading وwith() وpreventLazyLoading لتحسين أداء قاعدة البيانات وتقليل زمن الاستجابة.

دقيقتان قراءة

خارطة طريق مطور الخوادم Backend Developer: المهارات والتقنيات الأساسية

اكتشف خارطة طريق مطور الخوادم Backend Developer خطوة بخطوة: اللغات البرمجية، قواعد البيانات، تصميم APIs، التخزين المؤقت، والأمان لبناء أنظمة قابلة للتوسع.

7 دقائق قراءة

توسع الألياف الضوئية (FTTH) والإنترنت الفضائي ستارلينك في الشرق الأوسط وشمال أفريقيا 2026: خريطة التغطية والأسعار

تقرير شامل حول توسع الألياف الضوئية وستارلينك في الشرق الأوسط وشمال أفريقيا 2026، يغطي نسب الانتشار، وخريطة الدول المتاحة، والأسعار.

7 دقائق قراءة

دليل نظام «إي فواتيركم» والمدفوعات الفورية «كليك» في الأردن 2026: الأرقام والرسوم

دليل شامل لنظامي إي فواتيركم وكليك في الأردن 2026 يستعرض أحدث بيانات جوباك، وحجم المعاملات المليارية، وهيكل الرسوم للأفراد والشركات.

6 دقائق قراءة

ثورة الدفع البيومتري والدرهم الرقمي في الإمارات 2026: كيف تتغير تجربة التسوق والتحويلات المالية؟

قراءة معمقة في تحول المدفوعات بالإمارات خلال 2026 عبر مشروع الدرهم الرقمي وتجارب الدفع البيومتري بالوجه والكف وتوسع منظومتي آني وجيوان الوطنيتين.