できない.dev

Python「'NoneType' object has no attribute」の原因と直し方

'NoneType' object has no attribute は、None に属性アクセスすると出る。
直前の戻り値が None でないか確かめ、is None で早期に弾けば直る。
append の戻り値の代入が典型だ。

公開: 更新:

症状できない · exit 1
python bad.py
Traceback (most recent call last):
  File "/tmp/tmp.fmL5tVAJea/bad.py", line 4, in <module>
    print(items.pop())
          ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'pop'

2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細

要約

'NoneType' object has no attribute 'xxx' は、None に対して属性アクセスした ことを示す。
直前のメソッド呼び出しや関数の戻り値が想定と違って None になっていないかを最初に疑う。
is None で早期判定するか、そもそも None を返さない型設計にする。

実行例

実際に上記の手順を python:3.12 環境で動かすと、items = items.append(x) が None を返し、続く .pop() で AttributeError: 'NoneType' object has no attribute 'pop' が発生した(終了コード 1)。
各解消策を適用した場合は、それぞれ期待どおりの出力が得られた。

$ python bad.py
Traceback (most recent call last):
  File "/tmp/tmp.fmL5tVAJea/bad.py", line 4, in <module>
    print(items.pop())
          ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'pop'
$ echo $?
1
$ python solve_inplace.py
正しい結果: [1, 2, 3, 4]
$ python solve_is_none.py
'123-abc': matched '123'
'no digits here': マッチなし
$ python missing_return.py
compute の戻り値: None
AttributeError: 'NoneType' object has no attribute 'bit_length'

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
python:3.12

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

解決策

1. インプレースと関数型を見分ける

# NG: append は None を返す
items = items.append(x)
 
# OK: 戻り値を使わない or 関数型版を使う
items.append(x)
items = items + [x]

2. is None で早期判定

m = re.match(r"(\d+)", s)
if m is None:
    return 0
return int(m.group(1))

公式ドキュメント(新しいタブで開く) のとおり、None に属性は無い前提で書く。

3. typing.Optional と型チェッカ

from typing import Optional
 
def find_user(uid: int) -> Optional["User"]:
    ...
 
user = find_user(1)
if user is None:
    raise LookupError
user.name   # ここでは User 型に絞られている

mypy / pyright を導入すれば、typing.Optional(新しいタブで開く) の取り扱い漏れを CI で潰せる。

4. 既定値や raise する版を選ぶ

env = os.environ.get("KEY", "")    # 既定値
env = os.environ["KEY"]            # 無ければ KeyError
user = User.objects.get(pk=1)      # 無ければ DoesNotExist

「無いときに静かに None で返す API」と「raise する API」を場面で使い分けると、後段で属性アクセスする側の不安が消える。

よくある原因

  1. インプレース操作の戻り値を代入している。
    lst = lst.append(x) や s = s.sort() は None を返す。
    これは Python のミュータブル系メソッドの典型的な罠である。
  2. 既定値なしで get している。
    os.environ.get("X") や re.match(pat, s) は、値が無い・マッチしないと None を返す。
    続けて .group() などを呼ぶと例外になる。
  3. 関数の return を忘れている。
    def f(): result = compute() のように return を書き忘れていると、呼び出し側で f().attr が落ちる。
  4. API が None を返している。
    Django ORM の qs.first()、requests のオプショナル属性、SQLAlchemy の session.get() などは、見つからないと None を返す。