できない.dev

Django で「no such table」が出てモデルのテーブルを参照できない

OperationalError: no such table は、モデルに対応するテーブルがデータベースにまだ作られていないときに出る。
makemigrations でマイグレーションを作り migrate で適用する 2 段階のどちらかが抜けていることがほとんどだ。

公開: 更新:

症状できない · exit 1
python list_posts.py
django.db.utils.OperationalError: no such table: blog_post
解決後できた · exit 0
python list_posts.py
[]

2026-10-23 に python:3.12(Django 5.2.18) で実際に打って取った出力。検証環境の詳細

要約

Django の ORM は、モデルを定義しただけではテーブルを作らない。
変更をファイルに書き出す makemigrations と、それを適用する migrate のどちらかが抜けると、クエリの実行時に次のエラーになる。

django.db.utils.OperationalError: no such table: blog_post

テーブル名は既定で アプリ名_モデル名 の小文字になる。
文言は SQLite のもので、他のデータベースでは表現が変わるが原因は同じだ。

実行例

python:3.12 のコンテナに Django 5.2.18 を入れ、blog アプリに Post モデルを置いて試した。
アプリを INSTALLED_APPS に入れる前の makemigrations は、No changes detected を返した。
登録後に migrate だけ実行してモデルを読むと、no such table: blog_post で終了コード 1 になった。
makemigrations と migrate を続けると、終了コード 0 で通った。
フィールドを足したあと makemigrations を忘れた場合の no such column も、同じ手順で直った。
トレースバックは最終行だけを載せている。

$ python manage.py makemigrations
No changes detected
$ python list_posts.py
django.db.utils.OperationalError: no such table: blog_post
$ echo $?
1
$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  No migrations to apply.
  Your models in app(s): 'blog' have changes that are not yet reflected in a migration, and so won't be applied.
  Run 'manage.py makemigrations' to make new migrations, and then re-run 'manage.py migrate' to apply them.
$ python manage.py showmigrations blog
blog
 (no migrations)
$ python manage.py makemigrations blog
Migrations for 'blog':
  blog/migrations/0001_initial.py
    + Create model Post
$ python manage.py showmigrations blog
blog
 [ ] 0001_initial
$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, blog, contenttypes, sessions
Running migrations:
  Applying blog.0001_initial... OK
$ python list_posts.py
[]
$ echo $?
0
$ python list_posts.py
django.db.utils.OperationalError: no such column: blog_post.body
$ echo $?
1
$ python manage.py makemigrations blog
Migrations for 'blog':
  blog/migrations/0002_post_body.py
    + Add field body to post
$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, blog, contenttypes, sessions
Running migrations:
  Applying blog.0002_post_body... OK
$ python list_posts.py
[{'id': 1, 'title': 'hello', 'body': ''}]
$ echo $?
0

— 2026-10-23 時点の出力

検証環境Python 3.12.15 / Git 2.47.3 / Django 5.2.18 / 2026-10-23 検証
検証日
実行環境
python:3.12 Debian GNU/Linux 13 (trixie)
バージョン
  • Python 3.12.15
  • Git 2.47.3
  • Django 5.2.18

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. マイグレーションを作って適用する

python manage.py makemigrations blog
python manage.py migrate

makemigrations が blog/migrations/0001_initial.py を作り、migrate が適用すればテーブルができる。
モデルを変更するたびに、この 2 つをセットで実行する。
フィールドを足しただけのときも省略しない。

2. INSTALLED_APPS に追加する

No changes detected と出たら、アプリが登録されているかを確認する。

# settings.py
INSTALLED_APPS = [
    "blog.apps.BlogConfig",
    "django.contrib.admin",
    "django.contrib.auth",
    # ...
]

登録を忘れたままモデルを import すると、Model class blog.models.Post doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS. という RuntimeError になることもある。

3. 適用状況を確認する

showmigrations は、適用済みのマイグレーションに [X] を付けて一覧表示する。

python manage.py showmigrations blog
blog
 [ ] 0001_initial

[ ] なら migrate を、(no migrations) なら手順 1 を実行する。
Docker Compose では、アプリが接続するコンテナで実行する。

docker compose exec web python manage.py migrate

migrate --fake は SQL を実行せずに適用済みの印だけを付けるので、この問題の解決には使わない。

4. マイグレーションファイルをコミットする

makemigrations が作ったファイルは、モデルのコードと同じコミットに含める。

git add blog/migrations/
git commit -m "blog: Post モデルを追加"

公式ドキュメントは、マイグレーションを開発環境で一度作り、同じものを他の環境や本番で適用する流れを示している。
クローンした環境では共有されたファイルに対して migrate を実行する。

よくある原因

  1. マイグレーションを作っていない。
    migrate だけを実行すると、admin や auth など Django 同梱アプリのテーブルは作られるが、自分のアプリのテーブルは作られない。
    適用するマイグレーションが残っていない状態で migrate を実行すると、警告が出る。
    文言は「Your models in app(s): 'blog' have changes that are not yet reflected in a migration, and so won't be applied.」である。
  2. INSTALLED_APPS に登録していない。
    登録していないアプリのモデルは Django から見えないので、makemigrations は No changes detected を返して何も作らない。
  3. migrate を実行していないか、対象のデータベースが違う。
    マイグレーションファイルがあっても、適用するまでテーブルは無い。
    別のコンテナで実行した、環境変数で DATABASES の接続先が変わっている、といった場合は適用先が食い違う。
  4. フィールドの追加をマイグレーションしていない。
    この場合は no such column: blog_post.body になるが、原因と直し方は同じだ。
  5. マイグレーションファイルを共有していない。
    マイグレーションファイルはアプリのコードと一緒に配布する前提のものだ。
    .gitignore で除外すると、クローンした環境ではテーブルが作られない。