قد يرسل تكامل مرفقًا صغيرًا داخل حقل نصي بترميز Base64. تصل بيانات فيها علامات إضافية، وتنجح عملية الفك رغم اختلاف المدخل عن العقد. في Python، تختلف معالجة الأحرف غير التابعة للأبجدية بحسب إعداد validate في b64decode. لذلك يحتاج اختبار المدخل إلى حالات تتجاوز الملف السليم وحده.
قارن نفس المدخل بإعدادين
في مثال تعليمي، SGVsbG8= تمثل بايتات كلمة Hello. أضف علامتي تعجب إلى النهاية، ثم جرّب الفك الافتراضي والفك مع validate=True. هذه عينة لترميز المحتوى فقط، ولا تمثل مرفق عميل أو ملفًا حقيقيًا في نظام الشركة.
import base64
valid = 'SGVsbG8='
noisy = 'SGVsbG8=!!'
assert base64.b64decode(valid, validate=True) == b'Hello'
print(base64.b64decode(noisy))
base64.b64decode(noisy, validate=True)
اقرأ سبب اختلاف النتيجة
يتجاهل الوضع الافتراضي أحرفًا خارج أبجدية Base64 قبل فحص padding. أما validate=True فيرفض الأحرف غير المسموح بها بخطأ binascii.Error. اختبر كذلك مدخلًا ناقص padding، واعرض للمصدر رسالة تتعلق بصحة الترميز بدل تسجيل المهمة على أنها استوردت مرفقًا ناجحًا.
إذا كان المصدر يرسل أسطرًا أو فراغات بتنسيق معروف، حدد ذلك في العقد قبل اختيار سياسة الرفض أو التنظيف. حذف كل حرف غير متوقع بلا تمييز قد يخفي مشكلة في النقل. وميّز Base64 القياسي عن الصيغة الملائمة للروابط، لأن الأبجدية المستخدمة قد تختلف.
تحقق من الحجم قبل تخصيص الذاكرة
ضع حدًا لطول النص المقبول قبل محاولة فكه، ثم تحقق من حجم البايتات الناتجة. إذا كان المدخل كبيرًا، راجع هل يناسبه رفع ملف مباشر بدل تضمينه داخل JSON. حدود النقل والذاكرة ينبغي أن تتطابق بين الواجهة وخدمة API والتخزين، مع تجربة مدخل يتجاوز الحد في بيئة معزولة.
Base64 يحول البايتات إلى تمثيل نصي، ولا يمنح الملف حماية سرية. بعد الفك، يبقى نوع المرفق ومحتواه واسمه وصلاحية المستخدم عليه جزءًا من مسار قبول الملفات. لا تستنتج من نجاح b64decode أن الملف يصلح للعرض العام أو أن امتداده يطابق البيانات.
اختبر سلامة البايتات
جهّز نصًا عربيًا مصطنعًا وحوله إلى UTF-8، ثم Base64، ثم أعد الفك وقارن البايتات الأصلية بالناتج. هذا الفحص يساعد في فصل مشكلة الترميز النصي عن مشكلة نقل المرفق. في ملف ثنائي، قارن البصمة أو البايتات مباشرة دون محاولة تفسيرها كنص.
- مدخل سليم ينتج البايتات المتوقعة.
- أحرف دخيلة وpadding ناقص يُعالجان حسب العقد.
- حدود الحجم تُرفض برسالة مفهومة.
- خطأ الترميز لا ينشئ مرفقًا جزئيًا.
تصلح العينة عند تطوير تكامل API يربط مرفقات أوامر ERP بخدمة أخرى.




