Swiftのoptional型（nil）で何度も詰まった話

個人開発のバグ・タスク管理についてまとめたあと、実際にGitHub Issuesを見返してみると、圧倒的に多かったのが「optional型がらみのバグ」でした。今回は、Swiftを学び始めてから何度も痛い目にあった、optional型（nil）まわりのつまずきをまとめておきます。

1. 強制アンラップ（!）で何度もクラッシュさせた
2. if letとguard letの使い分けが分からなかった
3. オプショナルチェーン（?.）と??の組み合わせで混乱した
4. 暗黙的にアンラップされたoptional（!付きの型宣言）で油断した
まとめ

1. 強制アンラップ（!）で何度もクラッシュさせた

最初の頃、コンパイラに「optionalだから安全に使えません」と怒られるたびに、とりあえず!をつけて回避していました。

let name = userNameField.text!

これでビルドは通るのですが、実際にuserNameField.textがnilになるタイミング（画面遷移直後や、まだ何も入力されていない状態）でアプリが即クラッシュしました。「動いたからOK」と思っていたのに、特定の操作をした瞬間だけ落ちるので、原因を特定するのにかなり時間がかかりました。

!は「絶対にnilにならない」と自分で保証する記法であって、コンパイラのエラーを黙らせるための魔法の呪文ではない、と痛感しました。

2. if letとguard letの使い分けが分からなかった

次につまずいたのが、if letとguard letのどちらを使えばいいのか、という点でした。最初は雰囲気で使い分けていて、次のようなネストが深くなるコードを量産していました。

if let user = currentUser {
    if let email = user.email {
        // ここでようやく本題の処理
    }
}

これがさらに条件が増えると、インデントがどんどん右に伸びていって、読みにくいコードになっていきました。

あるとき「アンラップに失敗したら早期リターンしたい場合はguard let」と教えてもらい、書き直してみたら劇的にスッキリしました。

guard let user = currentUser, let email = user.email else {
    return
}
// ここから先はuserもemailも安全に使える

「値がある前提で処理を進めたい」場合はguard letで先に弾いておく、という考え方に切り替えてから、ネストの深さで悩むことがなくなりました。

3. オプショナルチェーン（?.）と??の組み合わせで混乱した

SwiftUIでユーザーのプロフィール画像URLを表示する処理を書いていたときのことです。

let urlString = user?.profile?.imageURL?.absoluteString ?? "default"

?.をつなげればnilの場合は自動的に処理が止まってくれる、というのは理解していたのですが、途中のprofileがnilなのかimageURLがnilなのかを区別せず「とにかくdefaultが返ってきた」という状態になり、実際にどこで値が欠けているのかデバッグに苦労しました。

今は、本当に「どこがnilでも同じ扱いでいい」場合だけこの書き方を使い、原因を特定したいときは一旦if letで1つずつ変数に取り出して確認する、というふうに使い分けるようにしています。