如何将Gradle项目对Maven构件的依赖重定向到同构建内其他Gradle项目？

当然有办法实现这个需求！Gradle本身就提供了**依赖替换（Dependency Substitution）**机制，完美匹配你想要的效果：用标准Maven坐标声明依赖，但优先使用本地构建中匹配坐标的项目产物，无需硬编码project(':xyz')这类项目路径，也不用依赖本地项目必须存在才能构建。

核心实现方案：Dependency Substitution #

这个机制允许你在构建配置中定义规则，当Gradle解析某个Maven坐标依赖时，自动替换成同一构建内的指定项目产物。如果本地没有匹配的项目，Gradle会正常从配置的远程仓库拉取依赖，完全不影响原有逻辑。

配置示例（Groovy DSL） #

你可以在根项目的settings.gradle中全局配置替换规则，这样所有子项目都会生效：

dependencyResolutionManagement {
    repositories {
        mavenCentral()
        // 其他仓库配置
    }

    dependencySubstitution {
        // 方式1：单个依赖的精确替换
        substitute module('com.example:xyz') with project(':xyz')

        // 方式2：批量替换（自动匹配groupId+moduleName对应的本地项目）
        all { DependencySubstitution substitution ->
            if (substitution.requested instanceof ModuleComponentSelector) {
                def requestedModule = substitution.requested
                // 假设本地项目路径和模块名一致（比如:xyz对应com.example:xyz）
                def targetProjectPath = ":${requestedModule.module}"
                
                // 检查本地是否存在该项目
                if (gradle.rootProject.findProject(targetProjectPath) != null) {
                    substitution.useTarget project(targetProjectPath)
                }
            }
        }
    }
}

自定义映射规则（如果项目路径和模块名不一致） #

如果你的本地项目路径和Maven模块名不匹配，可以通过映射表自定义替换关系：

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }

    dependencySubstitution {
        // 自定义模块到项目路径的映射
        def moduleProjectMap = [
            'com.example:foo-service': ':my-foo-project',
            'com.example:bar-utils': ':utils-bar'
        ]

        all { DependencySubstitution substitution ->
            if (substitution.requested instanceof ModuleComponentSelector) {
                def moduleId = "${substitution.requested.group}:${substitution.requested.module}"
                def targetPath = moduleProjectMap[moduleId]
                
                if (targetPath != null && gradle.rootProject.findProject(targetPath) != null) {
                    substitution.useTarget project(targetPath)
                }
            }
        }
    }
}

效果验证 #

配置完成后，当你在子项目中声明依赖时，直接用标准Maven坐标即可：

// 子项目 build.gradle
dependencies {
    implementation 'com.example:xyz:1.0.0'
}

• 如果本地构建中存在:xyz项目，Gradle会自动使用该项目的构建产物，不会去远程仓库下载。
• 如果:xyz项目不在本地构建中，Gradle会正常从mavenCentral()拉取com.example:xyz:1.0.0依赖。

优势说明 #

• 低耦合：无需在依赖声明中硬编码项目路径，各个子项目的依赖保持标准Maven坐标形式，降低模块间的耦合。
• 灵活性：本地项目存在时优先使用本地产物，不存在时自动 fallback 到远程仓库，适配多种开发场景（比如部分模块临时从本地移除，或者团队成员只拉取部分子项目）。
• 优先级高于仓库：依赖替换规则的优先级高于仓库查找，完全满足你“优先本地项目”的需求，不需要调整repositories的顺序。

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