PermissionErrorとは?Pythonの[Errno 13]・[WinError 5]・[WinError 32]の原因とexceptでの扱い方

PermissionError は、Python がファイルやフォルダを操作しようとしたときに、OS から「権限がない」「今は使えない」と断られたことを表す例外です。[Errno 13] なら読み書きの権限、[WinError 32] なら別のアプリがファイルを使用中、[WinError 5] ならアクセス拒否が原因なので、表示された番号から原因を絞り込めます。

この記事では、PermissionError を例外クラスとして見たときの中身(番号・属性・OSError との関係)と、番号ごとの原因、try-except での扱い方を説明します。macOS のターミナルで出る「zsh: permission denied」や pip install の権限エラーなど、コマンド側の直し方はPermission deniedの意味と直し方|PythonのPermissionError: [Errno 13]・zsh・Macの原因別チェックにまとめています。

PermissionErrorとは:OSErrorの一種

PermissionError は OSError のサブクラスです。Python 公式ドキュメントでは「十分なアクセス権、例えばファイルシステム権限のない操作が試みられた場合に送出」され、エラー番号(errno)の EACCES と EPERM に対応すると説明されています(組み込み例外、2026年10月18日確認)。

print(PermissionError.__mro__)
(<class 'PermissionError'>, <class 'OSError'>, <class 'Exception'>, <class 'BaseException'>, <class 'object'>)

つまり Python が独自に判断しているのではなく、OS が返したエラー番号を Python が PermissionError に変換しています。同じ OSError の仲間には、ファイルがない FileNotFoundError、フォルダをファイルとして開いた IsADirectoryError などがあります。

エラー番号別の意味と原因

PermissionError のメッセージには、角かっこの中に番号が付きます。番号によって原因が違います。

表示 出るOS 意味 よくある原因
[Errno 13] Permission denied macOS・Linux(Windows でも出る) 読み書きの権限がない(EACCES) 読み取り専用ファイルへの書き込み、書き込めないフォルダへの保存
[Errno 1] Operation not permitted macOS・Linux その操作自体が許されていない(EPERM) 所有者の変更など管理者だけの操作、macOS のプライバシー保護
[WinError 5] アクセスが拒否されました。 Windows アクセス拒否 保護されたフォルダへの書き込み、フォルダを os.remove() で消そうとした
[WinError 32] プロセスはファイルにアクセスできません。別のプロセスが使用中です。 Windows ファイルが使用中 Excel などで開いたままのファイルを上書き・削除した、自分のコードで閉じ忘れた
[WinError 10013] Windows ソケット(ネットワーク)へのアクセスが拒否された サーバーを起動しようとしたポート番号が使えない状態になっている

Windows のエラーが PermissionError になる理由は、CPython のソースで確認できます。Windows のエラーコード 5(ERROR_ACCESS_DENIED)・32(ERROR_SHARING_VIOLATION)・33(ERROR_LOCK_VIOLATION)は errno の EACCES に変換され、EACCES は PermissionError に対応づけられています(CPython PC/errmap.h、2026年10月18日確認)。10013 はソケットのエラーコードで、10000 を引いた 13(EACCES)として扱われます。

macOSで実際に出したPermissionError

次のコードで、権限のない操作を4つ試しました(macOS・Python 3.12.15)。e.errno・e.strerror・e.filename は OSError が持つ属性で、どのファイルで何が起きたかをプログラムから取り出せます。

import os, errno

def attempt(label, func):
    try:
        func()
        print(label, "OK")
    except PermissionError as e:
        print(f"{label}: PermissionError: {e}")
        print(f"   errno={e.errno} ({errno.errorcode[e.errno]}) strerror={e.strerror!r} filename={e.filename!r}")

# 1. 読み取り専用ファイルに書き込む
with open("report.txt", "w") as f:
    f.write("v1")
os.chmod("report.txt", 0o444)
attempt("1", lambda: open("report.txt", "w"))

# 2. 書き込み禁止のフォルダにファイルを作る
os.makedirs("locked", exist_ok=True)
os.chmod("locked", 0o555)
attempt("2", lambda: open("locked/new.txt", "w"))

# 3. 読み取り権限のないファイルを読む
with open("secret.txt", "w") as f:
    f.write("x")
os.chmod("secret.txt", 0o000)
attempt("3", lambda: open("secret.txt").read())

# 4. 所有者を root に変える(管理者だけの操作)
attempt("4", lambda: os.chown("report.txt", 0, 0))
1: PermissionError: [Errno 13] Permission denied: 'report.txt'
   errno=13 (EACCES) strerror='Permission denied' filename='report.txt'
2: PermissionError: [Errno 13] Permission denied: 'locked/new.txt'
   errno=13 (EACCES) strerror='Permission denied' filename='locked/new.txt'
3: PermissionError: [Errno 13] Permission denied: 'secret.txt'
   errno=13 (EACCES) strerror='Permission denied' filename='secret.txt'
4: PermissionError: [Errno 1] Operation not permitted: 'report.txt'
   errno=1 (EPERM) strerror='Operation not permitted' filename='report.txt'

1〜3 は「権限が足りない」ので Errno 13、4 は「一般ユーザーにはそもそも許されない操作」なので Errno 1 になりました。2 は、ファイル名は新しくても保存先のフォルダに書き込み権限がないためにエラーになっている点に注意してください。filename に出ているのは作ろうとしたファイルですが、直すべきなのはフォルダの権限か保存先です。

