ricono 作ったものと、詰まった箇所の記録

「保存できない」の原因がコードではなくDBだった。デプロイとマイグレーションがずれる事故

開発データベース運用

「保存できないんだけど」と言われました。

コードを見ても問題ありません。直前の変更も関係なさそう。小一時間かけて分かった原因は、コードではなくデータベースでした。

機能を追加したコードは本番に出ていたのに、その機能が使うテーブルが本番に存在しなかった。


何が起きていたか

この構成でよく起きます。

コード … GitHubにpush → 自動でデプロイされる(勝手に本番へ出る)
DB    … SQLを手で実行して反映する(誰かがやらないと何も起きない)

片方だけが自動なのが事故の元です。コードは勝手に出ていくので、DBの変更を流し忘れると、画面はあるのに土台が無い状態になります。

症状はいつもこうです。

コードが悪いように見えるので、コードを疑って時間を使います。


5分で切り分ける方法

先にDBを見ます。 コードを読むのは後です。

1. どこまで適用したかを見る

マイグレーションの適用履歴をテーブルに残していれば、一目で分かります。

select version, applied_at from schema_migrations order by version desc limit 5;

これと、リポジトリの migrations/ フォルダのファイル名を見比べます。番号がずれていたら、それが原因です。

本番:        0023 で止まっている
リポジトリ:  0025 まである
            → 0024 と 0025 が未適用

2. テーブルと列の存在を同時に確認する

REST APIが生えているDB(Supabase等)なら、これが速いです。

GET /rest/v1/テーブル名?select=列名&limit=1

テーブルと列を一度に確認できるのが便利なところです。「テーブルはあるのに列が足りない」は見落としやすく、症状も同じ「保存できない」になります。


見落としやすい罠:片方だけ流すと直らない

今回ハマったのがこれです。

0024 … テーブルを作る
0025 … そのテーブルに列を1つ足す(alter table)

一方、アプリは常にその列を送ります。

つまり 0024 だけ流すと、テーブルはできるのに保存は失敗し続けます。 「テーブルを作ったのに直らない」となって、また振り出しに戻ります。

直す前に「アプリが送る項目」と「DBにある項目」を突き合わせてください。 コードの保存処理を読んで、送っているキーを全部書き出す。それとDBの列を比べる。これをやらずに流すと、2回目の失敗をします。


流すときの注意

順番を守る

0024 → 0025 のように、古い順に流します。後のファイルが前のファイルの結果に依存しているためです。まとめて1回で流しても構いませんが、順番は変えられません。

冪等に書いておく

create table if not exists ...
alter table ... add column if not exists ...
drop constraint if exists ...

二重に実行しても壊れないように書いておくと、「流したかどうか分からない」ときに気軽に流し直せます。手作業で運用する以上、ここは必須です。

「破壊的」警告は中身を見てから

SQLエディタが「この操作はデータを変更・削除する可能性があります」と警告することがあります。文字列として drop が含まれているだけのことも多いです。

実際に今回出た警告の中身はこれでした。

文 やること データへの影響
alter column ... drop not null 制約を緩める なし
drop constraint if exists ... 制約を外して直後に貼り直す なし
on delete cascade 外部キーの将来の挙動の宣言 なし

drop table / drop column / delete / truncate が無ければ、データは消えません。警告が出たら、中身を自分で読んでから実行してください。 読まずに通すのも、読まずに止めるのも、どちらも良くありません。


再発を止める

人の記憶に頼らない形にします。

適用履歴とファイル名を機械で突き合わせて、ずれていたら知らせる。

毎朝 … schema_migrations の最大番号を取る
      migrations/ の最大番号を取る
      ずれていたら Slack に通知

「コードは出たがDBが置き去り」の状態が、翌朝には分かります。デプロイの前に見るのが理想ですが、気づける仕組みがあるだけで、小一時間が5分になります。


まとめ

自動で出ていくものと、手で流すものが混在している限り、この事故は構造的に起きます。気づける仕組みを先に作っておくほうが安上がりです。

← 記事一覧