PythonのIOErrorとは?OSErrorとの違い・Errno別の原因と対処・Python 2コードの直し方
PythonのIOErrorは、Python 3.3以降はOSErrorの別名(IOError is OSErrorがTrue)で、ファイルの入出力などOSが関わる処理の失敗を表す例外です。実際に発生するのはFileNotFoundErrorやPermissionErrorなどのサブクラスなので、原因に合ったサブクラスを捕まえて対処します。
この記事では、IOErrorとOSErrorが同じものである確認、エラーメッセージから原因を読む方法(errno番号との対応表)、Python 2の古いコードを直すときの注意を、実行結果付きで解説します。OSError全体の原因と対処は「Pythonの「OSError」とは?原因・種類・対処法を初心者向けに解説」で扱っているので、ここではIOErrorという名前に関わる点に絞ります。実行結果はPython 3.12(macOS)で確認しました(2026年10月18日確認)。
IOErrorとOSErrorは同じクラス
print(IOError is OSError)
print(EnvironmentError is OSError)
print(IOError.__name__)
実行結果:
True
True
OSError
isでTrueになるので、似たクラスではなく同じクラスを指しています。名前を表示してもOSErrorです。公式ドキュメントには「バージョン3.3で、EnvironmentError・IOError・WindowsError・socket.error・select.error・mmap.errorはOSErrorに統合され、コンストラクタがサブクラスを返すことがある」と書かれています(2026年10月18日確認)。
そのため、except IOError:と書いてもexcept OSError:と書いても、捕まえる範囲はまったく同じです。
try:
open("nope.txt")
except IOError as e:
print(type(e).__name__, ":", e)
実行結果:
FileNotFoundError : [Errno 2] No such file or directory: 'nope.txt'
捕まえたのはFileNotFoundErrorです。Python 3で「IOError」という名前の例外が表示されることはなく、エラー表示には具体的なサブクラス名かOSErrorが出ます。
エラーメッセージの読み方:[Errno 番号]で原因が分かる
IOError(=OSError)系のメッセージは[Errno 番号] 説明: 'ファイル名'の形をしています。番号はOSが返したエラーコードで、例外オブジェクトの属性からも取り出せます。
import errno
try:
open("nope.txt")
except OSError as e:
print("errno:", e.errno)
print("ENOENTか:", e.errno == errno.ENOENT)
print("strerror:", e.strerror)
print("filename:", e.filename)
実行結果:
errno: 2
ENOENTか: True
strerror: No such file or directory
filename: nope.txt
Python 3.3以降は、このerrnoに応じて自動的にサブクラスが選ばれます。OSError(番号, ...)を作ったときにどのクラスになるかを確かめました。
import errno
for code in ["ENOENT", "EACCES", "EEXIST", "EISDIR", "ENOTDIR",
"EPIPE", "ECONNREFUSED", "ETIMEDOUT", "ENOSPC"]:
n = getattr(errno, code)
print(f"{code:13} errno={n:3} -> {type(OSError(n, 'x')).__name__}")
実行結果(macOS):
ENOENT errno= 2 -> FileNotFoundError
EACCES errno= 13 -> PermissionError
EEXIST errno= 17 -> FileExistsError
EISDIR errno= 21 -> IsADirectoryError
ENOTDIR errno= 20 -> NotADirectoryError
EPIPE errno= 32 -> BrokenPipeError
ECONNREFUSED errno= 61 -> ConnectionRefusedError
ETIMEDOUT errno= 60 -> TimeoutError
ENOSPC errno= 28 -> OSError
errnoの番号はOSによって違うことがあります(たとえばLinuxではECONNREFUSEDは111です)。番号ではなくerrno.ENOENTのような名前で比べるか、サブクラスで捕まえるのが確実です。ディスクの空き不足(ENOSPC)のように専用のサブクラスが無いものは、OSErrorのまま発生します。
よく見るIOErrorのメッセージと対処
古い記事やPython 2のログでは「IOError: [Errno 2] …」のように表示されます。Python 3では同じ原因が次のクラス名で表示されます。
| Python 2での表示 | Python 3で発生するクラス | 主な原因と対処 |
|---|---|---|
IOError: [Errno 2] No such file or directory |
FileNotFoundError |
パスの誤り・実行場所の違い。絶対パスやos.path.exists()で確認する |
IOError: [Errno 13] Permission denied |
PermissionError |
権限不足、Excelなどで開いたままのファイルへの書き込み |
IOError: [Errno 21] Is a directory |
IsADirectoryError |
ファイルではなくフォルダをopen()した |
IOError: [Errno 32] Broken pipe |
BrokenPipeError |
出力先(パイプ・ソケット)が先に閉じられた |
IOError: [Errno 28] No space left on device |
OSError |
ディスクの空き不足 |
フォルダや既存ファイルが原因になる例も、実際に起こして確かめました。
import os
import tempfile
d = tempfile.mkdtemp()
for label, func in [("フォルダをopen", lambda: open(d)),
("存在するフォルダをmkdir", lambda: os.mkdir(d)),
("ファイルの下にmkdir", lambda: os.mkdir(__file__ + "/x"))]:
try:
func()
except OSError as e:
print(f"{label:16} -> {type(e).__name__}: {e.strerror}")
os.rmdir(d)
実行結果:
フォルダをopen -> IsADirectoryError: Is a directory
存在するフォルダをmkdir -> FileExistsError: File exists
ファイルの下にmkdir -> NotADirectoryError: Not a directory
ファイルが見つからないエラーの詳しい対処は「FileNotFoundErrorとは?Pythonで発生する原因と解決方法を初心者向けに解説」、権限のエラーは「Pythonの「PermissionError」とは?原因・対処法をわかりやすく解説」、フォルダを開いたときのエラーは「PythonのIsADirectoryError(Errno 21)の原因と対処法」を参照してください。なお、文字コードのエラー(UnicodeDecodeErrorなど)はOSErrorの系統ではなくValueErrorの下にあるので、except IOError:では捕まりません。
原因ごとのサブクラスで捕まえる
Python 2のIOErrorは「ファイルの読み書き」、OSErrorは「osモジュールの操作」と分かれていましたが、同じ「ファイルが無い」でも経路によって例外が変わるため扱いにくいものでした。Python 3.3で統合され、代わりに原因ごとのサブクラスが用意されたので、次のように分けて書けます。
def load(path):
try:
with open(path, encoding="utf-8") as f:
return f.read()
except FileNotFoundError:
return "" # 無ければ空で続行
except PermissionError:
raise RuntimeError(f"{path} を読む権限がありません")
print(repr(load("nope.txt")))
実行結果:
''
errnoで分岐するより読みやすく、OSによる番号の違いも気にしなくて済みます。それ以外のOS関連エラーもまとめて扱いたいときは、最後にexcept OSError as e:を置いてe.filenameやe.strerrorをログに残します。
raise IOError()を書くとどうなるか
IOErrorはOSErrorそのものなので、raise IOError(...)と書くとOSErrorが発生します。errnoを渡すとサブクラスに置き換わります。
import errno
e = IOError(errno.ENOENT, "見つかりません", "data.txt")
print(type(e).__name__)
print(e)
e = IOError("ただのメッセージ")
print(type(e).__name__, e.errno)
try:
raise IOError("設定ファイルを読めません")
except OSError as e:
print("捕まえた:", type(e).__name__, e)
実行結果:
FileNotFoundError
[Errno 2] 見つかりません: 'data.txt'
OSError None
捕まえた: OSError 設定ファイルを読めません
新しく書くコードでは、意図が伝わるようにraise FileNotFoundError(...)やraise OSError(...)と書くほうが分かりやすくなります。
Python 2のコードで見かけたときの直し方
| 古い書き方 | Python 3での状況 | 直し方 |
|---|---|---|
except IOError, e: |
SyntaxErrorで動かない |
except OSError as e: |
except IOError as e: |
動く(OSErrorと同じ) |
急がないが、必要なサブクラスに絞ると安全 |
except (IOError, OSError): |
動くが重複 | except OSError: |
if e.errno == 2: |
動く | except FileNotFoundError: |
Python 3でexcept IOError, e:を実行すると、次のエラーで止まります。
except IOError, e:
^^^^^^^^^^
SyntaxError: multiple exception types must be parenthesized
except IOError:はそのまま動きますが、OSErrorと同じなのでファイル以外のOSエラー(ネットワークの切断など)も捕まえます。本当に必要なのがFileNotFoundErrorだけなら、そこまで絞ると想定外の不具合を隠さずに済みます。例外処理全般の書き方は「Pythonの例外処理ベストプラクティス」も参考にしてください。
よくある質問
Q. IOErrorとOSErrorの違いは何ですか?
Python 3.3以降は違いがありません。IOErrorはOSErrorの別名で、IOError is OSErrorはTrueです。違いがあったのはPython 2までで、ファイル入出力はIOError、osモジュールの操作はOSErrorと分かれていました。
Q. Python 3でIOErrorを使ってもいいですか?
動作上の問題はありませんが、新しいコードではOSErrorか、FileNotFoundErrorやPermissionErrorなどの具体的なサブクラスを使うのが一般的です。except IOError, e:というPython 2の書き方だけはSyntaxErrorになるので、except OSError as e:に直します。
Q. IOErrorとFileNotFoundErrorはどう違いますか?
FileNotFoundErrorはOSError(=IOError)のサブクラスで、ファイルやフォルダが見つからないとき(errno 2)に発生します。except IOError:でもFileNotFoundErrorは捕まりますが、ほかの原因のエラーもまとめて捕まえてしまいます。
Q. IOError: [Errno 32] Broken pipeはどう対処しますか?
Python 3ではBrokenPipeErrorとして発生します。出力先のパイプやソケットが先に閉じられたときに起きるので、相手側が終了していないかを確認し、必要ならBrokenPipeErrorを捕まえて処理を終えます。



![PermissionErrorとは?Pythonの[Errno 13]・[WinError 5]・[WinError 32]の原因とexceptでの扱い方 Gemini_Generated_Image_rrfimprrfimprrfi](/wp-content/uploads/2026/09/Gemini_Generated_Image_rrfimprrfimprrfi-150x150.jpg)



