تشخيص أخطاء Future غير المرصودة وخلل أعمار التدفق

افهم الأسباب المحتملة

• قد يكون السبب Future بلا معالج مبكر أو اعتبار unawaited مستهلكة للأخطاء أو try متزامنة لا تنتظر الفشل اللاحق أو إعادة تدفق اشتراك واحد أو بدء تنظيف دون انتظاره. قد تنهي المهلة الانتظار ويستمر العمل. حدّد مسار الملكية قبل الجزم بالسبب.

اربط كل مهمة واشتراك منشأين بمالك

حدّد عمر المستدعي ووقت بدء Future وإرفاق معالجها ومراقب إتمامها. وللتدفق سجّل نوع المصدر والاشتراك ومسار الإلغاء والمورد. استخدم مراجع اصطناعية ونتائج آمنة لا حمولات المزود الخام. إذا استمر العمل بعد الشاشة فعيّن مالكا تطبيقيا أو دائما مقصودا. تعالج unawaited شأنا تحليليا معينا، ولا تنشئ مالكا أو تستهلك الأخطاء أو تضمن الدوام بعد فقد العملية.

ضع الفشل المنتظر داخل المعالج المقصود

قد تنتهي try التي تستدعي async فقط قبل إبلاغ Future عن خطئها. انتظر داخل الحد الذي يفهمه أو استخدم سلسلة Future مملوكة صحيحة. يلتقط المثال خطأ تنسيق اصطناعيا واحدا برسالة رفض صريحة. لا تعممه لالتقاط كل Error أو لنجاح فارغ لكل فشل مزود. ولعدة Futures مستقلة راقب كل واحدة مبكرا؛ فقد يترك انتظار الأولى خطأ الأخرى بلا معالج مؤقتا. احفظ الأسباب بأمان وأظهر غموض النتيجة البعيدة.

import 'dart:async';
Future<String> fetchLabel() async {
  throw const FormatException('synthetic label');
}
Future<void> main() async {
  try {
    print(await fetchLabel());
  } on FormatException {
    print('load rejected');
  }
  print('owner finished');
}

load rejected
owner finished

افحص الاشتراك والإعادة قبل المشاركة

لا يُعاد الاستماع ببساطة لتدفق اشتراك واحد بعد استهلاكه. يوفر مصدر جديد تنفيذا مستقلا، ويشارك البث أحداثا لاحقة دون إعادة التاريخ تلقائيا. حدّد مطلب المنتج. افحص هل يفقد المتأخر تعديلا لازما أم تكفيه الحالة الحالية. وقد يسبب إيقاف المشترك تخزينا بدلا من وقف الإنتاج الفعلي. لذلك قد يستبدل التحويل الأعمى للبث خطأ واضحا بفقد خفي أو عمر مورد طويل غير متوقع.

Question: who observes a Future failure after caller return?
Required: explicit longer-lived owner and error policy
Question: should a second stream consumer repeat work or share events?
Required: fresh-source, broadcast, replay, or state contract
Question: has cancellation finished?
Required: awaited source-specific cleanup result

تحقق من الإتمام والنتيجة الخارجية منفصلين

لا توقف Future.timeout مصدرها عموما. قد تحتاج النتيجة المتأخرة حفظا أو مطابقة أو تجاهلا آمنا حسب العملية. وقد يعيد إلغاء التدفق Future تنظيف يجب انتظارها عند أهمية الإتمام. أعد في مشروع معزول الفشل اللاحق والتخلي والمستمع الثاني والبيانات المتأخرة وفشل الإلغاء بمصادر مضبوطة. افحص الحالة والآثار المسموحة لا ترتيب النداءات المطبوعة فقط. لم يشغل الدليل Dart أو شبكة أو مجدولا أو مهلة أو تنظيف مورد.

امنع تكرار المشكلة

• راجع ملكية كل استدعاء متروك واستخدام unawaited ومشاركة تدفق وإعادة بعد مهلة. حدّد النتيجة المتأخرة وغياب المستمع قبل البدائل، وأبق المعلق ظاهرا بدلا من تسمية إنشاء المهمة نجاح عمل مكتمل.