Ionic3 Android构建报错：Gradle锁等待超时，求助解决方案

我之前在High Sierra环境下也碰到过几乎一模一样的Gradle锁和服务创建失败问题，结合你的日志和已经尝试过的操作，给你几个针对性的解决方案，应该能彻底解决问题：

1. 彻底清理Gradle残留进程与缓存 #

你之前删除锁文件的操作可能不够彻底，Gradle守护进程很可能还在后台残留，导致锁一直无法释放：

• 先杀掉所有Gradle和Java相关进程：

  pkill -f gradle
  pkill -f java
  

• 删除项目内的Gradle缓存目录：

  rm -rf /Path/to/myapp/platforms/android/.gradle
  

• 同时清理全局Gradle缓存（避免旧缓存干扰新构建）：

  rm -rf ~/.gradle/caches
  

2. 修复Android SDK路径冲突 #

从你的日志里能看到Observed package id 'tools' in inconsistent location的警告，这会直接导致Gradle加载服务时出错：

• 删除冲突的tools备份目录：

  rm -rf /Users/myAccount/Library/Android/sdk/tools_back
  

• 检查并修复ANDROID_HOME环境变量：
  打开你的终端配置文件（~/.bash_profile或~/.zshrc），确保内容如下：

  export ANDROID_HOME=/Users/myAccount/Library/Android/sdk
  export PATH=$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools:$PATH
  

  保存后运行source ~/.bash_profile（或对应的zshrc文件）让配置生效。

3. 指定兼容High Sierra的Gradle版本 #

你当前使用的Gradle 4.1在High Sierra上兼容性不佳，建议换成更稳定的4.10.3版本：

• 在项目根目录创建build-extras.gradle文件，添加以下内容：

  task wrapper(type: Wrapper) {
      gradleVersion = '4.10.3'
  }
  

• 进入platforms/android目录，更新Gradle wrapper：

  cd /Path/to/myapp/platforms/android
  ./gradlew wrapper
  

• 或者直接在config.xml里添加配置，让Cordova自动使用指定Gradle版本：

  <preference name="gradleVersion" value="4.10.3" />
  

4. 调整文件权限（High Sierra权限机制更严格） #

High Sierra对文件权限的管控更严格，可能导致Gradle无法写入缓存文件：

• 给项目目录和Android SDK目录赋予正确权限：

  chmod -R 755 /Path/to/myapp
  sudo chown -R $USER:$USER /Path/to/myapp
  chmod -R 755 /Users/myAccount/Library/Android/sdk
  sudo chown -R $USER:$USER /Users/myAccount/Library/Android/sdk
  

5. 重新构建项目 #

完成以上步骤后，按以下流程重新构建：

# 移除并重新添加兼容Ionic3的Android平台版本
ionic cordova platform rm android
ionic cordova platform add android@7.1.4

# 清理npm和Ionic缓存
npm cache clean --force
ionic cache clean

# 重新运行构建（加--verbose方便排查后续问题）
ionic cordova run android --device --verbose

这些步骤核心是解决High Sierra的权限限制、SDK路径冲突，以及旧Gradle版本的兼容性问题，应该能解决你遇到的Gradle服务创建失败和锁超时问题。

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