Flutter项目Android Studio构建Release APK时lintVitalRelease任务失败

报错根因定位 #

从构建日志可直接确认失败触发点：

• 执行失败的Gradle任务为:app:lintVitalRelease，即Release构建阶段的代码合规性扫描任务
• 直接报错原因：构建进程无法删除旧的lint扫描结果文件，路径为C:\Users\Best Computers\StudioProjects\shoes\build\app\reports\lint-results-release-fatal.html
• 日志开头提示的「参数格式不正确 -」异常，大概率和Windows本地路径含空格、Gradle进程缓存损坏、文件被占用有关。

按优先级操作解决 #

• 第一步：全量清理构建缓存
  先彻底关闭Android Studio，打开任务管理器结束所有后台运行的java、gradle、dart相关进程，避免文件锁冲突。手动删除项目根目录下整个build文件夹，再依次执行以下命令：

  # 进入android目录执行Gradle清理
  cd android
  gradlew clean
  # 回到项目根目录执行Flutter清理
  cd ..
  flutter clean
  flutter pub get
  

  清理完成后重新尝试构建Release包，80%以上的同类文件占用/缓存类问题都能通过这一步解决。
• 第二步：排查文件占用与权限问题
  检查报错路径下的lint报告html文件是否被其他程序打开占用：比如是否用浏览器、记事本打开过该报告未关闭，是否有杀毒软件正在扫描项目目录，全部关闭对应程序、暂时关闭杀毒软件实时防护后重试。
  右键点击项目根目录文件夹，选择「属性-安全-编辑」，给当前Windows登录用户勾选「完全控制」权限，保存后重试。
  *注意：当前项目路径中Best Computers包含空格，是Windows下触发Gradle参数格式错误的常见诱因，如果上述操作无效，直接把项目移动到无空格、无中文的纯英文路径下（例如D:\dev\shoes）再重新构建。
• 第三步：应急绕过lint检查（仅临时打包用，不建议长期配置）
  如果清理缓存后仍然卡在lint任务，可以打开android/app/build.gradle文件，在android配置块中添加以下规则，跳过Release构建阶段的lint扫描中断：

  android {
      // 原有配置保持不动，新增以下内容
      lintOptions {
          checkReleaseBuilds false
          abortOnError false
      }
  }
  

  配置完成后同步Gradle，重新构建即可。
• 第四步：获取详细日志定位深层问题
  以上方案都无效时，在项目根目录执行带调试参数的构建命令，输出完整错误堆栈定位具体问题：

  flutter build apk --release --stacktrace --debug
  

内容的提问来源于stack exchange，提问作者faizy 313