Swift Actorによるスレッドセーフな永続化

抽出日: 2026-02-05 コンテキスト: async/awaitを使用したスレッドセーフなデータ永続化が必要なiOS/Swiftアプリ

---

課題

データ永続化レイヤーは、アプリの複数の部分が同時に読み書きする際にレースコンディションに直面することが多い。従来のアプローチ（DispatchQueues、ロック）はエラーが発生しやすく、冗長になりがち。

---

解決策

Swift actorを使用して、すべての永続化状態と操作を分離する。actorモデルは以下を保証します：

• データ競合なし（コンパイラによる強制）
• アクセスの自動シリアライズ
• 構造化並行性と統合されたasyncファーストAPI

public actor LocalRepository {
    private var cache: [String: Record] = [:]
    private let cacheFileURL: URL

    public init(directory: URL = .documentsDirectory) {
        self.cacheFileURL = directory.appendingPathComponent("cache.json")
        // Synchronous cache load during init (actor isolation not yet active)
        self.cache = Self.loadCacheSynchronously(from: cacheFileURL)
    }

    public func save(_ record: Record) throws {
        cache[record.id] = record
        try persistToFile()
    }

    public func loadAll() -> [Record] {
        Array(cache.values)
    }

    public func find(by id: String) -> Record? {
        cache[id]
    }

    private func persistToFile() throws {
        let data = try JSONEncoder().encode(Array(cache.values))
        try data.write(to: cacheFileURL)
    }

    private static func loadCacheSynchronously(from url: URL) -> [String: Record] {
        guard let data = try? Data(contentsOf: url),
              let records = try? JSONDecoder().decode([Record].self, from: data) else {
            return [:]
        }
        return Dictionary(uniqueKeysWithValues: records.map { ($0.id, $0) })
    }
}

---

主要パターン

1. インメモリキャッシュ + ファイル永続化: キャッシュからの高速読み取り、ディスクへの永続書き込み
2. 同期的な初期化読み込み: 非同期初期化の複雑さを回避
3. Dictionary型によるキー管理: IDによるO(1)の検索
4. プライベートな永続化: 外部呼び出し元はドメイン操作のみを参照

---

使用方法

let repository = LocalRepository()

// All calls are async due to actor isolation
let records = await repository.loadAll()
try await repository.save(newRecord)
let found = await repository.find(by: "question-1")

---

使用すべき場面

• Swift 5.5以降でデータ永続化レイヤーを構築する場合
• 共有状態へのスレッドセーフなアクセスが必要な場合
• 手動同期（ロック、キュー）を避けたい場合
• ローカルストレージを使用したオフラインファーストアプリを構築する場合

---

関連パターン

• UIバインディング用に@Observable ViewModelと組み合わせる
• actor境界を越えるデータにはSendable型を使用する
• クラウド同期操作にはFileBasedSyncManager actorを検討する