مشاركة الموارد عبر المصادر (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) تابع لنفس نطاقك.
التعليقات (0)
أضف تعليقك