エラー概要
Python でプログラミングをしていると、ValueError というエラーに遭遇することがあります。このエラーは、関数やメソッドに対して「正しくない値（値の型ではなく、値そのものの内容）」が渡された際に発生します。
例えば、整数を期待している引数にリストを渡した場合は TypeError が発生しますが、整数の型は合っているものの「符号なし整数に変換できる値ではない」（例えば文字列や負の値など）といった場合に ValueError が発生します。
このエラーは、引数の型自体の問題ではなく、「値の内容が条件を満たしていない」 点に起因します。そのため、TypeCheck（型チェック）で型を確認しても解決せず、実際に渡されたデータの中身を確認する必要があります。
注意: TypeError と ValueError は混同されがちですが、TypeError は「型」の不一致、ValueError は「値」の不一致を意味します。この区別が初動の判断において最も重要です。
エラー概要で迷っていませんか？
実例コードも交えながら、つまずきやすいポイントを順番に整理します。
コピペで試せる箇所も含めて、すぐ実践できる形でまとめました。
主原因
ValueError が発生する主な原因はいくつかのパターンに集約されます。以下に代表的なケースを解説します。
関数への引数の値が不適切なケース
最も一般的なパターンです。Python の組み込み関数や標準ライブラリは、引数として受け取れる値に制約を持っています。この制約を超えた値が渡されると、実行時に ValueError が投げられます。
具体例として、16進数文字列から整数への変換関数 int() を考えます。この関数は引数に base（基数）というオプション引数を受け取ります。
# 正しい使用例
result = int('ff', 16)
print(result) # 255
# ValueError 発生例
# base に負の値や、10進数で10より大きな数、1より小さな数などを指定するとエラー
result = int('10', 0)この場合、'10' という文字列自体は正しいですが、0 という base の指定が「文字列の型を自動判定する」ことを意味し、'10' が 2進数とも10進数とも解釈できる曖昧な状態にあるため、Python は安全のためエラーを発生させます（厳密には実装依存ですが、多くのケースで ValueError になります）。また、16進数の 'ff' を base 2（2進数）として解釈しようとした場合、’f’ は 2進数で定義されていないため ValueError になります。
リストや辞書での存在しない要素へのアクセス
リスト（配列）の index() メソッドや remove() メソッド、辞書のキーアクセス時に、存在しない値を指定すると ValueError が発生します。
リストの index() メソッドは、リスト内に指定された値が見つかった場合に、その位置のインデックスを返します。しかし、値が見つからない場合、戻り値を返すことができないため、エラーとして扱われます。
fruits = ['apple', 'banana', 'cherry']
# 存在する値
print(fruits.index('banana')) # 1
# ValueError 発生例
# 'grape' はリストに存在しない
print(fruits.index('grape'))
# ValueError: 'grape' is not in list同様に、remove() メソッドも指定した値をリストから削除しようとしますが、値が存在しない場合 ValueError を発生させます。これは pop() がインデックスエラーを発生させるのとは対照的です。
数値の範囲外の値を受け取った場合
数学的な処理や特定のデータ型の変換において、許容範囲外の値が入力されると ValueError が発生することがあります。
例えば、浮動小数点数から整数への変換において、float('nan') や float('inf') を int 型に変換しようとする場合です。
# ValueError 発生例
import math
val = float('nan')
int_val = int(val)
# ValueError: cannot convert float NaN to integerまた、math モジュールの関数でも、定義域外の値を渡すと ValueError が発生します。
import math
# 負の数に平方根を求めると ValueError
sqrt_val = math.sqrt(-1)
# ValueError: math domain errorポイント: math.sqrt などの数学関数は定義域（ドメイン）を持つことに注意しましょう。負の数を渡さないよう、事前にチェックする必要があります。
解決策3 つ以上
ValueError を解決するためには、エラーの原因となった「不適切な値」がどこから来ているかを特定し、適切な値に変換するか、あるいは処理を回避する必要があります。ここでは、初心者がすぐに試せる3つのアプローチを紹介します。
解決策1 正しい型や値を確認する
まず最初にすべきことは、エラーが発生している行で、何が入力として渡されているかを確認することです。多くの場合、外部からの入力（ファイルから読み込んだデータ、APIからのレスポンス、ユーザーの入力など）が想定と異なる形式を持っていることが原因です。
デバッグのために、エラーが起きそうな処理の前に print 文を挿入して変数の内容を確認するか、IDE のデバッカーを使うと効果的です。
import sys
user_input = sys.argv[1] # コマンドライン引数から取得
# エラーが起きる前に中身を確認
print(f"入力された値: {user_input}")
print(f"型: {type(user_input)}")
try:
result = int(user_input)
print(result)
except ValueError:
print(f"{user_input} は整数に変換できません")独自視点: 変数の内容を確認する際、repr() 関数を使うことを推奨します。print() だと文字列のクォートが消えて見えにくい場合がありますが、repr() はクォートや特殊文字を明示してくれるため、空白文字や改行コードの混入などに気づきやすくなります。
s = '123 '
print(s) # 123 (末尾のスペースが見えにくい)
print(repr(s)) # '123 ' (スペースが確認できる)解決策2 条件分岐でガードする
エラーが発生する前に、値が条件を満たしているかどうかを事前にチェックし、満たさない場合は処理をスキップするか、代替の値を使用する方法です。これは「ガード節」と呼ばれます。
特に、リストや辞書の操作において、存在確認を行うことで ValueError を未然に防げます。
リスト要素の存在確認
in 演算子を使って、値がリストに含まれているかを事前に確認します。
fruits = ['apple', 'banana', 'cherry']
search_key = 'grape'
# ValueError を防ぐために存在確認
if search_key in fruits:
index = fruits.index(search_key)
print(f"インデックスは {index} です")
else:
print(f"{search_key} はリストに含まれていません")この方法なら、エラーでプログラムが停止せず、代替ロジック（例：エラーメッセージの表示、デフォルト値の設定）を実装できます。
数値の範囲チェック
数学関数を使う前や、特定の範囲が要求される処理の前に、if 文で範囲を制限します。
import math
x = -1
if x >= 0:
result = math.sqrt(x)
print(result)
else:
# 負の数の場合の処理
# 複素数にするか、エラーメッセージを出すか
result = float('nan')
print(f"{x} の平方根は定義されていません")ポイント: 条件分岐でガードする場合、「チェックした時」と「使った時」の間にデータが変更される可能性（レースコンディション）には注意が必要です。基本的なスクリプトではほぼ問題ありませんが、並列処理を行うシステムでは、それでも例外処理を併用するのが安全です。
解決策3 例外処理でキャッチする
Pythonic なアプローチとして、エラーが発生するのを待って catch する方法があります。これは「LBYL (Look Before You Leap)」ではなく“EAFP (Easier to Ask Forgiveness than Permission)””という考え方に沿ったものです。
値が正しいか事前に確認するよりも、変換や操作を試みて、失敗したらその時の処理をする方が、場合によってはコードが簡潔になることがあります。
def safe_int_convert(text):
try:
# 変換を試みる
return int(text)
except ValueError:
# 失敗した場合の処理
# 例えば、空文字や無効な文字列の場合のデフォルト値を返す
return 0
print(safe_int_convert('100')) # 100
print(safe_int_convert('abc')) # 0
print(safe_int_convert('')) # 0注意点: except 句でキャッチするのは ValueError である必要があります。except Exception や except: とすると、意図しない他のエラー（SyntaxError など、コード自体の構文エラーや、プログラマのバグによるエラー）までキャッチして隠蔽してしまうことになります。これはデバッグを困難にするため、避けてください。
# 正しいキャッチ
except ValueError:
pass
# 避けるべきキャッチ (デバッグ時に何が起きたか分からなくなる)
except Exception:
pass上級者向けヒント: 複数の異なる理由で ValueError が発生する可能性がある場合、エラーメッセージを確認して分岐したり、カスタム例外を継承して使い分けたりすることも可能です。また、raise を使って元の例外を新しい文脈で再送出することもできます。
try:
result = int('abc')
except ValueError as e:
# 元のエラー情報を含めて、追加の情報を付けて再送出
raise ValueError(f"'{value}' は無効な値です。整数を入力してください。") from e注意: raise ... from e を使うことで、トレースバックに原因となった元のエラー（'abc' が整数でないこと）も表示されます。これにより、デバッグ時に根本原因を特定しやすくなります。from e を省略すると、新しいエラーメッセージだけが表示され、元のコンテキストが見えなくなるため、基本的には from e を付けるのが推奨されます。
まとめ
ValueError は、「値の内容が期待された条件を満たしていない」 場合に発生します。TypeCheck では検知できないため、エラーメッセージをよく読み、実際に渡された値の中身を確認することが解決の鍵です。
解決策として以下の3つを状況に応じて使い分けてください。
- 値の確認: print や debugger で変数の内容を確認し、予期せぬデータが混入していないかチェックする。
- 条件分岐 (ガード): 処理前に
in演算子や範囲チェックで安全性を確認する。ユーザーへのフィードバックが必要な場合に適している。 - 例外処理 (キャッチ): 変換や操作を試みて失敗時に対応する。EAFP パターンとして一般的であり、コードをすっきりさせられる。
初心者のうちは、エラーメッセージに書かれている「期待された値」と「実際に渡された値」の違いに注目し、try-except と if-else を組み合わせて堅牢なコードを書きましょう。すべての入力は信頼しないという意識を持ち、適切な検証処理を入れることが、バグのないプログラムへの近道です。
FAQ
ValueError と TypeError の違いは何ですか？
TypeError は引数や演算子の型が正しくない場合に発生します（例：文字列と整数の加算）。一方、ValueError は型は正しいが、値の内容が条件を満たしていない場合に発生します（例：整数に変換できない文字列を int() に渡す）。まずこの区別がつくと、デバッグの方向性が明確になります。
ValueError のエラーメッセージで ‘int’ とはどのような意味ですか？
これは、関数（ここでは int()）が期待しているのが「整数に変換可能な値」であることを意味します。エラーメッセージの前後の文脈をよく読んで、どの引数に対してこのエラーが発生しているかを特定してください。多くの場合、変数名を出力することで、どの変数が原因かわかります。
ValueError が出ているが、値を確認すると正しいように見えます。
表示されている値が正しい場合でも、内部のデータ型やフォーマットに問題がある可能性があります。例えば、見た目上是整数でも、実際は文字列型（’100′ vs 100）だったり、空白文字が含まれている場合（’100 ‘）などです。repr() や type() で詳細を確認し、不要な空白や改行を strip() メソッドで削除するなど、クリーニング処理を加えてみてください。
ここまで読んでいただきありがとうございます！
UdemyのPythonコースにはオンラインで学習ができる動画コンテンツがたくさんあります。
当ブログのような文章メインの説明では足りない箇所を補えると思うので、もっと詳しく勉強したいという方はぜひチェックしてみてください！
コメント