GitHub Actions에서 Gradle 실행 권한 문제 해결기

GitHub Actions에서 gradlew 실행 권한 문제 해결기 – chmod +x로도 안될 때 확인할 것들

 

오늘 GitHub Actions에서 ./gradlew 명령을 실행하려는데, 아래와 같은 스텝에서 계속 막혔다.

- name: Grant execute permission for Gradle
  run: chmod +x ./gradlew

근데 Actions 로그에서는 Permission denied 혹은 No such file or directory류의 에러가 나왔다. 이상해서 로컬에서는 정상 작동하는지 확인해봤고, 다음과 같은 사실들을 알게 됐다.

1. gradlew 파일이 Git에 커밋되지 않았음

chmod +x로 권한만 변경했을 경우 Git은 변경을 감지하지 않는다. 그래서 git status에 아무것도 뜨지 않아 git add를 해도 무반응이었다.

🔧 해결 방법:

git update-index --chmod=+x gradlew
git commit -m "Make gradlew executable"
git push

2. .gitignore에 의해 gradlew가 무시되고 있었음

.gitignore에 다음과 같은 패턴이 포함되어 있었다

gradle/
!gradle/wrapper/gradle-wrapper.jar

🔧 해결 방법:

!gradlew
!gradlew.bat

이렇게 명시적으로 예외 처리해주니 해결됐다.

---

💡 Tip
git check-ignore -v gradlew 명령으로 어떤 파일이 무시되고 있는지 추적 가능하다.