BLOG / schema-valid-but-not-published-ready.mdx
مخطط صحيح لكن النشر غير جاهز: عشرة أخطاء في تسليم SKU.md
تشخيص عشرة أعطال دقيقة بين نجاح المخطط محليا وصحة مورد SKU.md العام، مع مسار إصلاح حتمي.
يجيب نجاح المخطط عن البنية المحلية فقط. وقد يقدم المورد العام عنوانا أو حالة أو نوع MIME أو بايتات أو رابطا أساسيا أو رسما خاطئا.
SKU.md هي طبقة يستضيفها التاجر بنفسه لاكتشاف المنتجات ومعرفة المنتجات المستقرة. وهي تساعد الوكلاء على العثور على المنتجات وفهم الحقائق المسندة إلى مصادر ومعرفة المكان الذي ينبغي فيه إعادة التحقق من بيانات التجارة الحية. وليست بروتوكول Checkout جديدا.
أخطاء التسليم العشرة
| الرقم | العطل | الفحص الحتمي |
|---|---|---|
| 1 | حالة خاطئة | اشترط HTTP 200 بالضبط |
| 2 | إعادة توجيه | عطل اتباع التحويل وتحقق من العنوان المطلوب |
| 3 | نوع MIME خاطئ |
اشترط text/markdown بمعاملات اختيارية صحيحة |
| 4 | استجابة بديلة لينة | ارفض HTML أو بايتات الصفحة الرئيسية |
| 5 | رابط أساسي خاطئ أو مفقود | طابق البيانات الوصفية الافتتاحية مع عنوان الطلب |
| 6 | اختلاف المتن أو المشتقات | قارن البايتات والحقول المقبولة |
| 7 | روابط معطلة | اجلب الموارد الإلزامية بأمان |
| 8 | رابط المستند الأب أو الاكتشاف معطل | تتبع الرسم من /sku.md |
| 9 | إصدار خاطئ | اشترط sku.md/0.10-draft والمخطط المقصود |
| 10 | تخطي الفحص الحي | شغل published_resource وdocument_graph |
مسار استكشاف العطل
- اطلب عنوان
HTTPSالدقيق من دون اتباع تحويل. - افحص
HTTPونوعMIMEوتطابق البايتات. - طابق الرابط الأساسي والإصدار والهوية والمتن.
- تتبع الروابط الإلزامية وسلسلة المستندات الآباء.
- تأكد من أن المسار المجهول يعيد
404بالضبط. - امسح ذاكرة شبكة
CDNوأعد الفحص مع حفظ الأدلة.
لماذا تفوت الفحوص المحلية هذه المشكلات
قد تكون الصفحة المقروءة عرض HTML للتوافق، وقد يقدم نشر ناجح بيانات قديمة من ذاكرة التخزين المؤقت، ولا يثبت عنوان منتج واحد بيان الفهرس الجذري أو المستندات الشقيقة. حتى HTTP 200 لا يفيد إن أعاد الخادم الصفحة الرئيسية بنوع MIME خاطئ. لذلك يجب أن يغطي عقد المورد الحالات الإيجابية والسلبية.
أصلح مع الاحتفاظ بآخر نسخة صالحة
احتفظ أولا بآخر مستند مقبول، وأصلح المسار أو الترويسات في بيئة منفصلة، ثم استبدل المورد. لا تخف العطل بتحويل ولا تغير الرابط الأساسي لمجرد اجتياز الاختبار. وبعد الإصلاح أعد فحص offline_document وpublished_resource وdocument_graph كلها بالرجوع إلى مواصفة v0.10.
قراءة إضافية
طبق دليل النشر الدقيق وفصل البيانات الحية.