【初心者向け】PythonでOSError例外をキャッチする方法を解説

OSErrorとは？

OSErrorは、Pythonのosモジュールに対応する例外クラスで、OS固有の関数からエラーが返されたときに発生します。「ファイルが存在しない」「アクセス権限がない」「無効なファイルディスクリプタが指定された」など、オペレーティングシステムレベルの問題を扱う際によく見られる例外です。

この記事では、try-except構文を使ってOSErrorをキャッチし、エラーの内容と種類を確認する方法を具体例とともに紹介します。

OSErrorをキャッチするサンプルコード

以下のスクリプトでは、ファイルディスクリプタ0〜4に対応する端末名をos.ttyname()で取得しようとしています。開かれていないディスクリプタにアクセスした時点でOSErrorが発生するため、それをexceptブロックで捕捉します。

#foobar.py
import os
import sys

try:
    for i in range(5):
        print(i, os.ttyname(i))
except Exception as e:
    print(e)
    print(type(e))

実行方法

Linuxのターミナルで次のコマンドを実行します。

$ python foobar.py

出力結果

0 /dev/pts/0
1 /dev/pts/0
2 /dev/pts/0
3 [Errno 9] Bad file descriptor
<class 'OSError'>

出力の解説

ディスクリプタ0〜2（標準入力・標準出力・標準エラー出力）は有効な端末に接続されているため、それぞれ/dev/pts/0という端末名が出力されます。一方、ディスクリプタ3は開かれていないため、[Errno 9] Bad file descriptor（無効なファイルディスクリプタ）というOSErrorが発生し、ループはそこで中断されます。

exceptブロックでは、例外オブジェクトeを出力することでエラーメッセージを確認でき、type(e)によって例外のクラスがOSErrorであることもわかります。

補足：より具体的な例外処理の書き方

ExceptionではなくOSErrorそのものを指定してキャッチすれば、意図しない例外まで拾ってしまうのを防げます。さらに、例外オブジェクトのerrno属性を使えば、エラー番号ごとに処理を分岐することも可能です。

try:
    print(os.ttyname(3))
except OSError as e:
    if e.errno == 9:  # EBADF: 無効なファイルディスクリプタ
        print("無効なファイルディスクリプタです")
    else:
        raise

このようにOSErrorはerrno情報を持っているため、エラーの種類に応じた柔軟なハンドリングが行えます。OS関連の処理を書く際は、try-exceptによる例外処理を組み込んでおくと安心です。