خطأ redirect_uri_mismatch عند الدخول بحساب Google: الحل
باختصار: إذا ضغط زبونك أو موظفك على زر «الدخول بحساب Google» في موقعك أو نظامك، فظهرت صفحة من Google تقول «Error 400: redirect_uri_mismatch» بدل صفحة اختيار الحساب، فالمشكلة ليست في حساب الزبون ولا في Google، بل في رابط واحد. توثيق Google عن OAuth 2.0 لتطبيقات الخادم يشرح أن رابط إعادة التوجيه الذي يرسله تطبيقك يجب أن يطابق تماماً أحد الروابط المسموحة المسجلة للعميل في Google Cloud Console، وأن المخطط http أو https، وحالة الأحرف، والشرطة المائلة الأخيرة كلها يجب أن تتطابق. الحل: انسخ الرابط الذي يرسله تطبيقك فعلاً، وأضفه حرفياً إلى قائمة الروابط المسموحة.
متى يظهر هذا الخطأ عادة؟
أكاديمية تعليم لغات في إربد لديها منصة دروس، والطلاب يسجلون الدخول بحساب Google. عملت الميزة شهوراً. ثم انتقلت المنصة من نطاق قديم إلى نطاق جديد، وفُعّلت شهادة HTTPS، وأُضيفت نسخة بنطاق يبدأ بـ www. فجأة صار نصف الطلاب يرون خطأ redirect_uri_mismatch، والنصف الآخر يدخل بلا مشكلة.
الفرق كان في الرابط الذي يفتح منه كل طالب المنصة: بعضهم يكتب العنوان مع www وبعضهم بدونه. هذا مثال توضيحي لأكثر أسباب الخطأ شيوعاً.
ما هو رابط إعادة التوجيه؟
عندما يضغط المستخدم زر الدخول بحساب Google، يرسله تطبيقك إلى Google مع عدة معلومات، منها رابط إعادة التوجيه: المكان الذي يجب أن تعيد Google المستخدم إليه بعد أن يوافق. توثيق Google يصف روابط إعادة التوجيه بأنها النقاط التي يستطيع خادم OAuth إرسال الاستجابات إليها.
ولأن هذه الاستجابة تحمل رمزاً يمنح الوصول، لا تقبل Google إرساله إلى أي رابط. يجب أن يكون الرابط مسجلاً مسبقاً في إعدادات العميل.
قاعدة المطابقة التامة
التوثيق صريح: القيمة يجب أن تطابق تماماً أحد روابط إعادة التوجيه المسموحة لعميل OAuth الذي أعددته، وإذا لم تطابق، ستحصل على خطأ redirect_uri_mismatch. ويضيف أن المخطط http أو https، وحالة الأحرف، والشرطة المائلة في النهاية، يجب أن تتطابق كلها.
هذه أمثلة توضيحية لروابط تبدو متشابهة لكنها مختلفة بالنسبة لـ Google:
- رابط بـ http ورابط بـ https للمسار نفسه.
- رابط مع www ورابط بدونه.
- رابط ينتهي بشرطة مائلة ورابط بدونها.
- رابط بحرف كبير في المسار ورابط بحرف صغير.
- رابط على النطاق القديم ورابط على النطاق الجديد.
كيف تجد الرابط الذي يرسله تطبيقك فعلاً؟
لا تخمن. عند ظهور صفحة الخطأ من Google، غالباً يمكن الاطلاع على تفاصيل الطلب، ومنها رابط إعادة التوجيه الذي أرسله التطبيق. وإذا لم تظهر، فشريط العنوان في المتصفح قبل صفحة الخطأ يحتوي معاملاً اسمه redirect_uri يحمل الرابط مُرمّزاً.
خذ هذا الرابط بالضبط وقارنه بما في القائمة المسموحة. الفرق عادة حرف أو مخطط أو شرطة.
أين تعدّل القائمة؟
التوثيق يشرح أن إنشاء بيانات الاعتماد يتم من صفحة العملاء في Google Cloud Console، باختيار نوع تطبيق الويب، وأن التطبيقات المبنية بلغات مثل PHP وJava وPython وRuby و.NET يجب أن تحدد روابط إعادة توجيه مسموحة. افتح العميل المستخدم في موقعك، وأضف الرابط الناقص في قسم روابط إعادة التوجيه المسموحة، واحفظ.
نصائح عند الإضافة:
- أضف كل نسخة يستخدمها الناس فعلاً. أو الأفضل: وحّد النطاق بتحويل دائم من نسخة إلى أخرى، فيبقى رابط واحد.
- لا تضف روابط تجريبية قديمة لم تعد تستخدم، واحذف روابط النطاق القديم بعد اكتمال الانتقال.
- تأكد أنك تعدّل العميل الصحيح. بعض المشاريع لديها عميل للتطوير وآخر للإنتاج.
قواعد Google لصلاحية الرابط
حتى قبل المطابقة، ترفض Google بعض الروابط من الأساس. التوثيق يعدد قواعد التحقق، منها:
- يجب أن تستخدم الروابط مخطط HTTPS لا HTTP، مع استثناء روابط localhost.
- لا يمكن أن يكون المضيف عنوان IP مباشراً، مع استثناء عناوين localhost.
- يجب أن ينتمي النطاق العلوي إلى قائمة اللواحق العامة.
- لا يمكن أن تحتوي الروابط نطاقات اختصار الروابط إلا إذا كان التطبيق يملك النطاق.
- لا يمكن أن تحتوي الروابط حرف النجمة، ولا جزء الإشارة الذي يبدأ بعلامة #.
النقطة الأخيرة مهمة: لا يمكن إضافة رابط بنجمة ليقبل كل المسارات أو كل النطاقات الفرعية. كل رابط يُضاف بعينه.
عندما يرسل الموقع http رغم أنه يعمل بـ https
حالة خاصة تحدث بعد وضع الموقع خلف Cloudflare أو خادم وسيط: الزائر يفتح الموقع بـ https، لكن رابط إعادة التوجيه الذي يرسله التطبيق يبدأ بـ http. السبب الشائع أن التطبيق يبني الرابط من عنوان الطلب كما يراه هو، والوسيط يمرر الطلب إليه عبر اتصال داخلي عادي. عندها تفشل المطابقة، وقواعد Google لا تقبل أصلاً رابطاً بـ http لغير localhost.
لا تضف رابط http لإسكات الخطأ. الحل أن يُضبط التطبيق ليعرف أنه خلف وسيط آمن، أو أن يُكتب رابط إعادة التوجيه في إعدادات التطبيق بقيمة ثابتة كاملة تبدأ بـ https.
من يملك المشروع في Google Cloud؟
قبل أي تعديل، تأكد من الحساب الذي أُنشئ عليه المشروع. كثيراً ما يكون باسم المطور السابق. اطلب إضافة حساب الشركة كمالك، كي لا تتوقف عن التعديل إذا غادر المطور.
التطوير المحلي
التوثيق يذكر أنه للاختبار يمكن تحديد روابط تشير إلى الجهاز المحلي، مثل localhost مع منفذ. إذا كان المطور يختبر على جهازه، فقد يحتاج رابط localhost في عميل التطوير. لا تخلطه مع عميل الإنتاج إن أمكن، وإذا اضطررت، فاحذفه بعد انتهاء التطوير.
خطأ آخر قريب منه
إذا كان موقعك يستخدم زر Google الذي يعمل داخل الصفحة دون إعادة توجيه، فقد تحتاج إعداداً مختلفاً هو أصول JavaScript المسموحة. هذا إعداد منفصل في الصفحة نفسها، ولا يحل محل روابط إعادة التوجيه. اسأل المطور أي الطريقتين يستخدم الموقع.
قائمة بعد تغيير النطاق
- سجّل كل النطاقات التي يمكن أن يُفتح منها الموقع.
- وحّدها بتحويل دائم إلى نطاق واحد.
- حدّث روابط إعادة التوجيه في Google Cloud Console للنطاق الموحد.
- جرّب الدخول بحساب Google من الحاسوب والهاتف، ومن رابط قديم محفوظ.
- احذف روابط النطاق القديم بعد فترة انتقالية.
أسئلة شائعة
شو يعني redirect_uri_mismatch لما بدخل بحساب Google؟
يعني أن الرابط الذي يرسله موقعك لإعادة المستخدم لا يطابق تماماً أي رابط مسجل في إعدادات العميل في Google Cloud Console.
الرابط مضاف بس الخطأ مستمر، ليش؟
تحقق من التفاصيل الصغيرة: https مقابل http، وwww، والشرطة المائلة الأخيرة، وحالة الأحرف. التوثيق يقول إنها كلها يجب أن تتطابق.
بقدر أضيف رابط بنجمة يقبل كل الصفحات؟
لا. قواعد Google تمنع حرف النجمة في روابط إعادة التوجيه.
ليش بعض الناس بيدخلوا وبعضهم لا؟
غالباً لأنهم يفتحون الموقع من نسختين مختلفتين للنطاق، واحدة مسجلة وأخرى غير مسجلة.
إذا تعطل الدخول بحساب Google في موقعك أو منصتك، اكتب لنا ونضبط الإعدادات معك.