権限は os.access() で事前に確かめることもできます。

print(os.access("report.txt", os.W_OK), os.access("locked", os.W_OK))
False False

ファイルの権限の確認と変更(stat.filemode・os.chmod)はPythonでファイルの権限(パーミッション)を確認・変更する方法で詳しく説明しています。

Windowsの[WinError 32]と[WinError 5]の直し方

[WinError 32] 別のプロセスが使用中

Windows では、使用中のファイルを削除しようとすると例外になります(os モジュールの os.remove() の説明)。macOS や Linux では消せる場面でも、Windows では止まるのがこのエラーです。

  • Excel・メモ帳・画像ビューアなどでそのファイルを開いていないか確認し、閉じてから実行する
  • 自分のコードで open() したファイルを閉じずに、同じファイルを削除・名前変更していないか確認する。with open(...) as f: で開けば、ブロックを抜けたときに自動で閉じられる
  • 自分で開いた覚えがない場合は、同期ソフトやほかのプログラムが使用中の可能性がある。少し待って再実行するか、別のフォルダで作業して切り分ける

[WinError 5] アクセスが拒否されました

  • C:\Program Files などの保護されたフォルダに保存しようとしていないか確認し、ユーザーのフォルダ(ドキュメントなど)に保存先を変える
  • フォルダを os.remove() で消そうとしていないか確認する。フォルダは os.rmdir()(空のとき)か shutil.rmtree() で消す
  • pip install で出た場合は、管理者として実行するより、仮想環境(venv)を作ってその中にインストールするほうが安全

どのエラーも、管理者権限で実行すれば通ることがありますが、原因を確かめずに権限を上げると、消してはいけないファイルを消すなどの事故につながります。まず「どのファイルに」「何をしようとして」断られたのかを、メッセージの filename から確認してください。

try-exceptでPermissionErrorを扱う

保存先が書き込めないときに別の場所へ逃がすなど、プログラム側で対処したい場合は except PermissionError で受け止めます。

import os
from pathlib import Path

def save_report(text, path):
    try:
        with open(path, "w", encoding="utf-8") as f:
            f.write(text)
        print("保存しました:", path)
    except PermissionError as e:
        print("書き込めません:", e.filename, "/", e.strerror)
        fallback = Path.home() / "report_backup.txt"
        print("代わりに保存する場所:", fallback.name)

os.chmod("report.txt", 0o444)
save_report("v2", "report.txt")
os.chmod("report.txt", 0o644)
save_report("v2", "report.txt")
書き込めません: report.txt / Permission denied
代わりに保存する場所: report_backup.txt
保存しました: report.txt

ファイル操作のエラーをまとめて扱いたいときは、親クラスの except OSError で受け止めることもできます。その場合でも、isinstance(e, PermissionError) や e.errno == errno.EACCES で権限エラーかどうかを判別できます。

try:
    open("report.txt", "w")   # 読み取り専用にした状態で実行
except OSError as e:
    print(type(e).__name__, isinstance(e, PermissionError), e.errno == errno.EACCES)
PermissionError True True

ただし、except で受け止めて何もしない(pass だけ書く)のは避けてください。書き込めなかったことに気づかないまま、処理が成功したように見えてしまいます。

似ている例外との見分け方

例外 表示 意味
PermissionError [Errno 13] Permission denied ファイルはあるが、権限がない
FileNotFoundError [Errno 2] No such file or directory ファイルやフォルダが存在しない
IsADirectoryError [Errno 21] Is a directory フォルダをファイルとして開いた
NotADirectoryError [Errno 20] Not a directory パスの途中にファイルがある

FileNotFoundError と IsADirectoryError の表示は、同じ macOS 環境で実際に出して確認しました。パスの書き間違いは FileNotFoundError になることが多く、PermissionError が出ているならファイル自体は見つかっていると考えてよいでしょう。詳しくはPythonのIsADirectoryError(Errno 21)の原因と対処法、PythonのNotADirectoryError(Errno 20)の原因と対処法、OSError 全体の関係はPythonのIOErrorとは?OSErrorとの関係と対処法をご覧ください。

よくある質問

Q. PermissionError とは何ですか?

ファイルやフォルダの操作を OS が権限不足などの理由で拒否したときに Python が送出する例外です。OSError のサブクラスで、errno の EACCES と EPERM に対応します。

Q. [Errno 13] と [Errno 1] は何が違いますか?

Errno 13(Permission denied)はそのファイルを読み書きする権限が足りない場合、Errno 1(Operation not permitted)は所有者の変更など、その操作自体が許されていない場合に出ます。

Q. [WinError 32] が出たらどうすればよいですか?

そのファイルを別のアプリや自分のプログラムが開いたままになっています。Excel などを閉じる、コードでは with 文で開いて確実に閉じる、ほかのプログラムの処理が終わるのを待つ、のいずれかで直ります。

Q. PermissionError を except で捕まえるにはどう書きますか?

except PermissionError as e: と書き、e.filename で対象のファイル、e.strerror で理由を取り出せます。ファイル操作のエラーをまとめて扱うなら except OSError でも捕まえられます。

Q. 管理者権限で実行すれば解決しますか?

通ることはありますが、原因が分からないまま権限を上げるのは危険です。まず保存先を自分のフォルダに変える、開いているファイルを閉じるなど、原因に合った方法で直してください。

例外クラスの個別解説

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

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

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

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

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

参加者の声

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

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

参加費は無料です