无法通过Gradle引入GitLab Maven包仓库依赖的问题求助

我已在GitLab创建Maven包仓库，库模块的build.gradle配置了如下发布脚本：

publishing {
    publications {
        create<MavenPublication>("fancytoaster") { // Use components["java"] to reference the Java component
            groupId = "com.gitlab.afaqrehman98"// Replace with your group ID
            artifactId = "fancytoaster" as String// Replace with your artifact ID
            version = "1.0.0" // Replace with your version
        }
    }
    repositories {
        maven {
            url = uri("https://gitlab.com/api/v4/projects/PROJECT_ID/packages/maven")
            credentials(HttpHeaderCredentials::class) {
                name = "Authorization"
                value = "Bearer ${findProperty("gitLabPrivateToken") as String?}"
            }
            authentication {
                create("header", HttpHeaderAuthentication::class)
            }
        }
    }
}

在需要引入依赖的消费项目中，我已完成以下配置：

1. 应用级build.gradle添加依赖：

dependencies {
    implementation("com.gitlab.afaqrehman98:fancytoaster:1.0.0")
}

2. settings.gradle的repositories块添加Maven地址：

maven("https://gitlab.com/api/v4/projects/PROJECT_ID/packages/maven")

但项目同步后，仍无法获取仓库中的目标方法。对应的GitLab仓库为afaqrehman98/fancytoaster。

排查与解决步骤 #

1. 确认包已成功发布到GitLab #

• 登录GitLab进入对应项目，打开Packages and registries -> Maven Repository，检查com.gitlab.afaqrehman98:fancytoaster:1.0.0是否存在，且包含完整的jar包（可选包含sources/javadoc包）。
• 若包未发布，执行发布命令：./gradlew publish，确保控制台无报错。

2. 替换URL中的PROJECT_ID为实际项目数字ID #

• GitLab Maven仓库URL里的PROJECT_ID必须替换为项目的数字ID（不是仓库名称），可在项目主页的Settings -> General -> Project ID中查看。
• 发布脚本和消费项目的settings.gradle中都要替换该值。

3. 私有仓库需添加认证信息 #

• 如果GitLab项目是私有仓库，消费项目访问时必须携带认证信息，否则会被拒绝访问。在消费项目的settings.gradle中完善仓库配置：

maven {
    url = uri("https://gitlab.com/api/v4/projects/你的项目数字ID/packages/maven")
    credentials(HttpHeaderCredentials::class) {
        name = "Authorization"
        value = "Bearer 你的GitLab私有令牌"
    }
    authentication {
        create("header", HttpHeaderAuthentication::class)
    }
}

• 私有令牌需拥有read_api和read_repository权限，可在GitLab个人设置的Access Tokens中创建。

4. 修复发布脚本的组件关联问题 #

• 原发布脚本仅配置了坐标，但未关联Java组件，导致发布的包可能为空。修改发布脚本：

create<MavenPublication>("fancytoaster") {
    groupId = "com.gitlab.afaqrehman98"
    artifactId = "fancytoaster"
    version = "1.0.0"
    from(components["java"]) // 关联Java组件，确保打包包含代码
}

• 重新执行./gradlew publish，覆盖原包或发布新版本。

5. 清理缓存并重新同步 #

• 执行命令清理Gradle缓存：./gradlew clean build --refresh-dependencies
• 重启IDE后重新同步项目，检查依赖是否加载成功。

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