できない.dev

Django「CSRF verification failed. Request aborted.」の原因と直し方

CSRF verification failed. Request aborted. は、Django が POST を拒否した 403 だ。
表示される理由を見て、トークンを送るか CSRF_TRUSTED_ORIGINS を見直せば直る。

公開: 更新:

症状できない
curl -s -o /dev/null -w '%{http_code}\n' -b cookies.txt -d name=dekinai http://127.0.0.1:8000/form/
403
解決後できた
curl -s -b cookies.txt -d "csrfmiddlewaretoken=nv447jRHKGdTyvPVPKAA4famDKx0a7lR&name=dekinai" http://127.0.0.1:8000/form/
ok: dekinai

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

要約

CSRF verification failed. Request aborted. は、CsrfViewMiddleware が POST などの安全でないリクエストを拒否したときの 403 だ。
DEBUG = True なら画面の「Reason given for failure:」に理由が 1 行で出る。
ログにも同じ理由が残る。

Forbidden (CSRF token missing.): /form/
Forbidden (Origin checking failed - http://localhost:3000 does not match any trusted origins.): /api/items/

CSRF token missing. / CSRF cookie not set. はトークンの受け渡し、Origin checking failed はオリジンの設定が原因だ。

実行例

トークンを出力しないフォームからの POST は CSRF cookie not set.、クッキーを受け取った後にトークンを送らない POST は CSRF token missing. になった。
CSRF_TRUSTED_ORIGINS に無いオリジンからの POST は Origin checking failed になり、どれも 403 が返った。
フォームのトークン、X-CSRFToken ヘッダ、信頼するオリジンの登録をそれぞれ足すと、どれも通った。
スキームの無い CSRF_TRUSTED_ORIGINS は、manage.py check が 4_0.E001 で止める。

$ curl -s -c cookies.txt http://127.0.0.1:8000/form/
<form method="post">
  <input name="name">
  <button type="submit">送信</button>
</form>
$ curl -s -o /dev/null -w '%{http_code}\n' -b cookies.txt -d name=dekinai http://127.0.0.1:8000/form/
403
$ tail -n 2 server.log
Forbidden (CSRF cookie not set.): /form/
[22/Oct/2026 01:16:51] "POST /form/ HTTP/1.1" 403 2855
$ curl -s -o /dev/null -c cookies.txt http://127.0.0.1:8000/form/
$ grep -c csrftoken cookies.txt
1
$ curl -s -o /dev/null -w '%{http_code}\n' -b cookies.txt -d name=dekinai http://127.0.0.1:8000/form/
403
$ tail -n 2 server.log
Forbidden (CSRF token missing.): /form/
[22/Oct/2026 01:16:52] "POST /form/ HTTP/1.1" 403 2491
$ curl -s -b cookies.txt -d "csrfmiddlewaretoken=nv447jRHKGdTyvPVPKAA4famDKx0a7lR&name=dekinai" http://127.0.0.1:8000/form/
ok: dekinai
$ curl -s -b cookies.txt -H "Content-Type: application/json" -H "X-CSRFToken: nv447jRHKGdTyvPVPKAA4famDKx0a7lR" -d '{"name":"dekinai"}' http://127.0.0.1:8000/api/items/
{"created": true}
$ curl -s -o /dev/null -w '%{http_code}\n' -b cookies.txt -H "Origin: http://localhost:3000" -H "Content-Type: application/json" -H "X-CSRFToken: nv447jRHKGdTyvPVPKAA4famDKx0a7lR" -d '{"name":"dekinai"}' http://127.0.0.1:8000/api/items/
403
$ tail -n 2 server.log
Forbidden (Origin checking failed - http://localhost:3000 does not match any trusted origins.): /api/items/
[22/Oct/2026 01:16:52] "POST /api/items/ HTTP/1.1" 403 2554
$ tail -n 1 mysite/settings.py
CSRF_TRUSTED_ORIGINS = ["http://localhost:3000"]
$ curl -s -b cookies.txt -H "Origin: http://localhost:3000" -H "Content-Type: application/json" -H "X-CSRFToken: nv447jRHKGdTyvPVPKAA4famDKx0a7lR" -d '{"name":"dekinai"}' http://127.0.0.1:8000/api/items/
{"created": true}
$ tail -n 1 mysite/settings.py
CSRF_TRUSTED_ORIGINS = ["app.example.com"]
$ python manage.py check
SystemCheckError: System check identified some issues:
 
ERRORS:
?: (4_0.E001) As of Django 4.0, the values in the CSRF_TRUSTED_ORIGINS setting must start with a scheme (usually http:// or https://) but found app.example.com. See the release notes for details.
 
System check identified 1 issue (0 silenced).
$ echo $?
1

— 2026-10-22 時点の出力

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

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

解決策

1. フォームに csrf_token を書く

<form method="post">
  {% csrf_token %}
  <button type="submit">送信</button>
</form>

ビューは render() で返し、テンプレートにリクエストを渡す。

2. fetch では X-CSRFToken ヘッダを付ける

公式ドキュメントが推奨する取得元は csrftoken クッキーだ。

function getCookie(name) {
  const m = document.cookie.match(new RegExp("(^|;\\s*)" + name + "=([^;]*)"));
  return m ? decodeURIComponent(m[2]) : null;
}
 
fetch("/api/items/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-CSRFToken": getCookie("csrftoken"),
  },
  body: JSON.stringify({ name: "dekinai" }),
  mode: "same-origin",
});

CSRF_COOKIE_HTTPONLY を有効にしている場合は JavaScript からクッキーを読めないので、ページに {% csrf_token %} を出力して DOM から値を読む。

3. 先にクッキーを発行する

トークンを出力するテンプレートを経由しない構成では、最初に開くビューに ensure_csrf_cookie を付ける。

from django.views.decorators.csrf import ensure_csrf_cookie
 
@ensure_csrf_cookie
def index(request):
    ...

4. 信頼するオリジンを設定する

別オリジンから送るなら、送信元をスキーム付きで登録する。

CSRF_TRUSTED_ORIGINS = ["http://localhost:3000", "https://app.example.com"]

HTTPS を終端するプロキシの裏で動かす場合は、プロキシが付ける X-Forwarded-Proto を Django に信頼させる方法もある。

SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")

ただし、プロキシがこのヘッダを必ず設定し、クライアントから届いた同名ヘッダを取り除く構成でない限り使ってはならないと公式ドキュメントが警告している。

5. スキームを付けて書き直す

次のエラーが出たら、値に https:// か http:// を付ける。

?: (4_0.E001) As of Django 4.0, the values in the CSRF_TRUSTED_ORIGINS setting must start with a scheme (usually http:// or https://) but found app.example.com. See the release notes for details.

旧形式の ".example.com" は "https://*.example.com" に書き換える。
@csrf_exempt で検査ごと外すと CSRF 対策そのものが無くなるので、原因を直すのが先だ。

よくある原因

  1. フォームにトークンが無い。
    POST では、CSRF クッキーに加えて csrfmiddlewaretoken フィールド(または後述の X-CSRFToken ヘッダ)が必要になる。
    テンプレートに {% csrf_token %} を書き忘れると、ほかのページで CSRF クッキーを受け取っている場合は CSRF token missing. になる。
    トークンを出力するページを 1 つも開いていなければクッキー自体が発行されないので、原因 3 と同じ CSRF cookie not set. になる(Django 5.2 で確認)。
  2. JavaScript からの POST にヘッダが無い。
    JSON を送る fetch はフォームのフィールドを持たないので、X-CSRFToken ヘッダが無いと同じエラーになる。
  3. クッキーがまだ無い。
    CSRF クッキーは get_token() が呼ばれたとき(トークンを出力するページを返したとき)に発行される。
    いきなり POST すると CSRF cookie not set. になる。
  4. Origin が Host と一致しない。
    Django 4.0 以降は Origin ヘッダを Host と CSRF_TRUSTED_ORIGINS に照合する。
    http://localhost:3000 の開発サーバから localhost:8000 の Django へ送る場合や、HTTPS を終端したプロキシが HTTP で Django に転送する場合(Origin は https://、Django 側は http:// と判断する)に一致しない。
  5. CSRF_TRUSTED_ORIGINS にスキームが無い。
    Django 4.0 で値の形式が変わり、ホスト名だけを書くとシステムチェックで起動が止まる。