Windows下VSCode调试Flutter手机端自动终止无报错求助

问题概况 #

• Windows系统下使用VSCode调试Flutter，连接CPH2239手机时，调试进程无任何报错直接终止，控制台仅显示Launching lib\main.dart on CPH2239 in debug mode...
• Chrome浏览器调试正常，仅手机端调试异常

项目配置代码 #

android\build.gradle #

buildscript {
    ext.kotlin_version = '1.7.10'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

android\app\build.gradle #

plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
}

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

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

android {
    namespace "com.example.intentomalo"
    compileSdkVersion flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId "com.example.intentomalo"
        // You can update the following values to match your application needs.
        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
        minSdkVersion flutter.minSdkVersion
        targetSdkVersion flutter.targetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        release {
            // TODO: Add your own signing config for the release build.
            // Signing with the debug keys for now, so `flutter run --release` works.
            signingConfig signingConfigs.debug
        }
    }
}

flutter {
    source '../..'
}

dependencies {}

排查与解决步骤 #

1. 验证手机调试基础配置 #

• 确认CPH2239已开启开发者选项、USB调试，部分机型需额外开启USB安装权限和USB调试（安全设置）
• 连接电脑后，手机USB用途选择**传输文件（MTP）**或明确标注调试的选项
• 运行flutter devices命令，确认终端能正常识别到CPH2239设备

2. 清理项目缓存并重建 #

• 执行以下命令清理缓存：

  flutter clean
  flutter pub get
  

• 手动删除项目根目录的build文件夹、android目录下的.gradle文件夹
• 重启VSCode后重新尝试调试

3. 检查版本兼容性 #

• 运行flutter doctor，排查Android SDK、Kotlin版本与当前Flutter版本的匹配问题
• 若Flutter版本较新，可将kotlin_version升级至兼容版本（如1.8.20，可参考当前Flutter版本的官方要求）
• 确认local.properties文件已配置正确的Flutter SDK路径，缺失则手动添加：

  flutter.sdk=你的Flutter安装路径
  

4. 调整调试配置与获取详细日志 #

• 在VSCode的.vscode/launch.json中指定设备ID：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Flutter",
              "request": "launch",
              "type": "dart",
              "deviceId": "CPH2239"
          }
      ]
  }
  

• 用终端运行flutter run -v，查看完整调试日志，重点关注Gradle构建阶段的输出，定位隐藏错误

5. 检查手机安装权限 #

• 确认手机已允许安装未知来源应用，Android 11+机型需单独授权当前电脑的安装权限
• 手动卸载手机上已安装的该应用，重新运行调试命令进行安装
• 检查手机隐私设置，确保应用能获取必要的基础权限（如存储、网络）

内容的提问来源于stack exchange，提问作者Shadoww Moon