| この記事の要点 |
|
エラー内容
django.utils.datastructures.MultiValueDictKeyError: 'username'
Internal Server Error: /login
Traceback (most recent call last):
...
File "/path/to/views.py", line 25, in login_view
username = request.POST['username']
File ".../django/utils/datastructures.py", line nnn, in __getitem__
raise MultiValueDictKeyError(key)
django.utils.datastructures.MultiValueDictKeyError: 'username'
原因
Django の request.POST / request.GET は MultiValueDict という辞書ライクなオブジェクトです。Python の通常の dict と同じく ['key'] でアクセスすると、キーが存在しない場合に例外を投げます。
典型例:
# views.py
def login_view(request):
if request.method == 'POST':
# ❌ NG: 必須項目が送信されていない場合に例外
username = request.POST['username']
password = request.POST['password']
# ...
return render(request, 'login.html')
フォームが正しく送信されればキーは存在しますが、以下のケースで存在しなくなります:
- HTML フォームの
name="username"属性が無い・タイポ - JavaScript で fetch / axios 直叩きしたときにパラメータ欠落
- API テストツール (Postman / curl) で必須項目を忘れる
- 悪意のあるリクエスト(フォーム外からのアクセス)
対処1: .get() を使う(最も簡単)
def login_view(request):
if request.method == 'POST':
# ✅ OK: 存在しない場合は None
username = request.POST.get('username')
# ✅ OK: デフォルト値を指定
username = request.POST.get('username', '')
password = request.POST.get('password', '')
# 必須チェックを別途
if not username or not password:
return render(request, 'login.html', {
'error': 'ユーザー名とパスワードを入力してください'
})
# ... 認証処理
return render(request, 'login.html')
対処2: in 演算子で事前チェック
def login_view(request):
if request.method == 'POST':
if 'username' in request.POST and 'password' in request.POST:
username = request.POST['username']
password = request.POST['password']
# ...
else:
return HttpResponseBadRequest('Missing required fields')
return render(request, 'login.html')
対処3: try/except で例外捕捉
from django.utils.datastructures import MultiValueDictKeyError
def login_view(request):
if request.method == 'POST':
try:
username = request.POST['username']
password = request.POST['password']
except MultiValueDictKeyError as e:
return JsonResponse({'error': f'Missing: {e}'}, status=400)
# ...
return render(request, 'login.html')
対処4: Form クラスでバリデーション(推奨)
Django Forms を使うのが正攻法。フィールド定義と必須チェック・型変換を一元化できます:
# forms.py
from django import forms
class LoginForm(forms.Form):
username = forms.CharField(max_length=150)
password = forms.CharField(widget=forms.PasswordInput)
# views.py
from .forms import LoginForm
def login_view(request):
if request.method == 'POST':
form = LoginForm(request.POST)
if form.is_valid():
username = form.cleaned_data['username']
password = form.cleaned_data['password']
# ... 認証処理
else:
return render(request, 'login.html', {'form': form})
else:
form = LoginForm()
return render(request, 'login.html', {'form': form})
対処5: DRF (Django REST Framework) Serializer
API として作るなら DRF のシリアライザで:
from rest_framework import serializers, status
from rest_framework.response import Response
from rest_framework.decorators import api_view
class LoginSerializer(serializers.Serializer):
username = serializers.CharField(max_length=150)
password = serializers.CharField(write_only=True)
@api_view(['POST'])
def login_api(request):
serializer = LoginSerializer(data=request.data)
if serializer.is_valid():
username = serializer.validated_data['username']
password = serializer.validated_data['password']
# ... 認証処理
return Response({'success': True})
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
MultiValueDict の特殊操作
同じキーで複数の値が送られる場合(チェックボックスのリスト等)には専用メソッド:
# HTML: <input type="checkbox" name="tags" value="python">
# <input type="checkbox" name="tags" value="django">
# <input type="checkbox" name="tags" value="flask">
# 単一値(最後の値)
tag = request.POST['tags'] # → "flask"
# すべての値をリストで
tags = request.POST.getlist('tags') # → ['python', 'django', 'flask']
# 安全に取得(空リストがデフォルト)
tags = request.POST.getlist('tags', [])
HTML テンプレート側で要点を絞る
そもそもフォームの name 属性が正しいか:
<!-- ❌ NG: name 属性が無い -->
<form method="POST">
{% csrf_token %}
<input type="text">
<input type="password">
<button type="submit">ログイン</button>
</form>
<!-- ✅ OK: name 属性必須 -->
<form method="POST" action="{% url 'login' %}">
{% csrf_token %}
<input type="text" name="username" required>
<input type="password" name="password" required>
<button type="submit">ログイン</button>
</form>
関連エラー
- "403 Forbidden CSRF verification failed" — CSRF トークン不足 →
{% csrf_token %}追加 - "KeyError" (Django テンプレート側) — context dict に値が無い →
{% if var %}でガード - "AttributeError: 'NoneType' object has no attribute" — .get() で None が返って、その後で属性アクセスしている
Best Practice
- Form クラスを使う — 型変換・必須チェック・カスタムバリデーションが一元化
- 直接 request.POST にアクセスしない — 例外が出る
- テスト — フィールド未送信のケースもテストケースに含める
- APIs は DRF — Serializer で同じ思想を REST API にも適用
子ページ
子ページはありません
同階層のページ
- Invalid HTTP_HOST header: '...'. You may need to add '...' to ALLOWED_HOSTS
- CommandError: You must set settings.ALLOWED_HOSTS if DEBUG is False.
- django.utils.datastructures.MultiValueDictKeyError
- Forbidden (403) CSRF verification failed. Request aborted.
- ModuleNotFoundError: No module named 'MySQLdb'
- WARNINGS: ?: (mysql.W002) MySQL Strict Mode is not set for database connection
- Unknown column 'table_name.id' in 'field list'
- RuntimeError: Model class ~ doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS.
- get() returned more than one MynumberRegist -- it returned 2!
- django.db.utils.OperationalError: (2006, "Can't connect to MySQL server")
- 'include' is not defined
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09