使用eas build时Gradle构建报错：路径不可为null或空字符串

问题定位 #

报错指向/home/expo/workingdir/build/android/settings.gradle第10行的空路径问题，本质是Gradle配置文件里出现了无效的空路径引用，通常是Expo预构建或第三方依赖生成的错误配置导致。

具体解决方案 #

• 直接修正settings.gradle文件

  1. 本地执行npx expo prebuild --platform android生成android目录
  2. 打开android/settings.gradle定位到第10行，检查是否存在类似project(':null')、new File(null)或者引用了未定义变量的路径配置
  3. 删除或修正该行的错误配置，比如无效的模块引用直接删掉，路径变量为空则补全正确路径
  4. 提交修正后的代码，重新执行eas build

• 排查第三方依赖问题

  1. 回忆最近是否新增或更新了Native依赖，部分库的Gradle脚本可能存在bug，会生成无效的settings配置
  2. 临时移除可疑依赖，重新执行eas build验证是否恢复正常
  3. 若确认是某依赖的问题，查看该库的官方文档或社区issues，寻找修复方案或替换为其他同类库

• 清理EAS构建缓存
  执行eas build --clear-cache强制清理构建缓存，避免旧的错误配置被复用，之后重新触发构建

• 验证本地构建
  本地进入android目录，执行./gradlew :app:bundleRelease，如果本地能成功完成构建，再推代码到EAS Build，提前排除本地配置问题

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