【保存版】Obsidian × GitHub同期でエラーに襲われた時の解決ガイド

ObsidianをPCとiPhoneで同期させる環境を構築したはずなのに、エラーが出ていませんか？

「画面いっぱいに英語のエラーメッセージが表示されてしまう」
「同期しようとすると、よくわからないエラーで拒否される」

こんな経験はありませんか？実は私もこれで最近ずっと悩まされていました。
ただこの問題の解決のめどが立ったのでまとめておこうと思います

この記事では、Obsidian同期自動化ガイドの設定後に発生しやすい、同期トラブルの解決策を解説します。参考になれば幸いです。

トラブル1：履歴のズレ

iPhoneで fast-forward: you need to merge/fetch というエラーが出ます。
GitHubへ変更を送信（Push）できません。

PCとiPhoneで別々の変更が行われたことが原因です。
iPhone側で最新の変更を取得（Pull）せずに書き始めると発生します。
履歴が枝分かれしたため、Gitが安全のために同期を止めます。

このトラブルは、履歴を「マージ（合体）」させることで解決できます。

PCを使わずスマホ（Working Copy）の操作だけでマージして解決する具体的な手順は、こちらの競合解決ガイドにて詳しく解説しています。

💡 もし「コンフリクト（衝突）」が発生しても同じ手順で直せます 履歴のズレがさらに進み、同じファイルの同じ行が衝突してしまった場合も、上記ガイドの手順でマージ・解決できます。

PCとiPhoneで設定を同期してしまうことで起きるトラブルです。
現象は2通りありますが、原因と根本的な解決策は共通しています。

iPhoneでObsidianを開くと、英語のエラーが表示されます。
unrecognized transport protocol: "ssh" というメッセージです。これが1分おきに表示され、作業に集中できません。

iPhoneでGitプラグインをオフにしても、いつの間にか有効化されます。
iPhoneを開くたびに勝手に同期が走り、エラーになります。

PCの設定ファイルが、GitHub経由でiPhoneに上書きされるためです。
PC側でGitプラグインと自動Pushを有効にしていると、その設定がiPhoneにコピーされます。
結果として、iPhone側でSSHエラーや自動同期の暴走が発生します。

PCとiPhoneで設定フォルダを分離します。これが最もスマートな根本解決策です。

これでiPhone専用の設定フォルダが作成され、PCの設定と同期されなくなります。

設定フォルダを分けることで、以下のメリットがあります。

ObsidianのGit同期エラーは、以下の2つのアプローチで解決できます。

これで解決できます。