---
title: "LazyVStackの行高推定が収束せずCPU100%でハングしたのでしきい値でVStackに切り替えた"
description: "Vigilareで一部の環境だけ再現するCPU100%ハングを、実機のCPUサンプルをもとに仮説をひとつずつ検証しながら追い詰めました。行き着いた先はSwiftUIのLazyVStackが不均一な行の高さを推定する処理が収束しなくなるというフレームワーク側の挙動で、行数にしきい値を設けてVStackへ切り替える形で回避しています。"
category: "Apple"
tags: ["macOS","SwiftUI","Vigilare","Performance"]
publishedAt: "2026-07-14"
lastmod: "2026-07-14"
---

Vigilareで、特定の環境だけで再現するCPU100%のハングを調査しました。実機で採取したCPUサンプルをもとに仮説をひとつずつ検証して外していった結果、たどり着いたのはSwiftUIの`LazyVStack`が不均一な行の高さを推定する処理が収束しなくなる、フレームワーク側の挙動でした。行数にしきい値を設けて`VStack`へ切り替えることで、実運用での再現は止まっています。

::card[https://vigilare.labee.dev/]

同じ画面では数日前にも`LazyVStack`起因のハングを直しています。そのときの原因は`ForEach`に渡す配列を毎回作り直していたことで、今回はその修正が入った状態から始まった別の不具合です。

::card[https://labee.jp/posts/vigilare-swiftui-hang-live-sample]

macOSとiOSでコードを共有している構成については別記事で扱っています。

::card[https://labee.jp/posts/vigilare-kit-shared-domain]

## 一覧の表示件数は数十件なのにCPU100%で固まる

[Vigilare](https://vigilare.labee.dev/)はApple Remindersと同期するタスク管理アプリです。あるMacで、Todayタブの表示件数はせいぜい数十件しかないのに、そこでスクロールしようとするとCPU使用率が100%に張り付いて、10分待っても復帰しないという報告が入りました。手元の環境では再現しません。

再現するMacはリマインダーの総数が数千件規模、再現しない手元の環境は総数が少なめでした。表示件数ではなく保持している総件数に依存していそうだ、というのが最初の見立てです。

## 総件数が原因なら計算量で説明できるはずという前提から始めた

リストの切り替えやアプリ起動時に走る処理を洗い出し、それぞれの計算量を見積もりました。フィルター適用、ソート、グルーピング、キャッシュされたビューモデルの再構築のいずれも、保持している総件数に対して線形の処理で、2乗に比例するような項は見当たりません。数千件規模なら最悪でも数百ミリ秒のオーダーで収まる計算です。

10分待っても復帰しないという症状は、この見積もりでは説明がつきません。計算が重いのではなく、収束しない何かが起きていると見方を変えました。この時点で「総件数が多いと遅い」ではなく「何かが無限に繰り返されている」という方向に疑いを移しています。

## 実機のCPUサンプルとA/B検証で仮説をひとつずつ外していった

ハング中に`sample`コマンドで採取したスタックトレースを解析しながら、思いついた仮説を順番に潰していきました。

| 仮説 | 検証方法 | 結果 |
|---|---|---|
| 設定読み込みのたびに全件JSONデコードしている処理が重い | オンメモリでベンチマーク | 実装として無駄ではあるが、件数差による増分は数十ミリ秒程度で、10分以上のハングの説明にならない |
| 行の背景色を塗る`.background()`修飾子がSafeAreaInsetsの再帰解決を誘発している | 該当箇所を3パターンの実装に差し替えて実機検証 | 3回とも指標が変化せず、後のダンプでは経路自体が出現しないケースもあり否定 |
| グループを識別する型が`Equatable`に準拠しておらず差分検出が効いていない | `Equatable`準拠を追加して実機検証 | 効果なし |
| サイドバー側の`ForEach`がレイアウトのたびに新しい配列を作っている | サイドバーを表示しないレイアウトでも再現するかを確認 | サイドバー非表示でも再現し、無関係と判明 |
| Microsoft Defenderとの相性 | プロセスごとの統計を取得して確認 | 該当プロセスの記録が統計に一切出現せず否定 |
| ウィンドウ幅の判定としきい値の間でレイアウトが往復している | しきい値をまたぐ操作を繰り返して確認 | ローカルでは再現せず |

いずれも「直しても症状が変わらない」という否定的な結果でした。当てずっぽうに直しては実機で確認する、を繰り返すコストは高く、途中から実機ダンプそのものをもっと正確に読む方向に切り替えています。

## ハング中だけを切り出したCPUサンプルが単一の経路を示した

それまでのダンプは、リスト切り替えやスクロール操作の過程も含めて採取していたため、複数の要因が混ざって見えていました。デバッガーをアタッチした状態で、ハングが発生した後だけを狙ってサンプルを採取し直したところ、結果は大きく変わりました。

メインスレッドの数千サンプルすべてが、分岐のない単一の呼び出し列を指していました。最終到達点も全サンプルで完全に同一です。

```text
GraphHost.flushTransactions()
  → GraphHost.runTransaction
    → AG::Subgraph::update
      → ViewLayoutEngine.update(layout:context:children:)
        → HVStack.updateCache(_:subviews:)
          → StackLayout.makeChildren()
            → LayoutEngine.layoutPriority()  ← 全サンプルがここ
```

自社コードのフレームは一度も現れません。純粋にSwiftUI内部のスタックレイアウト処理だけが、同じ場所を指し続けていました。重い処理が続いているのではなく、同じ処理が終わらずに繰り返されていることが、この1枚で裏付けられた形です。

## 症状の型が一致する公開の不具合報告

このスタックの型と一致する公開報告を探すと、[cmuxリポジトリのIssue](https://github.com/manaflow-ai/cmux/issues/2327)がほぼ同じ経路（`LazySubviewPlacements.placeSubviews`から`LazyStack.place`、`ForEachState.forEachItem`と続く経路）を報告していました。ただしcmux側の根本原因のひとつは「レイアウトのたびに`Array(...)`を新規生成し、個々の要素IDは安定していてもコレクション自体の同一性が壊れている」ことで、Vigilareの該当コードはもともとキャッシュ済みの配列を`ForEach`に渡しており、この原因はそのまま当てはまりません。一致していたのはスタックの型だけで、引き金は別ということです。

Apple Developer Forumsにも近い症状の報告があります。ネストした`LazyVStack`とアクセシビリティ機能の組み合わせでハングする[スレッド](https://developer.apple.com/forums/thread/814208)では、Apple DTSのエンジニアが「`LazyVStack`はビューを必要になったタイミングで確保するが、その最中に状態変化が起きるとレースコンディションになる」と回答し、Feedback番号が発行されています。`ScrollView`内の`LazyHStack`で深刻なハングが起きる[別のスレッド](https://developer.apple.com/forums/thread/778753)でも、DTSが「Feedbackを起票してほしい」と回答するにとどまり、公式な原因説明は出ていません。いずれもVigilareで踏んだものと完全に同じ不具合ではありませんが、LazyVStackまわりで処理が収束しなくなる問題が、Apple社内でも把握されている領域であることが伝わってきます。

## 行数のしきい値でLazyVStackを迂回する

`LazyVStack`は表示されていない行の高さを、実測済みの行から推定して埋めます。行の高さが不均一だと、この推定と`ScrollView`側のコンテンツサイズ確定が噛み合わず、再計算が再計算を呼ぶ形になっているというのが、ここまでの調査から立てた説明です。

![行の高さが不均一なリストで、実測済みの行から未表示行の高さを推定し、その推定を前提にScrollViewのコンテンツサイズが決まり、レイアウトが再計算され、実測値が変わってまた推定をやり直す、という一周が閉じる。調査から立てた説明であり、Apple公式の原因説明が出ているわけではない](/images/posts/vigilare-lazyvstack-scroll-hang/height-estimation-loop.svg)

表示件数が数十行程度のリストは、`LazyVStack`の遅延読み込みで得るものがほとんどありません。そこで、行数がしきい値以下のときは高さ推定を持たない`VStack`で描画し、本当に件数の多いリストだけ`LazyVStack`を使う方式に変えました。

```swift
public enum ReminderListLayoutPolicy {
  public static let lazyThreshold = 300

  public static func usesLazyLayout(rowCount: Int) -> Bool {
    rowCount > lazyThreshold
  }
}
```

適用した直後の実機検証では、ハングが解消しませんでした。原因は行数の数え方にありました。折りたたまれた状態のグループも含めて総行数を数えていたため、完了済み・却下済みのリマインダーが数千件畳まれている環境では、実際に表示されている行が20行程度でもしきい値を超えて`LazyVStack`のままだったのです。

畳まれているグループは、そもそも`ForEach`自体が構築されないので描画コストがかかりません。そこで、数える対象を展開されているグループの行だけに絞り直しました。

```swift
private var mountedRowCount: Int {
  groups.reduce(0) { $0 + (expandedKeys.contains($1.key) ? $1.reminders.count : 0) }
}
```

同じデータ・同じ環境のまま、コンテナの型だけを切り替えたこの修正で、通常利用でのハングは再現しなくなりました。表示内容と環境をそろえたままコンテナだけを変えて症状が消えたことは、`LazyVStack`が発生の必要条件だったことの実践的な裏付けにもなっています。

## 巨大なグループを展開すると経路が戻ってくる

しきい値方式には、まだ境界となるケースが残っています。畳まれているグループを実際に展開してしきい値を超えると、その時点で`LazyVStack`に切り替わり、同じ経路が復活し得ます。展開はユーザーの操作で起きる一度きりのイベントで、バックグラウンドで無限に繰り返されるわけではないため、当面は許容範囲としています。

恒久的には、グループというコンテナ分岐そのものをやめて、行の種類を1本の配列にまとめたうえで表示件数に上限を設け、どんな状態でも`LazyVStack`を使わない構成にする案を検討中です。実装はまだで、まずは現行のしきい値方式を一定期間運用して再発がないことを確認してから着手します。

自社コードのフレームがどのダンプにも一度も現れなかったこと、条件をそろえた検証用アプリでも同じ停止が再現できたことから、SwiftUI側へのフィードバック報告も準備しています。こちらもまだ提出前の段階です。