Expo EAS Android构建时gradle.properties未读取导致构建失败

开发者阿泽

2026-7-30

Expo EAS构建Android时FLIPPER_VERSION未识别的解决方法

报错重现

执行命令eas build --profile release -p android，在'Run Gradlew'步骤报错。报错信息显示于/home/expo/workingdir/build/android/app/build.gradle第309行：无法获取org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler类型对象的'FLIPPER_VERSION'属性。本地构建正常，使用Expo SDK 47。

解决方案

确认项目根目录下的gradle.properties文件已定义FLIPPER_VERSION，示例：
```
FLIPPER_VERSION=0.174.0
```
同时确保该文件未被.gitignore排除，EAS构建需要读取到这个配置文件。
显式在android/app/build.gradle中处理配置项：
在文件开头添加代码，兜底默认版本：
```
def flipperVersion = project.hasProperty('FLIPPER_VERSION') ? project.FLIPPER_VERSION : '0.174.0'
```
随后将文件中所有引用FLIPPER_VERSION的地方替换为flipperVersion，比如依赖声明：
```
debugImplementation "com.facebook.flipper:flipper:$flipperVersion"
```
重置Android构建配置：
执行命令清除旧构建文件并重新生成：
```
expo prebuild --clean
```
提交所有修改后的文件（gradle.properties、android/app/build.gradle等）到版本控制后，再触发EAS构建。
检查EAS配置：
打开eas.json，确认release profile未覆盖gradle相关配置，若不确定可执行eas build:configure重新生成构建配置。