Python TypeError（型エラー）の原因と解決法。型安全プログラミング入門

Python開発で頻出する「TypeError（型エラー）」について、原因から解決法、予防策まで徹底解説します。型の概念を理解して、より堅牢なPythonコードを書けるようになりましょう。

TypeErrorとは

TypeErrorは、データ型が期待される操作に適していない場合に発生するエラーです。例えば、文字列と数値を足し算しようとしたり、整数に対して文字列専用のメソッドを呼び出したりした際に起こります。

# TypeError例：文字列と数値の演算
result = "5" + 3
# TypeError: can only concatenate str (not "int") to str

TypeErrorが発生する主なパターン

1. 異なる型同士の演算

異なるデータ型同士で演算を行おうとした場合に発生します。

# 間違い：文字列と数値の加算
text = "10"
number = 5
result = text + number
# TypeError: can only concatenate str (not "int") to str

# 正解：型を統一
result = int(text) + number  # 文字列を数値に変換
# または
result = text + str(number)  # 数値を文字列に変換

# 間違い：リストと数値の乗算（意図しない場合）
numbers = [1, 2, 3]
result = numbers * 2.5
# TypeError: can't multiply sequence by non-int of type 'float'

# 正解：整数で乗算
result = numbers * 2  # [1, 2, 3, 1, 2, 3]
# または各要素に対して演算
result = [x * 2.5 for x in numbers]

2. 関数の引数型エラー

関数に期待されない型の引数を渡した場合に発生します。

# 間違い：文字列を数学関数に渡す
import math
result = math.sqrt("16")
# TypeError: must be real number, not str

# 正解：数値型に変換
result = math.sqrt(float("16"))

# 間違い：不適切な引数の数
def greet(name, age):
    return f"こんにちは、{name}さん（{age}歳）"

message = greet("田中")  # 引数が足りない
# TypeError: greet() missing 1 required positional argument: 'age'

# 正解：必要な引数をすべて渡す
message = greet("田中", 25)

3. メソッドの型エラー

オブジェクトに存在しないメソッドを呼び出そうとした場合に発生します。

# 間違い：整数に文字列メソッドを適用
number = 123
result = number.upper()
# TypeError: 'int' object has no attribute 'upper'

# 正解：文字列に変換してからメソッドを適用
result = str(number).upper()  # "123" -> 文字列なのでupperは意味なし
# より適切な例
text = "hello"
result = text.upper()  # "HELLO"

4. イミュータブル（不変）オブジェクトの変更

変更不可能なオブジェクトを変更しようとした場合に発生します。

# 間違い：文字列（不変）の要素を変更
text = "Hello"
text[0] = "h"
# TypeError: 'str' object does not support item assignment

# 正解：新しい文字列を作成
text = "h" + text[1:]  # "hello"
# または
text = text.replace("H", "h")

# 間違い：タプル（不変）の要素を変更
data = (1, 2, 3)
data[0] = 10
# TypeError: 'tuple' object does not support item assignment

# 正解：リストを使用（変更可能）
data = [1, 2, 3]
data[0] = 10  # [10, 2, 3]

5. インデックスアクセスの型エラー

インデックスアクセスに不適切な型を使用した場合に発生します。

# 間違い：文字列インデックスを使用
numbers = [1, 2, 3, 4, 5]
value = numbers["2"]
# TypeError: list indices must be integers or slices, not str

# 正解：整数インデックスを使用
value = numbers[2]  # 3

6. 反復処理の型エラー

反復処理で反復不可能なオブジェクトを使用した場合に発生します。

# 間違い：整数を反復処理
for i in 5:
    print(i)
# TypeError: 'int' object is not iterable

# 正解：rangeを使用
for i in range(5):
    print(i)  # 0, 1, 2, 3, 4

型チェックとデバッグ方法

1. type()関数で型を確認

# 変数の型を確認
value = "123"
print(type(value))  # <class 'str'>
print(type(int(value)))  # <class 'int'>

2. isinstance()関数で型判定

# より柔軟な型チェック
def safe_add(a, b):
    if isinstance(a, (int, float)) and isinstance(b, (int, float)):
        return a + b
    else:
        raise TypeError("引数は数値である必要があります")

print(safe_add(5, 3))    # 8
print(safe_add(5.5, 2))  # 7.5
# safe_add("5", 3)  # TypeError

