在Gradle文件中添加Retrofit与Gson依赖时遇未解析引用错误求助

我是Android开发新手，在Android Studio的模块Gradle文件中添加Retrofit和Gson的implementation依赖后，出现了未解析引用错误。以下是我的Gradle文件代码及错误信息：

Gradle文件代码 #

plugins {
    alias(libs.plugins.androidApplication)
    alias(libs.plugins.jetbrainsKotlinAndroid)
}

android {
    namespace = "com.example.api"
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.api"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {

    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.appcompat)
    implementation(libs.material)
    implementation(libs.androidx.activity)
    implementation(libs.androidx.constraintlayout)
    testImplementation(libs.junit)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
    implementation(com.squareup.retrofit2:retrofit:2.9.0)
    implementation(com.squareup.retrofit2:converter-gson:2.9.0)
}

错误信息 #

未解析引用: com
无法访问'squareup'，检查模块声明

问题原因 #

你添加Retrofit依赖时，直接用了implementation(com.squareup.retrofit2:retrofit:2.9.0)这种写法。在当前使用**版本目录（libs.versions.toml）**的Gradle配置中，这种未用字符串包裹的依赖坐标会被识别为代码引用，而非依赖声明，导致无法解析。

修复方案 #

方案1：直接修正依赖写法（快速解决）

将dependencies中的两行Retrofit依赖改为字符串包裹的形式：

implementation("com.squareup.retrofit2:retrofit:2.9.0")
implementation("com.squareup.retrofit2:converter-gson:2.9.0")

方案2：使用版本目录管理（推荐，符合项目规范）

1. 打开项目根目录下的libs.versions.toml文件
2. 在[versions]块添加Retrofit版本号：

   retrofit = "2.9.0"
   

3. 在[libraries]块添加Retrofit相关依赖：

   retrofit = { group = "com.squareup.retrofit2", name = "retrofit", version.ref = "retrofit" }
   retrofit-converter-gson = { group = "com.squareup.retrofit2", name = "converter-gson", version.ref = "retrofit" }
   

4. 回到模块Gradle文件，修改依赖为：

   implementation(libs.retrofit)
   implementation(libs.retrofit.converter.gson)
   

最后一步 #

修改完成后，点击Android Studio右上角的「Sync Project with Gradle Files」按钮，等待Gradle同步完成，错误即可消失。

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