できない.dev

Gradle「./gradlew: Permission denied」の原因と直し方

./gradlew: Permission denied は、gradlew に実行権限を付ければ直る。
Windows で追加した gradlew は実行ビットなしで Git に記録されるので、git update-index --chmod=+x で記録し直す。

公開: 更新:

症状できない · exit 126
./gradlew build
bash: line 1: ./gradlew: Permission denied
解決後できた · exit 0
sh gradlew --version
…
Ant:           Apache Ant(TM) version 1.10.17 compiled on April 6 2026
Launcher JVM:  21.0.13 (Eclipse Adoptium 21.0.13+9-LTS)
Daemon JVM:    /opt/java/openjdk (no Daemon JVM specified, using current Java home)
OS:            Linux 6.6.87.2-microsoft-standard-WSL2 amd64

2026-10-31 に gradle:jdk21(Python 3.14.4 / Git 2.53.0) で実際に打って取った出力。検証環境の詳細

要約

Gradle Wrapper の gradlew を実行すると、Gradle が動く前にシェルが止める。
Gradle 9.8.1 の gradle wrapper で作った gradlew から実行ビットを外して、bash で実行すると次のように出た。

$ ./gradlew build
bash: ./gradlew: Permission denied
$ ls -l gradlew
-rw-r--r-- 1 user user 8656 Oct 20 01:01 gradlew

./gradlew: Permission denied は、gradlew に実行権限が無いという意味だ。
Gradle の設定やバージョンの問題ではない。
終了コードは 126 になる。
gradlew はシェルスクリプトなので、実行ビット(x)が無いと ./gradlew の形では起動できない。

手元では動くのに CI だけで落ちるなら、Git に記録されている gradlew のモードを疑う。
公式ドキュメントのとおり Wrapper のファイルはリポジトリにコミットして共有するものなので(Gradle Wrapper(新しいタブで開く))、記録された時点で実行ビットが落ちていると、clone したすべての環境で同じエラーになる。

実行例

gradle:jdk21 のコンテナで core.fileMode=false のまま追加した gradlew は、100644 で記録され、clone 後の ./gradlew が終了コード 126 の Permission denied になる。
git update-index --chmod=+x で 100755 に記録し直して clone し直すと、./gradlew --version が通る。

$ git config core.fileMode false
$ git add .
$ git commit -q -m "add gradle wrapper"
$ ls -l gradlew
-rwxr-xr-x 1 root root 8656 Oct 31 23:37 gradlew
$ git ls-files -s gradlew
100644 249efbb032ce46a80c687c0723eb172e85f6a136 0	gradlew
$ git clone -q app ci-checkout
$ ls -l gradlew
-rw-r--r-- 1 root root 8656 Oct 31 23:37 gradlew
$ ./gradlew build
bash: line 1: ./gradlew: Permission denied
$ echo $?
126
$ sh gradlew --version
------------------------------------------------------------
Gradle 9.8.2
------------------------------------------------------------
 
Build time:    2026-10-19 16:29:26 UTC
Revision:      8de7bcf76e785507ad92f0741ab9235a430c95e6
 
Kotlin:        2.4.10
Groovy:        4.0.33
Ant:           Apache Ant(TM) version 1.10.17 compiled on April 6 2026
Launcher JVM:  21.0.13 (Eclipse Adoptium 21.0.13+9-LTS)
Daemon JVM:    /opt/java/openjdk (no Daemon JVM specified, using current Java home)
OS:            Linux 6.6.87.2-microsoft-standard-WSL2 amd64
$ echo $?
0
$ chmod +x gradlew
$ ./gradlew --version
------------------------------------------------------------
Gradle 9.8.2
------------------------------------------------------------
 
Build time:    2026-10-19 16:29:26 UTC
Revision:      8de7bcf76e785507ad92f0741ab9235a430c95e6
 
