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を捕まえて処理を終えます。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

この記事のようなコードを、講師に聞きながら動かしてみる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です