配置多flavorDimensions时出现':app'项目配置失败错误如何解决

单个flavorDimension配置时，Gradle会默认将所有未指定dimension的产品风味自动归属到该唯一维度下，因此不会触发配置冲突。当配置多个flavorDimension后，所有productFlavor都必须显式声明所属的维度，否则就会抛出项目配置失败的错误，展开完整同步日志通常会看到明确提示：All flavors must now belong to a named flavor dimension.

• 首先确认声明的flavor维度符合需求，维度的排列顺序决定了变体合并的优先级，排在前面的维度优先级更高，示例多维度声明代码：

// 示例声明两个维度：渠道、运行环境，渠道维度优先级高于环境维度
flavorDimensions("channel", "environment")

• 每一个productFlavor必须显式指定dimension属性，取值必须和flavorDimensions中声明的字符串完全一致（大小写敏感），完整示例配置：

flavorDimensions("channel", "environment")

productFlavors {
    // 渠道维度下的风味
    huawei {
        dimension "channel"
        // 可添加对应渠道的专属配置，如应用ID后缀、版本号等
        applicationIdSuffix ".huawei"
    }
    xiaomi {
        dimension "channel"
        applicationIdSuffix ".xiaomi"
    }
    // 运行环境维度下的风味
    dev {
        dimension "environment"
        buildConfigField "boolean", "IS_DEBUG", "true"
    }
    prod {
        dimension "environment"
        buildConfigField "boolean", "IS_DEBUG", "false"
    }
}

• 如果需要过滤不需要的变体组合，避免生成无用的构建项，可以添加变体过滤逻辑：

android.variantFilter { variant ->
    // 示例：过滤小米渠道的测试环境变体
    def flavorNames = variant.flavors*.name
    if (flavorNames.contains("xiaomi") && flavorNames.contains("dev")) {
        setIgnore(true)
    }
}

• 配置完成后清理缓存重新同步：点击Android Studio菜单栏 File -> Invalidate Caches -> Invalidate and Restart，重启后重新执行Gradle同步即可。

• Gradle 7.0及以上版本强制要求所有productFlavor必须指定dimension，哪怕只有一个维度也建议显式配置，避免兼容问题。
• 如果同步仍报错，优先查看Gradle同步面板的完整错误栈，可快速定位到具体哪一个风味未正确配置维度属性。

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