PermissionErrorの基本構造とエラーメッセージの読み方
Python実行中にPermissionErrorが発生すると、処理が中断し、スクリプトが停止します。このエラーは、Python自体のバグではなく、OSがファイルやリソースへのアクセスを拒否したことを意味します。慌てずにエラーメッセージを確認し、どのファイルやディレクトリで問題が生じたかを特定することが解決の第一歩です。
エラーメッセージには通常、以下のような情報が含まれています。
- エラーの種類:
PermissionError - エラーコード: OS依存（Windowsでは13、macOS/Linuxでは13や1など）
- 対象パス: アクセスしようとしたファイルやディレクトリのパス
- 行番号: エラーが発生したソースコードの行
ポイント: エラーメッセージの最後の行にあるパス名が重要です。それが「読み取り」なのか「書き込み」なのか、あるいは「実行」なのかを判断します。
PermissionErrorの基本構造とエラーメッセージの読み方で迷っていませんか？
実例コードも交えながら、つまずきやすいポイントを順番に整理します。
順番に確認できる形でまとめているので、必要なところからすぐ試せます。
エラートレースバックから犯人ファイルを見つける
IDEやターミナルに表示されるトレースバックは上から読んでしまうと混乱しがちですが、一番下の行から逆算して読むと、エラーの起点が明確になります。
- 最後の行で
PermissionErrorを見つける - その直上の行で、どの関数やコマンドが失敗したかを確認する（例:
open(),os.remove(),shutil.copy()） - さらに上の行で、変数に代入されているパスが何なのかを特定する
このプロセスで、「自分が意図したファイルと、実際にアクセスしようとしたファイルが一致しているか」をまずチェックしてください。
原因1 ファイルへの書き込み権限がない
最も頻発する原因は、対象ファイルに対して書き込み権限（Write Permission）がないことです。Pythonスクリプトがファイルを開こうとし、モード'w'や'a'、または既存ファイルの上書きを試みた際に発生します。
OSレベルの権限確認と変更手順
ファイルのプロパティを確認し、現在のユーザーが書き込み可能かを確認します。
Windowsの場合:
- エラー対象のファイルを右クリックし、「プロパティ」を開く
- 「セキュリティ」タブを確認
- 現在のユーザー名がリストにあり、「書き込み」の権限がチェックされているか確認
- 権限がない場合、「編集」ボタンから権限を追加、または「所有者」を変更する
注意: 「読み取り専用」属性が付いている場合、プロパティの「詳細設定」からチェックを外す必要があります。これを見落とすと、権限設定を変えてもエラーが続くことがあります。
macOS/Linuxの場合:
ターミナルで以下コマンドを実行し、権限を確認します。
ls -l /path/to/file.txt出力例: -rw-r--r-- 1 user group 1234 Jan 1 file.txt
先頭の-rw-r--r--のうち、最初の3文字（所有者の権限）にwが含まれているか確認します。含まれていない場合は、chmodコマンドで権限を追加します。
chmod u+w /path/to/file.txtPythonコード内のパス指定ミスによる意図しないアクセス
ファイルが存在しないのではなく、アクセスしたい場所がシステム領域や保護されたディレクトリであるケースです。特に相対パス指定時に、カレントディレクトリの違いで予期せぬ場所に書き込みを試みるとエラーになります。
例えば、スクリプト実行ディレクトリが/Users/username/であり、open('config.txt', 'w')とした場合、/Users/username/config.txtに書き込みを試みます。もしこのディレクトリが保護されていたり、ファイルが他プロセスでロックされていたりするとエラーとなります。
確認すべき点:
os.getcwd()で現在のカレントディレクトリを確認- 絶対パス（
os.path.abspath()）を使用してパスを固定化する - 書き込み対象がシステムディレクトリ（
/usr/local、C:\Program Filesなど）になっていないか確認
原因2 プロセスがファイルをロックしている
ファイル自体には権限があるのにエラーが出る場合、別のプロセスがそのファイルを使用中である可能性が高いです。Windowsでは特に顕著で、ファイルを開いたままの状態（エディタ、Excel、Antivirusスキャンなど）でアクセスしようとすると拒否されます。
Windowsでのファイルロックの確認と解放
Windowsはファイルを排他ロックする傾向が強いため、以下の手順でロック元を特定します。
- Resource Monitorを使用
タスクマネージャー>パフォーマンス>リソースモニターの起動CPUタブ >検索ボックスに対象ファイル名を入力- 検索結果で、どのプロセスがそのファイルを保持しているか確認
関連プロセスの終了
- 検索結果にあるプロセス（例:
excel.exe,code.exe）をタスクマネージャーから終了
再試行
注意: 一部のAntivirusソフトやOneDriveの同期プロセスがファイルをロックしていることがあります。一時的に同期を停止するか、ファイルを一時的な場所にコピーしてから操作を試みましょう。
macOS/Linuxでのプロセス特定と強制終了
macOSやLinuxでは、ファイルロックの概念がWindowsほど厳格ではありませんが、プロセスがファイル記述子を開いている間は操作に失敗することがあります。
# どのプロセスがファイルを使用しているか確認
lsof /path/to/file.txt出力結果のPID（プロセスID）を確認し、必要に応じて終了させます。
kill -9 <PID>ただし、システム重要なプロセスの場合はkillしないよう注意してください。一般的には、ファイルを開いているアプリケーション（Vim, Nano, TextEditor等）を普通に終了させるだけで解決します。
原因3 スクリプト自体の実行権限がない
エラーメッセージに[Errno 13] Permission deniedとあり、かつスクリプトを実行しようとしている場合（特にLinux/macOS）、スクリプトファイル自体に実行権限（Execute Permission）がないことが原因です。
Linux/macOSでのchmod設定と実行環境
ターミナルからpython script.pyではなく、直接./script.pyとして実行しようとした場合、またはスクリプト内でサブプロセスを起動しようとした場合に発生します。
確認コマンド:
ls -l script.py出力にx（実行権限）が含まれていない場合（例: -rw-r--r--）、以下コマンドで権限を追加します。
chmod +x script.pyまた、スクリプトの先頭にシバン（Shebang）が正しく設定されているかも確認します。
#!/usr/bin/env python3ポイント: IDEから実行している場合は、IDEの設定で仮想環境やPythonインタプリタのパスが正しく設定されていないと、間違ったPython実行ファイルを呼び出そうとして権限エラーになることがあります。仮想環境（venv）の有効化を確認してください。
高度な回避策：コンテキストマネージャと一時ファイル
初心者から上級者まで、権限エラーを根本から避けるためのコーディング習慣を紹介します。これらの手法を用いることで、予期せぬ権限エラーやリソースリークを防ぐことができます。
安全なファイル操作のためのwith文の活用
ファイルを操作する際は、必ずwith文を使用してください。with文はファイルを閉じる処理を自動的に行うため、プロセスがファイルを長時間ロックし続ける原因になる「ファイルが開きっぱなし」の状態を防ぎます。
# ❌ 非推奨: 例外発生時にファイルが開いたままになる可能性がある
f = open('data.txt', 'w')
f.write('hello')
# ここで例外が発生すると、f.close()が呼ばれない
# ✅ 推奨: コンテキストマネージャを使用
with open('data.txt', 'w') as f:
f.write('hello')
# ブロックを抜ける際に自動的に閉じられる権限問題を一時的に回避するための一時ファイル戦略
権限の問題が解消せず、かつファイル内容の変更が必要な場合、一時ディレクトリにコピーして操作し、元に戻すという手法が有効です。これは特に、Webアプリケーションやシステムツールなどで、書き込み権限がない共有ディレクトリに対して操作を行う際に役立ちます。
import tempfile
import shutil
import os
src_path = '/protected/dir/file.txt'
tmp_dir = tempfile.mkdtemp()
try:
# 1. 一時ディレクトリにコピー
dst_path = os.path.join(tmp_dir, 'file.txt')
shutil.copy2(src_path, dst_path)
# 2. 一時ファイルに対して処理を実行
with open(dst_path, 'w') as f:
f.write('modified content')
# 3. 必要に応じて元の場所に戻す（権限があれば）
# shutil.move(dst_path, src_path)
except PermissionError as e:
print(f"権限エラーが発生しました: {e}")
finally:
# 4. 一時ディレクトリをクリーンアップ
shutil.rmtree(tmp_dir)この方法により、元のファイルの権限を変更する必要なく、操作を完了できます。
再発防止のためのチェックリスト
PermissionErrorに遭遇した際は、以下の順序でチェックを行いましょう。
- エラーメッセージのパスを確認: 対象ファイルが存在し、正しいファイルか。
- カレントディレクトリを確認:
os.getcwd()で意図した場所から実行されているか。 - ファイルの状態を確認: 読み取り専用属性は付いていないか。他プロセスで開かれていないか。
- 権限を確認:
ls -lやプロパティで、ユーザーに書き込み/実行権限があるか。 - コードを確認:
with文を使用し、適切にリソースを解放しているか。
結論: 権限エラーは環境依存が強く、再現性が低いこともありますが、上記のチェックリストを順番通りに実行することで、9割以上のケースで原因を特定し解決できます。特に「プロセスロック」と「相対パスの間違い」は初心者が最も陥りやすい罠ですので、まずこれらから疑ってください。
FAQ
Windowsで「アクセスが拒否されました」が出るが、管理者権限で実行しても変わらない
管理者権限（コマンドプロンプトを管理者として実行）で解決しない場合、対象ファイルが「システムファイル」や「保護されたオペレーティングシステムファイル」に設定されている可能性があります。また、OneDriveやAntivirusソフトがファイルを監視・ロックしている場合もあります。タスクマネージャーで関連プロセスを確認するか、ファイルを別の場所にコピーして操作するかを試してください。
MacでPermission deniedが出るが、chmodしても変わらない
macOSには「TCC (Transparency, Consent, and Control)」というアクセス許可システムがあります。ターミナルやIDEがディスクのフルアクセス権限を持っていない場合、特定フォルダへのアクセスが拒否されます。システム環境設定 > セキュリティとプライバシー > プライバシー > フルディスクアクセスから、使用しているターミナルアプリやIDEにチェックを入れて許可を与える必要があります。
Dockerコンテナ内でPermissionErrorが発生する
Dockerコンテナ内のユーザー権限と、ホストマウントしたファイルの所有者が一致しないことが原因です。docker run時に-u $(id -u):$(id -g)オプションを追加して、ホストと同じユーザーIDで実行するか、Dockerfile内でUSER指令を調整してください。
Pythonの仮想環境（venv）で権限エラーが出る
仮想環境のフォルダ自体が、作成時の権限によって保護されているか、あるいは仮想環境内のライブラリがシステムPythonと競合している可能性があります。一度仮想環境フォルダを削除し、再作成（python -m venv .venv）してください。
ここまで読んでいただきありがとうございます！
UdemyのPythonコースにはオンラインで学習ができる動画コンテンツがたくさんあります。
当ブログのような文章メインの説明では足りない箇所を補えると思うので、もっと詳しく勉強したいという方はぜひチェックしてみてください！
コメント