回数を増やしても直らないなら、待ち方の問題ではない — テストの中で永遠に完了しない Future

/// 直前の操作の完了。公開系の操作すべてがここに並ぶ。
Future<void> _pending = Future<void>.value();
 
Future<T> _serialized<T>(Future<T> Function() action) {
  final done = Completer<void>();   // 自分の完了を知らせる札を1枚発行する
  final previous = _pending;        // 今 列の最後尾に並んでいる人の札
  _pending = done.future;           // 最後尾を自分に差し替える（次の人はこれを待つ）
  // 前の人が終わってから action() を流し、終わったら自分の札を「完了」にする
  return previous.then((_) => action()).whenComplete(() => done.complete());
}

testWidgets('画面に入ると1回だけ突き合わせる', (tester) async {
  await pumpHost(tester, triggerOnEnter: true);  // テスト用の手伝い関数。「入ったら突き合わせる」設定の画面をログイン済みで実際に描き、pumpAndSettle を1回かけて待つ
 
  // expect(調べたい値, 期待する結果) の形で書く
  expect(sync.fetchCalls, 1);  // fetchCalls が 1 であることを期待
});

Future<void> _pending = Future<void>.value();

setUp(() {   // 各テストの直前に毎回走る準備処理
  db = AppDatabase(NativeDatabase.memory());
  runner = AutoReconcileRunner(
    coordinator: SyncCoordinator(db: db, /* ... */),   // ← ここで new される
  );
});
 
testWidgets('画面に入ると1回だけ突き合わせる', (tester) async {
  // ← テスト本体はここ
});

/// null は「列が空」。Future.value() で初期化しないこと（これは仕様）。
/// フィールド初期化子はコンストラクタが呼ばれたゾーンで走るので、widget test では
/// setUp（fake-async の外）で作られた Future をテスト本体（fake-async の中）で
/// await することになり、完了する機会が二度と来ない＝同期が丸ごと止まる。
Future<void>? _pending;
 
Future<T> _serialized<T>(Future<T> Function() action) {
  final previous = _pending;
  final done = Completer<void>();
  _pending = done.future;
 
  final result = previous == null ? action() : previous.then((_) => action());
  return result.whenComplete(() => done.complete());
}