Android项目无法找到Maven本地.m2仓库中的Jar包问题求助

1. 修正Maven仓库路径不一致问题 #

你在项目级build.gradle里配置的本地仓库路径是file:/home/{MY_USERNAME}/.m2/repository/，但实际本地仓库位于Mac系统的/Users/{MY_USERNAME}/.m2/repository/，路径完全不匹配。直接删除buildscript里多余的mavenCentral本地配置即可——settings.gradle中已经配置了mavenLocal()，它会自动读取系统默认的.m2路径：

buildscript {
    repositories {
        mavenLocal()
        mavenCentral()
    }
}

2. 完善KMP项目的Maven发布配置 #

仅添加maven-publish插件不足以生成Android端可识别的产物，需要明确配置发布规则。在KMP共享项目的build.gradle（或build.gradle.kts）中补充如下配置：

plugins {
    kotlin("multiplatform")
    id("maven-publish")
}

kotlin {
    android {
        publishLibraryVariants("release")
    }
    // 其他平台配置（如JVM、iOS等）...

    publishing {
        publications {
            // Android平台发布配置
            create<MavenPublication>("release") {
                from(components["release"])
                groupId = "mylibrary"
                artifactId = "nameOfMyLibrary"
                version = "1.0"
            }
            // JVM平台发布配置（若需支持）
            create<MavenPublication>("jvm") {
                from(components["jvm"])
                groupId = "mylibrary"
                artifactId = "nameOfMyLibrary-jvm"
                version = "1.0"
            }
        }
    }
}

重新执行发布命令：

./gradlew clean publishToMavenLocal

3. 验证依赖坐标与Maven文件匹配 #

打开.m2目录下的nameOfMyLibrary-1.0.pom文件，确认groupId、artifactId、version三个字段和Android项目中添加的依赖完全一致。例如若pom文件里的groupId是com.mycompanyname，则依赖应写成：

implementation "com.mycompanyname:nameOfMyLibrary:1.0"

4. 清理Gradle缓存并重新同步 #

• 执行命令清理本地缓存：

./gradlew clean build --refresh-dependencies

• 在Android Studio中点击File -> Invalidate Caches...，选择Invalidate and Restart。

5. 排查离线模式影响 #

启用离线模式后，Gradle仅会从本地仓库读取依赖。需确保.m2目录下的库文件完整无损坏——可尝试手动打开JAR/AAR文件，确认内部包含目标类文件。

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