Flutter项目Gradle构建报错：无法创建processDevDebugMainManifest任务

错误概述 #

Gradle构建失败，核心报错：

无法确定任务:app:processDevDebugManifest的依赖项，无法创建任务:app:processDevDebugMainManifest
触发空指针：Cannot invoke "Object.toString()" because "value" is null

关键堆栈指向VariantDslInfoImpl.kt:854，明确是manifestPlaceholders中存在空值导致。

已尝试无效操作（供参考） #

• 升级Flutter/Dart/Gradle至最新版本
• 执行flutter clean、flutter pub get、flutter pub upgrade
• 重启开发环境及系统
• 对比正常项目的AndroidManifest.xml与build.gradle
• 排查可疑依赖

针对性排查与修复步骤 #

1. 检查本地manifestPlaceholders配置 #

打开android/app/build.gradle，逐一核对defaultConfig、buildTypes、productFlavors下的manifestPlaceholders，确保所有键值对的值不为null/未定义：

android {
    defaultConfig {
        manifestPlaceholders = [
            APP_ID: "com.example.yourapp",
            // 禁止出现类似 SOME_KEY: null 或未赋值的变量
            VALID_KEY: "actual_value"
        ]
    }

    // 同时检查Flavor配置（比如dev flavor）
    productFlavors {
        dev {
            manifestPlaceholders += [ENV: "development"]
        }
    }
}

2. 排查第三方插件注入的占位符 #

部分Flutter插件会自动向manifestPlaceholders注入参数，若插件未正确配置（比如缺少必填参数），会导致空值：

• 查看pubspec.yaml中的依赖列表，逐一核对插件文档，确认是否需要手动配置manifest参数
• 临时注释可疑插件，重新执行构建，定位问题插件后调整其配置

3. 校验gradle.properties变量引用 #

如果manifestPlaceholders引用了gradle.properties中的变量，确保这些变量已正确定义且非空：

# gradle.properties中需明确赋值
APP_VERSION=1.0.0

避免manifestPlaceholders = [VERSION: APP_VERSION]中APP_VERSION未定义的情况。

4. 调试打印占位符内容 #

在android/app/build.gradle中添加调试代码，直接输出所有占位符内容，快速定位空值项：

android {
    defaultConfig {
        println("=== Manifest Placeholders Debug ===")
        manifestPlaceholders.each { key, value ->
            println("$key: $value | Type: ${value?.class?.simpleName}")
        }
    }
}

执行对应flavor的构建命令（如flutter build apk --flavor dev --debug），查看控制台输出，找到值为null的键并修复。

内容的提问来源于stack exchange，提问作者Daniel Marmor