NoneType object is not subscriptableの直し方

TypeError: 'NoneType' object is not subscriptable は、None に対して [ ]（添字・キー）を使ったときのエラーです。 x["name"] や x[0] の x が、辞書やリストではなく None になっています。

直し方は2つの手順です。

確認環境：Python 3.10・3.11・3.12・3.13、mypy 2.4.0（確認日 2026年10月10日）。以下のエラーはすべて、この4つの版で同じメッセージになりました。

None になる典型6パターン

1. return の無い関数

def find_user(uid):
    users = {1: {"name": "佐藤"}}
    if uid in users:
        return users[uid]
    # 見つからないときは何も return しない → None が返る

print(find_user(2)["name"])
# TypeError: 'NoneType' object is not subscriptable

Python の関数は、return を通らずに終わると None を返します。「見つからない」ときにどうするかを決めます。

def user_name(uid: int) -> str:
    user = find_user(uid)
    if user is None:
        raise LookupError(f"ユーザーが見つかりません: uid={uid}")
    return user["name"]

LookupError: ユーザーが見つかりません: uid=2      ← 原因が分かるエラーになる

2. list.sort() の結果を代入している

nums = [3, 1, 2]
nums = nums.sort()     # sort() はリストそのものを並べ替えて None を返す
print(nums[0])         # TypeError: 'NoneType' object is not subscriptable

list.reverse()・list.append()・dict.update() なども、同じく None を返します。

3. dict.get でキーが無い

cfg = {"db": {"host": "localhost"}}
print(cfg.get("cache")["ttl"])     # "cache" が無い → None["ttl"]

ttl = cfg.get("cache", {}).get("ttl", 60)   # 無いときの値を決めておく

4. re.match が一致しない

import re
m = re.match(r"(\d{3})-(\d{4})", "〒060-0001")
print(m[1])     # TypeError: 'NoneType' object is not subscriptable

re.match は文字列の先頭から一致を調べます。 先頭が「〒」なので一致せず、None になりました。途中から探すなら re.search です。どちらも、一致しなければ None を返すので判定します。

def zip_code(text: str) -> str | None:
    m = re.search(r"(\d{3})-(\d{4})", text)
    if m is None:
        return None
    return m[1] + m[2]

print(zip_code("〒060-0001"), zip_code("郵便番号なし"))
# 0600001 None

5. DB の検索が0件

row = cur.execute("SELECT name FROM users WHERE id = ?", (9,)).fetchone()
print(row[0])     # 0件なら row は None

row = cur.execute("SELECT name FROM users WHERE id = ?", (9,)).fetchone()
if row is None:
    ...           # 0件のときの処理
else:
    name = row[0]

6. JSON の null

import json
data = json.loads('{"result": null}')
print(data["result"]["items"])     # null は None になる

API の応答で、エラーのときや0件のときに null が返る項目は、判定してから使います。

どの値が None かを見つける：トレースバックの ^

res["data"]["user"]["address"]["city"] のように1行に何段もあると、どこが None か分かりません。Python 3.11 以降は、トレースバックに印が付きます。

== Python 3.10
    city = res["data"]["user"]["address"]["city"]
TypeError: 'NoneType' object is not subscriptable

== Python 3.13
    city = res["data"]["user"]["address"]["city"]
           ~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
TypeError: 'NoneType' object is not subscriptable

~~~ の部分（res["data"]["user"]）が None で、^^^ の部分（["address"]）を使おうとして失敗した、という意味です。この印は Python 3.11 で加わりました（公式の「What's New In Python 3.11」）。3.10 以前では、1段ずつ変数に分けるか、print で確かめます。

似たエラーとの見分け方

None に対して何をしようとしたかで、メッセージが変わります。どれも原因は「None が入っている」で、直し方は同じです。

None の判定は is None で書く

if user is None:     # None かどうか
    ...
if not user:         # None のほか、{}・[]・""・0 も「偽」になる
    ...

bool(0)・bool("")・bool([]) はどれも False です。0件のリストや数値の 0 を「無い」と区別したいときは、if not x: ではなく if x is None: で書きます。

「とりあえず or {} を付けて止める」書き方は、エラーは消えますが、本来は来るはずのデータが来ていない不具合を隠すことがあります。None がありうる仕様なのか、来てはいけないのかを決めてから書きます。

実行する前に見つける：型ヒントと mypy

戻り値が None になりうる関数に型ヒント（-> X | None）を付けておくと、mypy が実行する前に指摘します。

import re

def find_user(uid: int) -> dict[str, str] | None:
    users = {1: {"name": "佐藤"}}
    return users.get(uid)

def zip_code(text: str) -> str:
    m = re.match(r"(\d{3})-(\d{4})", text)
    return m[1] + m[2]

def user_name(uid: int) -> str:
    return find_user(uid)["name"]

def sorted_nums() -> int:
    nums = [3, 1, 2]
    nums = nums.sort()
    return nums[0]

$ mypy typed.py
typed.py:9: error: Value of type "Match[str] | None" is not indexable  [index]
typed.py:12: error: Value of type "dict[str, str] | None" is not indexable  [index]
typed.py:16: error: Incompatible types in assignment (expression has type "None", variable has type "list[int]")  [assignment]
Found 3 errors in 1 file (checked 1 source file)

re.match・自作の関数・list.sort() の3つとも、実行前に見つかりました。 上の「直し方」のように if ... is None: で分けて書き直すと、Success: no issues found になりました。標準ライブラリの re.match や dict.get には、最初から「None を返しうる」型が付いています。

確認の手順（チェックリスト）

よくある質問

Q. try / except TypeError で囲めば直りますか。 A. エラーは止まりますが、None になった原因はそのまま残り、別の場所で同じ問題が起きます。None がありうる場所で if x is None: と判定するほうが、何が起きたかが分かります。

Q. pandas や Django でも出ますか。 A. 出ます。メッセージの意味は同じで、None に [ ] を使っています。トレースバックの最後の自分のコードの行から、None になった値を探します。

まとめ

• None に [ ] を使ったエラー。どの値が None かを特定して、なぜ None になったかを直す
• 典型は return の無い関数・x = x.sort()・dict.get・re.match・fetchone() の0件・JSON の null
• Python 3.11 以降は、トレースバックの ~~~^^^ で None の場所が分かる
• has no attribute・not iterable・no len() も同じ原因
• 判定は if x is None:。if not x: は 0 や空のリストも含む
• 型ヒントと mypy で、実行前に見つけられる

参考・出典

確認日はいずれも 2026年10月10日です。

• Python ドキュメント「What's New In Python 3.11」（PEP 657: Fine-grained error locations in tracebacks）：https://docs.python.org/3/whatsnew/3.11.html

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。