You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter测试App Android端assembleDebug失败,锁文件协议异常

解决Flutter Android端Gradle assembleDebug失败(锁协议不匹配)问题

以下是针对你遇到的「锁文件协议预期3实际0」报错的可行解决步骤:

  • 删除Gradle缓存锁文件
    找到Gradle用户缓存目录:

    • Linux/macOS:~/.gradle/caches
    • Windows:C:\Users\<你的用户名>\.gradle\caches
      删除该目录下的locks文件夹,或者直接清空整个caches目录(注意:清空后首次构建会重新下载所有依赖,耗时会久一点)
  • 核对Gradle版本兼容性
    打开项目的android/build.gradle,检查Gradle插件版本:

    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2' // 示例版本,以你的实际配置为准
    }
    

    再打开android/gradle/wrapper/gradle-wrapper.properties,确认Gradle分发版本和插件版本匹配(比如Gradle 7.x系列对应插件7.x版本)

  • 重启IDE并清理缓存
    在Android Studio/IntelliJ里,点击File -> Invalidate Caches...,勾选Clear file system cache and local history后选择Invalidate and Restart

  • 强制指定Gradle守护进程版本
    在项目根目录的gradle.properties文件里添加(没有就新建):

    org.gradle.daemon=true
    org.gradle.jvmargs=-Xmx2048m
    org.gradle.version=7.5 // 替换为你兼容的Gradle版本
    

注:你的Web和Windows端能正常运行,是因为这两个平台的Flutter构建流程不依赖Android的Gradle缓存环境,所以不会触发这个锁文件的冲突问题。

内容的提问来源于stack exchange,提问作者Swayat D. Cool

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 00:48:19