CSVに集計結果を書き出すだけのプログラムなのに、PermissionError: [Errno 13] Permission denied と表示されて止まってしまった。ファイル操作を覚えたばかりのころ、こんな経験をした方は多いのではないでしょうか。
昨日まで動いていたのに、今日になって急に出ることもあります。コードは何も変えていないのに、と戸惑ってしまいますよね。
このエラーの原因は、コードの書き間違いよりも、ファイルやフォルダの置かれた状況にあることがほとんどです。この記事では、PermissionErrorの意味とメッセージの読み方から、よくある原因、そして落ちないコードの書き方までを順番に解説します。
サンプルの実行結果は、手元のLinux環境のPython 3.11から3.13で、一般ユーザーとして実行して確認したものです。Windowsに特有の挙動については、そのつど断りを入れて紹介します。
PermissionErrorとはどんなエラーなのか¶
まずは、このエラーが何を伝えているのかを押さえましょう。ひとことで言うと、ファイルは見つかったけれど、それを操作する権限がないときに出るエラーです。
鍵のかかった部屋をイメージするとわかりやすいかもしれません。部屋そのものはちゃんとあるのに、鍵を持っていないので入れない状態です。
パソコンのファイルやフォルダには、誰が読めるか、誰が書けるかという決まりがあります。この決まりを権限やパーミッションと呼びます。
Pythonは、OSに操作を頼んで断られると、その理由に合った例外を出します。権限が足りないと断られたときに使われるのが、PermissionErrorです。
クラスの関係を確かめると、次のようになっています。
print(PermissionError.__mro__)
# (<class 'PermissionError'>, <class 'OSError'>, <class 'Exception'>, <class 'BaseException'>, <class 'object'>)
PermissionErrorは、OSErrorという大きなグループの一員です。FileNotFoundErrorやIsADirectoryErrorも同じグループに属していて、どれもOSとのやり取りで起きた失敗を表します。
エラーメッセージの読み方¶
次に、メッセージの中身を見ていきます。PermissionErrorのメッセージには、角カッコで囲まれた番号がついているのが特徴です。
この番号はerrnoと呼ばれ、OSが失敗の理由を表すために使う番号です。PermissionErrorになる主な番号を、手元で試した例と一緒に表にまとめました。
| メッセージ | errnoの名前 | 手元で起きた操作の例 |
|---|---|---|
| [Errno 13] Permission denied | EACCES | 読む権限のない/etc/shadowをopen()した |
| [Errno 13] Permission denied | EACCES | 書き込めないフォルダにファイルを作ろうとした |
| [Errno 1] Operation not permitted | EPERM | 自分のものではないファイルをos.chmod()しようとした |
| [Errno 1] Operation not permitted | EPERM | 他のユーザーのプロセスをos.kill()しようとした |
実務でいちばんよく見るのは、Errno 13のPermission deniedです。Errno 1はファイルの持ち主を変えるような、もっと強い権限が必要な操作で出ることが多いです。
メッセージの最後には、たいてい対象のファイル名が表示されます。どのファイルで断られたのかは、ここを見ればすぐにわかります。
例外のオブジェクトからは、これらの情報を属性として取り出せます。e.errnoで番号、e.strerrorで理由の文章、e.filenameでファイル名が手に入ります。
エラーがどの行で起きたかは、メッセージより上のtracebackに表示されます。読み方を復習したい方は、こちらの記事が参考になります。 【関連記事】Pythonのエラー文はどこを読めばいい?初心者向けtracebackの見方
PermissionErrorのよくある原因¶
ここからが本題です。権限がないと言われても、何を確かめればいいのか迷いますよね。よくある原因を順番に見ていきましょう。
ほかのアプリがファイルを開いたままになっている¶
Windowsでいちばん多いのが、このパターンです。Excelで結果を確認したあと、ファイルを閉じ忘れたままもう一度プログラムを実行すると、書き込みでPermissionErrorが出ることがあります。
Excelなどのアプリは、編集中のファイルをほかから書き換えられないように、ロックをかけることがあるためです。WindowsはLinuxやmacOSに比べてこうしたロックが厳しく、開いているファイルの上書きや削除を断られやすい傾向があります。
私は10年ほどエンジニアとして開発に関わってきましたが、このエラーで朝のバッチ処理が止まったことがあります。原因を調べると、前の晩に担当者が出力ファイルをExcelで開いたまま帰宅していたのでした。
書き込めない場所に保存しようとした¶
システムのフォルダや、ほかのユーザーのフォルダには、一般ユーザーは書き込めないようになっています。保存先のパスを間違えて、こうした場所を指定してしまうケースです。
LinuxやmacOSでは、ファイルを作れるかどうかはフォルダ側の権限で決まります。手元で書き込み権限のないフォルダにファイルを作ろうとしたところ、Errno 13が出ました。
フォルダをファイルとしてopen()した¶
これはWindowsで特に迷いやすい原因です。ファイル名を付け忘れて、フォルダのパスをそのままopen()に渡してしまうパターンです。
LinuxやmacOSなら、IsADirectoryError: [Errno 21] Is a directory と出るので、すぐに原因がわかります。ところがWindowsでは、同じ間違いがPermissionErrorとして報告されることが知られています。
Windowsでこのエラーが出たら、メッセージに表示されたパスがファイルではなくフォルダになっていないかを確かめてみてください。パスの組み立て方に不安がある方は、こちらの記事が役に立ちます。 【関連記事】Pythonのpathlibとは?ファイルパス操作を初心者向けに解説
読み取り専用のファイルを書き換えようとした¶
ファイル自体に読み取り専用の設定がついていることもあります。手元でも、書き込み権限を外したファイルに追記しようとすると、Errno 13になりました。
ほかの人から受け取ったファイルや、Gitで管理された一部のファイルなどで起こりがちです。
FileNotFoundErrorやIsADirectoryErrorとの違い¶
PermissionErrorは、同じOSErrorの仲間とまぎらわしいことがあります。違いを知っておくと、原因の切り分けがぐっと速くなります。
それぞれの意味を、次の表に整理しました。
| 例外 | 意味 | まず確かめること |
|---|---|---|
| FileNotFoundError | ファイルやフォルダが見つからない | パスや実行する場所が正しいか |
| PermissionError | 見つかったが権限がない | 権限、ほかのアプリで開いていないか |
| IsADirectoryError | ファイルのつもりがフォルダだった | パスにファイル名まで含めているか |
大事なのは、PermissionErrorが出たときはファイルがちゃんと見つかっているという点です。パスのタイプミスを探すより先に、権限やロックを疑うのが近道になります。
FileNotFoundErrorについては、こちらの記事でくわしく解説しています。 【関連記事】PythonのFileNotFoundErrorとは?No such file or directoryの原因と直し方
PermissionErrorを受け止めるコードの書き方¶
原因がわかったところで、プログラムが急に止まらないようにする書き方を見ていきましょう。基本は、try-exceptでPermissionErrorを受け止めることです。
try-exceptでわかりやすいメッセージを出す¶
次の関数は、レポートを保存できなかったときに、どのファイルでなぜ失敗したのかを表示します。ファイルの保存にはpathlibのwrite_text()を使っています。
from pathlib import Path
def save_report(path, text):
path = Path(path)
try:
path.write_text(text, encoding="utf-8")
except PermissionError as e:
print(f"書き込めませんでした: {e.filename}")
print(f"理由: {e.strerror}(errno={e.errno})")
return False
return True
print(save_report("ro/report.txt", "売上レポート"))
書き込み権限のないroフォルダを用意して実行すると、手元では次のように表示されました。
書き込めませんでした: ro/report.txt
理由: Permission denied(errno=13)
False
利用者向けのツールなら、ここにファイルを閉じてからもう一度実行してください、といった案内を添えると親切です。エラーを握りつぶさず、次に何をすればいいかを伝えることが大切です。
try-exceptの基本の流れや、elseとfinallyの使い方は、こちらの記事でまとめています。 【関連記事】Pythonのtry・except・else・finallyとは?例外処理の基本の流れ
先にos.access()で確かめる方法もある¶
os.access()を使うと、読み書きできるかどうかを事前に調べられます。手元では、os.access('/etc/shadow', os.R_OK) がFalseを返しました。
ただし、調べた直後にほかのアプリがファイルを開くこともあります。確かめてから開くまでのわずかな間に状況が変わるので、事前のチェックだけに頼らず、try-exceptも書いておくのが安全です。
読み取り専用ファイルを削除するときの注意¶
PermissionErrorは、削除のときにもよく出会います。ここはOSによって挙動が大きく違うので、少していねいに見ておきましょう。
LinuxやmacOSでは、ファイルを消せるかどうかはフォルダ側の権限で決まります。手元で試したところ、書き込み権限のないファイルでも、書き込めるフォルダの中にあればos.remove()で削除できました。
一方Windowsでは、読み取り専用の属性がついたファイルを消そうとすると、PermissionErrorになります。フォルダごと消すshutil.rmtree()でも、中に1つでも読み取り専用のファイルがあると途中で止まってしまいます。
この問題への対処法は、Python公式ドキュメントのshutilのページで例として紹介されています。失敗したファイルの読み取り専用を外して、もう一度削除を試みるという方法です。
import os
import shutil
import stat
def remove_readonly(func, path, exc):
os.chmod(path, stat.S_IWRITE)
func(path)
shutil.rmtree("old_output", onexc=remove_readonly)
onexcという引数は、Python 3.12で追加されたものです。3.11以前では、似た役割のonerrorを使います。
ファイルやフォルダのコピー・移動・削除をまとめて学びたい方は、こちらの記事もあわせて読んでみてください。 【関連記事】Pythonのshutilとは?ファイルのコピーや移動、zip圧縮を自動化する基本を初心者向けに解説
やってはいけない対処法¶
最後に、PermissionErrorを手っ取り早く消そうとして、かえって危ない状態を作ってしまう例を紹介します。初心者のうちほど、つい試したくなるものばかりです。
ひとつ目は、管理者権限やsudoで何でも実行してしまうことです。たしかにエラーは消えますが、間違ったパスを指定していた場合に、大切なシステムのファイルまで書き換えてしまう危険があります。
二つ目は、権限をすべて開放してしまうことです。誰でも読み書きできる設定にすると、そのときは動いても、あとで別の問題の原因になります。
三つ目は、except PermissionError: pass で黙って握りつぶすことです。保存されていないことに誰も気づかないまま、処理だけが進んでしまいます。
まずは、どのファイルに、どの操作をしようとして断られたのかをメッセージから読み取りましょう。原因がわかれば、保存先を変える、ファイルを閉じる、必要な権限だけを付けるといった、ちょうどいい対処が選べます。
先ほどのExcelの件のあと、私のチームでは出力ファイル名に日時を付けて、毎回新しいファイルに書き出すように変えました。開きっぱなしのファイルと名前がぶつからないので、それ以来同じ理由で止まったことはありません。
まとめ¶
PermissionErrorは、ファイルやフォルダは見つかったものの、操作する権限がないときに出るエラーです。メッセージのErrno 13やErrno 1という番号と、最後に表示されるファイル名から、何が断られたのかを読み取れます。
よくある原因は、ほかのアプリでファイルを開いたままにしている、書き込めない場所に保存しようとしている、フォルダをopen()しているといった場面です。とくにWindowsでは、ファイルのロックやフォルダの指定ミスもPermissionErrorとして現れます。
対処の基本は、try-exceptで受け止めて、どのファイルでなぜ失敗したのかを伝えることです。管理者権限や権限の全開放で無理やり消すのではなく、原因に合った最小限の対処を選ぶようにしましょう。
エラーの名前と番号をきちんと読む習慣がつけば、PermissionErrorはもう怖くありません。次に出会ったときは、落ち着いて鍵のかかった部屋を探してみてください。
ここまでお読みいただきありがとうございました。