如何解决Flutter中Gradle构建抛出异常导致失败的问题

问题根因 #

该报错核心原因为C:\hello_everyone\android\app\build.gradle文件第一行存在语法错误，调用Properties构造方法时遗漏了new关键字，Gradle无法识别无参的Properties()方法，因此在评估:app项目时抛出异常。

修复步骤 #

• 打开上述路径下的build.gradle文件，定位到第一行代码
• 若当前第一行写法为def properties = Properties()，直接修改为def properties = new Properties()即可
• 若你是为了读取local.properties配置，完整的正确代码参考如下：

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

• 修改保存后重新执行Flutter构建命令，即可正常编译。

异常残留排查方案 #

若修改后仍存在报错，按以下顺序操作：

• 检查build.gradle文件编码格式是否为UTF-8，排除编码异常导致的语法识别错误
• 执行flutter clean清理项目缓存，再重新执行构建命令
• 核对当前使用的Gradle版本与Flutter SDK版本适配性，避免版本不兼容导致的语法不支持问题

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