Permission denied to github-actions[bot]の解決方法【2025年最新版】

エラーの概要・症状
このエラーが発生する原因
解決方法1（最も効果的）
1. 手順1-1: ワークフローファイルの権限設定を確認
2. 手順1-2: ワークフローファイルの修正

エラーの概要・症状

エラーメッセージ「Permission denied to github-actions[bot]」は、GitHub Actionsを使用している際に発生することがあります。このエラーは、GitHub Actionsがリポジトリに対して必要な権限を持っていない場合に表示されます。具体的には、GitHub Actionsがコードをプッシュしようとしたり、ドキュメントを更新しようとした際に、権限が不足しているために操作が拒否されます。

このエラーが発生すると、リポジトリの自動更新やビルドプロセスが中断され、開発の効率が低下する可能性があります。また、エラーメッセージだけでは具体的な原因を特定できないため、開発者にとっては非常に困難な状況となります。

このエラーが発生する原因

「Permission denied to github-actions[bot]」エラーが発生する主な原因は以下の通りです。

ワークフローファイルの権限設定: GitHub Actionsのワークフローファイルで、必要な権限が正しく設定されていないことがあります。デフォルトでは、GitHub Actionsにはリポジトリへの書き込み権限が付与されません。これにより、プッシュやコミットが拒否されることがあります。
トークンの使用方法: GitHub Actionsでは、デフォルトで使用されるGITHUB_TOKENが特定の権限スコープを持っています。このトークンを使用して他のリポジトリにプッシュすることはできず、Personal Access Token（PAT）が必要な場合があります。
ワークフローのトリガー: プルリクエストや外部からのコミットに対して、GitHub Actionsの設定によっては権限が制限されることがあります。特に、フォークからのプルリクエストではさらに厳しい制約があります。
SSHキーの設定: SSHを使用してリポジトリにアクセスする場合、適切なSSHキーが設定されていないと権限エラーが発生します。特にCI/CD環境においては、SSHキーの生成と設定が必要です。
リポジトリの設定: リポジトリの設定によっては、GitHub Actionsによるアクセスが制限されている場合があります。これには、リポジトリのプライバシー設定や外部アクセスの制限が含まれます。

解決方法1（最も効果的）

手順1-1: ワークフローファイルの権限設定を確認

GitHubのリポジトリにアクセスし、上部メニューから「Settings」をクリックします。
左側のメニューから「Actions」を選択し、「General」タブを選びます。
「Workflow permissions」の項目を確認します。ここで「Read and write permissions」が選択されていることを確認してください。

手順1-2: ワークフローファイルの修正

以下のように、ワークフローファイルに明示的に権限を追加します。この例では、内容に書き込み権限を与えています。