Spring Boot项目GitHub Actions工作流失败：找不到gradlew文件

常见原因及修复方案 #

1. Gradle wrapper文件未纳入Git版本控制 #

本地存在gradlew和gradlew.bat，但如果没提交到Git仓库，GitHub Actions拉取代码时就会找不到这些文件。执行以下命令提交：

git add gradlew gradlew.bat
git commit -m "提交Gradle wrapper脚本"
git push

2. 工作目录与项目目录不匹配 #

如果你的Spring Boot项目放在仓库的子目录（比如mySpringBootProject/），GitHub Actions默认在仓库根目录执行命令，自然找不到子目录里的gradlew。修改工作流，给相关步骤指定工作目录：

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

- name: Build and Verify Compilation
  run: ./gradlew build --no-daemon --stacktrace
  working-directory: ./mySpringBootProject

- name: Run Tests
  run: ./gradlew test --no-daemon --stacktrace
  working-directory: ./mySpringBootProject

3. Checkout动作未拉取完整代码 #

虽然actions/checkout@v4默认配置正常，但如果存在浅克隆等情况，可能导致文件缺失。可以显式设置拉取完整历史：

- name: Checkout Repository
  uses: actions/checkout@v4
  with:
    fetch-depth: 0

内容的提问来源于stack exchange，提问作者waffledood