api

カテゴリー: FastAPI

  • SQLite + Alembic 「no such column」「duplicate column name」の解決法

    FastAPI + SQLAlchemy + Alembic を使って開発中のエラー。備忘録がてらブログに残しておきます。

    エラーその1: no such column

    API 実行時に以下のエラーが出ました。

    sqlalchemy.exc.OperationalError: (sqlite3.OperationalError) no such column: sakes.created_by_id

    テーブル sakes に必要なカラム created_by_id が存在していません。

    モデルでは定義しているのに DB に反映されていない状態です。

    エラーその2: duplicate column name

    Alembic でマイグレーションを流そうとすると、今度はこんなエラー。

    sqlite3.OperationalError: duplicate column name: password

    既に users テーブルに password カラムがあるのに、再度追加しようとして失敗しています。

    要するに「DB と Alembic の履歴がズレている」状態。

    解決手順

    1. Alembic 履歴を DB に合わせる

    既に存在しているカラムについては、DB に合わせて履歴を進めるだけでOK。

    poetry run alembic stamp 3ed4e13e6b65

    これで「password はもうあるよ」と Alembic に教えました。

    2. 新しいカラムを追加するマイグレーションを作成

    不足していた sakes.created_by_id を追加するためのリビジョンを作成。

    poetry run alembic revision -m "add created_by_id to sakes"

    生成されたファイルに処理を追記：

    def upgrade() -> None:
    with op.batch_alter_table("sakes") as batch:
        batch.add_column(sa.Column("created_by_id", sa.Integer(), nullable=True))
        batch.create_index("ix_sakes_created_by_id", ["created_by_id"])

    そして適用！

    poetry run alembic upgrade head

    3. 確認

    sqlite3 ochoko.db "PRAGMA table_info(sakes);"

    ちゃんと created_by_id が入っているのを確認。

    API を再実行したら 500 エラーが消えました 🎉