Android Studio迁移ConstraintLayout至AndroidX后构建失败求助

AI 小北

2026-6-23

问题分析与修复方案

问题根源

是的，gradle/libs.versions.toml中引用旧版com.android.support.constraint:constraint-layout就是导致构建冲突的核心原因。这个旧依赖会引入com.android.support:support-compat库，和你项目中使用的AndroidX库（如androidx.core:core）产生appComponentFactory属性冲突，这就是你看到两次构建错误的来源。

修复步骤

1. 更新libs.versions.toml中的ConstraintLayout依赖

打开gradle/libs.versions.toml文件，找到[libraries]下的constraint-layout条目，替换为AndroidX版本的依赖：

[libraries]
# 替换旧support版本为AndroidX版本
constraint-layout = { module = "androidx.constraintlayout:constraintlayout", version.ref = "constraintLayoutVersion" }

同时确保[versions]部分的版本号为兼容AndroidX的稳定版，比如：

[versions]
constraintLayoutVersion = "2.1.4"

2. 清理模块级build.gradle.kts中的重复依赖

你的模块级build.gradle.kts中存在重复的ConstraintLayout依赖声明，删除重复的错误行：

dependencies {
    implementation(libs.appcompat)
    implementation(libs.material)
    implementation(libs.constraintlayout)
    implementation(libs.navigation.fragment)
    implementation(libs.navigation.ui)
    testImplementation(libs.junit)
    androidTestImplementation(libs.ext.junit)
    androidTestImplementation(libs.espresso.core)
    // 删除下面这行重复且错误的依赖
    // implementation(libs.constraint.layout)
}