3. hasattr()関数でメソッド存在確認

# メソッドが存在するかチェック
def safe_upper(text):
    if hasattr(text, 'upper'):
        return text.upper()
    else:
        return str(text).upper()

print(safe_upper("hello"))  # "HELLO"
print(safe_upper(123))      # "123"

TypeErrorの予防策

1. 型ヒント（Type Hints）の活用

# Python 3.5以降で利用可能
def calculate_tax(price: float, rate: float) -> float:
    return price * rate

# IDEで型チェックが可能
result = calculate_tax(1000, 0.1)  # 正常
# result = calculate_tax("1000", 0.1)  # IDEで警告

2. 入力値の検証

def divide(a, b):
    # 型チェック
    if not isinstance(a, (int, float)) or not isinstance(b, (int, float)):
        raise TypeError("引数は数値である必要があります")
    
    # 値チェック
    if b == 0:
        raise ValueError("ゼロで割ることはできません")
    
    return a / b

# 安全な使用
try:
    result = divide(10, 2)
    print(result)  # 5.0
except (TypeError, ValueError) as e:
    print(f"エラー: {e}")

3. デフォルト値の設定

def process_data(data=None):
    if data is None:
        data = []  # デフォルト値を設定
    
    # dataがリストであることを確認
    if not isinstance(data, list):
        data = [data]  # 単一要素をリストに変換
    
    return [x * 2 for x in data]

print(process_data([1, 2, 3]))  # [2, 4, 6]
print(process_data(5))          # [10]
print(process_data())           # []

4. try-except文での例外処理

def robust_calculation(x, y):
    try:
        # 文字列の場合は数値に変換を試行
        if isinstance(x, str):
            x = float(x)
        if isinstance(y, str):
            y = float(y)
            
        return x + y
    except (ValueError, TypeError) as e:
        print(f"計算エラー: {e}")
        return None

print(robust_calculation(5, 3))      # 8
print(robust_calculation("5", 3))    # 8.0
print(robust_calculation("abc", 3))  # 計算エラー: ...

実践的な型安全プログラミング

1. データクラスの活用

from dataclasses import dataclass

@dataclass
class Person:
    name: str
    age: int
    
    def greet(self) -> str:
        return f"こんにちは、{self.name}です（{self.age}歳）"

# 型安全なオブジェクト作成
person = Person("田中", 25)
print(person.greet())

2. Enumの使用

from enum import Enum

class Status(Enum):
    PENDING = "pending"
    COMPLETED = "completed"
    FAILED = "failed"

def process_task(status: Status):
    if status == Status.PENDING:
        return "処理中..."
    elif status == Status.COMPLETED:
        return "完了"
    else:
        return "失敗"

# 型安全な使用
result = process_task(Status.PENDING)

3. 型チェックツールの導入

# mypyによる静的型チェック
pip install mypy
mypy your_script.py

まとめ

TypeErrorは型の不一致によって発生するエラーですが、適切な理解と対策により効果的に防げます。

重要なポイント:

• データ型の理解：各型の特性と制限を把握
• 型変換：必要に応じて適切な型に変換
• 型チェック：isinstance()やtype()で事前確認
• 型ヒント：コードの意図を明確化
• 入力値検証：関数の引数や外部データを検証
• 例外処理：予期しない型エラーに対する適切な処理

型を意識したプログラミングを心がけることで、TypeErrorを減らし、より堅牢で保守性の高いPythonコードを書けるようになります。型安全なプログラミングは、バグの早期発見と品質向上につながる重要なスキルです。

■「らくらくPython塾」が切り開く「呪文コーディング」とは？

■プロンプトだけでオリジナルアプリを開発・公開してみた！！

■AI時代の第一歩！「AI駆動開発コース」はじめました！

テックジム東京本校で先行開始。

■テックジム東京本校

「武田塾」のプログラミング版といえば「テックジム」。
講義動画なし、教科書なし。「進捗管理とコーチング」で効率学習。
より早く、より安く、しかも対面型のプログラミングスクールです。

＜短期講習＞5日で5万円の「Pythonミニキャンプ」開催中。

＜月1開催＞放送作家による映像ディレクター養成講座

＜オンライン無料＞ゼロから始めるPython爆速講座