Raspberry Pi ImagerのWi-Fi周りの挙動がおかしい

こんにちは、たねやつです。

久々の更新ですが、またいろいろとやりたいことが出来たので更新していきます。今回はRaspberry Pi ImagerでOSを書き込む際にWi-Fi設定をしたにもかかわらず、初回起動時に全く繋がらない…という問題に遭遇した話です。

結論から言うと、デスクトップ環境を起動してGUIからWi-Fiを設定し直すことで解決しました。この記事では、同様の問題に遭遇した方向けに、原因の調査と具体的な回避策を備忘録として残しておきます。

今回、別の用途でRaspberry Pi 5を新調しました！表面実装の部品が増えていたり電源回りがかなり厄介なことになってたりしますが、新しいものというのはいいですね。

まずは公式サイトからRaspberry Pi Imagerをダウンロードし、Raspberry Pi OS (64-bit)を選択。 OSのカスタマイズ設定で、ホスト名やSSH公開鍵の設定と合わせて、Wi-Fiの設定（SSIDとパスワード）を行いました。

しかし、書き込み後にRaspberry Piを起動しても、Wi-Fiに接続される気配がありません。。。

設定は間違っていないはずなのに、なぜ…

こういう時は、同じ問題で困っている人がいないか探すのが定石です。 Raspberry Pi ImagerのGitHubリポジトリでIssueを検索してみると、案の定、同様の報告がいくつか見つかりました。

これらのIssueを読み解くと、原因は一つではないようですが、主に以下の点が挙げられていました。

OSの仕様変更: Raspberry Pi OS "Bookworm"から、ネットワーク管理が従来の/etc/wpa_supplicant/wpa_supplicant.confを使う方法からNetworkManagerに移行したことによる影響。
Imagerのバグ: Imagerが生成する初回起動用のスクリプト(firstrun.sh)に、改行コードが余分に含まれるなどの構文エラーがあり、Wi-Fi設定が正しく実行されないことがある。
特殊文字: SSIDやパスワードに特定の特殊文字が含まれていると、設定が失敗するケースがある。

どうやら、Imagerが良かれと思ってやってくれているOSカスタマイズ機能が、OS側の変更に追いついていなかったり、バグを踏んだりすることがあるようです。

Issueで提案されていた回避策はいくつかありました。

有線LANで起動する: 最も確実な方法です。一度有線で起動し、その後にraspi-configやデスクトップ環境からWi-Fiを設定します。
デスクトップ環境から設定する: 今回私が採用した方法です。モニターとマウス・キーボードを接続してデスクトップを起動し、画面右上のネットワークアイコンからWi-Fiに接続しました。一度接続すれば、設定は保存されます。