Kotlin:        2.4.10
Groovy:        4.0.33
Ant:           Apache Ant(TM) version 1.10.17 compiled on April 6 2026
Launcher JVM:  21.0.13 (Eclipse Adoptium 21.0.13+9-LTS)
Daemon JVM:    /opt/java/openjdk (no Daemon JVM specified, using current Java home)
OS:            Linux 6.6.87.2-microsoft-standard-WSL2 amd64
$ echo $?
0
$ git update-index --chmod=+x gradlew
$ git ls-files -s gradlew
100755 249efbb032ce46a80c687c0723eb172e85f6a136 0	gradlew
$ git commit -q -m "make gradlew executable"
$ git show --summary --format= HEAD
 mode change 100644 => 100755 gradlew
$ git clone -q app ci-checkout2
$ ls -l gradlew
-rwxr-xr-x 1 root root 8656 Oct 31 23:37 gradlew
$ ./gradlew --version
------------------------------------------------------------
Gradle 9.8.2
------------------------------------------------------------
 
Build time:    2026-10-19 16:29:26 UTC
Revision:      8de7bcf76e785507ad92f0741ab9235a430c95e6
 
Kotlin:        2.4.10
Groovy:        4.0.33
Ant:           Apache Ant(TM) version 1.10.17 compiled on April 6 2026
Launcher JVM:  21.0.13 (Eclipse Adoptium 21.0.13+9-LTS)
Daemon JVM:    /opt/java/openjdk (no Daemon JVM specified, using current Java home)
OS:            Linux 6.6.87.2-microsoft-standard-WSL2 amd64
$ echo $?
0

— 2026-10-31 時点の出力

検証環境Python 3.14.4 / Git 2.53.0 / 2026-10-31 検証
検証日
実行環境
gradle:jdk21 Ubuntu 26.04.1 LTS
バージョン
  • Python 3.14.4
  • Git 2.53.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 手元で実行権限を付ける

chmod +x gradlew
./gradlew build

2. 実行ビットを Git に記録する

CI で落ちる場合は、手元の chmod だけでは直らない。
git update-index --chmod=+x で、Git に記録されているモードを変えてコミットする(git-update-index(新しいタブで開く))。
Windows の Git(Git for Windows 2.48)でも、この方法で 100755 に変わった。

git update-index --chmod=+x gradlew
git ls-files -s gradlew
git commit -m "gradlew を実行可能にする"
git push

git ls-files -s gradlew の先頭が 100644 から 100755 に変われば記録できている。
コミットには mode change 100644 => 100755 gradlew と出る。
この後に clone し直した gradlew は -rwxr-xr-x になり、./gradlew --version が通った。

3. 権限を変えられないときは sh から起動する

読み取り専用の場所などで権限を変えられないときは、sh に gradlew を渡して起動する。
実行ビットの無い gradlew でも、sh gradlew --version は終了コード 0 で通った。

sh gradlew build

CI の設定に chmod +x gradlew のステップを足しても動くが、それは毎回の一時しのぎになる。
リポジトリ側の記録を直しておけば、どの環境でも ./gradlew のまま動く。

よくある原因

  1. Windows でコミットした。
    Windows の Git では、git init や git clone のときに core.fileMode が false に設定される(Git for Windows 2.48 で確認)。
    この設定のまま新しく追加したファイルは、ディスク上で実行可能かどうかに関係なく 100644(実行ビットなし)で記録される。
    Linux の Git で core.fileMode=false にして gradlew を追加したところ、実行可能な gradlew でも 100644 で記録された。
  2. それを clone した。
    記録が 100644 なら、Linux や macOS、GitHub Actions のような CI で clone した gradlew は -rw-r--r-- になる。
  3. 手元で実行ビットが外れた。
    ファイルのコピーや展開の仕方によっては、実行ビットが付かないことがある。

core.fileMode は、作業ツリーのファイルの実行ビットを Git が信用するかどうかの設定である(git-config(新しいタブで開く))。