ERR_CLEARTEXT_NOT_PERMITTED -29

خطأ الشبكة -29

BROWSER

الرسالة الرسمية (كما تظهر على الشاشة): Unencrypted (cleartext HTTP) traffic is not permitted.

يُبحث عنه أيضًا باسم: net::ERR_CLEARTEXT_NOT_PERMITTED, webview cleartext not permitted, error -29

صفحة خطأ في المتصفح تعرض كود خطأ شبكة وقائمة بالأسباب المحتملة
أخطاء الشبكة في المتصفح: استبعد اتصالك أولًا، ثم الموقع.

ماذا يعني

يعرض تطبيق Android صفحة WebView مع net::ERR_CLEARTEXT_NOT_PERMITTED. فمنذ Android 9 (API 28) تحظر التطبيقات حركة http:// العادية افتراضيًا، لذا ترفض WebView تحميل عنوان غير HTTPS. وهي مشكلة إعداد في التطبيق وليست في الهاتف.

ينطبق على: Android WebView, Android 9 فما فوق

كيفية إصلاح ERR_CLEARTEXT_NOT_PERMITTED

  1. إذا كنت مستخدمًا للتطبيق: حدّث التطبيق أو أبلغ مطوره بالخطأ؛ فلا يمكنك تغيير هذا الإعداد من الهاتف
  2. إذا كنت تطور التطبيق: حوّل العنوان إلى https:// كلما أمكن؛ فهذا هو الإصلاح الصحيح
  3. إذا كان لا بد من السماح بـ HTTP لمضيفات محددة: أضف ملف إعدادات أمان الشبكة (res/xml/network_security_config.xml) يتضمن domain-config cleartextTrafficPermitted="true" لتلك النطاقات فقط، وأشر إليه من ملف manifest
  4. لخوادم التطوير المحلية فقط، اسمح بالنص الصريح لـ 10.0.2.2 أو عنوان IP في شبكتك المحلية ضمن إعدادات أمان الشبكة لنسخة debug
  5. تجنب android:usesCleartextTraffic="true" بشكل عام في نسخ release إلا إذا كنت بحاجة إليه فعلًا
  6. افحص إعادات التوجيه: صفحة https تعيد التوجيه إلى http ما زالت تطلق الخطأ

سبب حدوثه

يضبط Network Security Configuration في Android قيمة cleartextTrafficPermitted على false افتراضيًا للتطبيقات التي تستهدف API 28 فما فوق، لذا ترفض WebView وعملاء HTTP الآخرون HTTP غير المشفر.

الأسئلة الشائعة

هل يمكنني إصلاح ERR_CLEARTEXT_NOT_PERMITTED بصفتي مستخدمًا للتطبيق؟

لا. فمطور التطبيق وحده يستطيع تفعيل HTTPS على الخادم أو تغيير إعدادات أمان الشبكة في التطبيق.

أخطاء ذات صلة

المصدر: Chromium net_error_list.h · حلول كتبها المحررون وراجعوها (راجع السياسة التحريرية)

آخر تحديث: