Jenkins构建Android应用时提示无法安装SDK组件问题求助

• 构建日志明确提示 /home/face/android-sdk/android-sdk 目录无写入权限，Gradle执行构建时自动补全缺失的Android SDK组件失败
• 修改777权限未生效，大概率是遗漏了递归配置、SELinux限制、用户归属三类常见问题

1. 修正SDK目录权限配置 #

首先确认Jenkins运行用户：
ps aux | grep jenkins
默认场景下Jenkins运行用户为jenkins，执行以下命令配置递归权限，比直接全局777更安全：

# 将jenkins用户加入SDK目录所属用户组
chown -R face:jenkins /home/face/android-sdk/android-sdk
chmod -R 775 /home/face/android-sdk/android-sdk

也可以提前手动安装构建所需的SDK组件，避免Gradle自动安装触发权限校验：

cd /home/face/android-sdk/android-sdk/cmdline-tools/latest/bin
./sdkmanager "build-tools;30.0.3" "platforms;android-30"

2. 排查SELinux拦截 #

Linux发行版默认开启的SELinux安全模块会拦截非常规路径的写入请求，即使目录权限为777也会受限：

• 执行命令查看SELinux状态：getenforce
• 若返回Enforcing，临时关闭测试：setenforce 0
• 测试构建正常后，可配置SELinux规则永久放行SDK目录访问：

semanage fcontext -a -t usr_t "/home/face/android-sdk/android-sdk(/.*)?"
restorecon -Rv /home/face/android-sdk/android-sdk

3. 检查目录挂载属性 #

如果SDK目录存放在外接存储、网络挂载分区，可能存在只读挂载限制：

• 执行命令查看挂载属性：mount | grep /home/face
• 若返回结果中存在ro（只读）标识，需重新挂载为可写，或更换SDK存放路径至Jenkins工作目录下。

4. （可选）Jenkins专属SDK配置 #

如果共用全局SDK仍存在权限冲突，可单独为Jenkins配置专属SDK目录：

1. 将对应版本的SDK文件复制到/var/lib/jenkins/android-sdk路径下
2. 修改目录所有者为jenkins用户：chown -R jenkins:jenkins /var/lib/jenkins/android-sdk
3. 在Jenkins全局配置中更新Android SDK路径为上述专属路径即可。

配置完成后执行以下命令测试写入权限：
su -s /bin/bash jenkins -c "touch /home/face/android-sdk/android-sdk/test.txt && rm /home/face/android-sdk/android-sdk/test.txt"
无报错即为权限配置生效，重新触发Jenkins构建即可。

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