依赖管理问题：依赖冲突、版本不兼容、远程仓库不可达

依赖管理，说白了就是管好项目里那些外部库。我见过太多团队，代码写得挺好，一构建就崩，十有八九是依赖出了问题。今天咱们就聊聊最常见的三类：依赖冲突、版本不兼容、远程仓库不可达。

依赖冲突：两个版本抢着用

我最常遇到的场景就是：A 库依赖了 C 的 1.0，B 库依赖了 C 的 2.0。构建时，构建工具只会选一个版本留下来。但留下的那个，A 或者 B 可能就不认账了。

怎么查？
用依赖树命令。Maven 的话：

mvn dependency:tree -Dverbose

Gradle：

gradle dependencies --configuration compileClasspath

npm：

npm ls 包名

找到冲突的地方，你会看到类似这样的输出（Maven）：

[INFO] +- com.example:my-lib:1.0
[INFO] |  \- com.fasterxml.jackson.core:jackson-databind:2.9.8
[INFO] +- com.other:other-lib:2.0
[INFO]    \- com.fasterxml.jackson.core:jackson-databind:2.12.0 (选择 2.12.0)

怎么修？
我最常用的方法是 排除依赖：在声明的一方里把冲突的那个版本排除掉。

<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-lib</artifactId>
    <version>1.0</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle 里用 exclude：

implementation('com.example:my-lib:1.0') {
    exclude group: 'com.fasterxml.jackson.core', module: 'jackson-databind'
}

或者直接 强制锁定版本。Maven 用 <dependencyManagement> 统一声明版本，Gradle 用 constraints 或 force = true。

版本不兼容：A库和B库打起来了

这问题比冲突更隐蔽。没有版本冲突，但 A 库的 1.0 和 B 库的 2.0 就是不兼容。比如 Spring Boot 2.x 和 Spring Cloud Hoxton 版本之间就有明确的映射关系。

举个例子：

Spring Boot 版本	兼容的 Spring Cloud 版本
2.3.x	Hoxton.SR12
2.4.x	2020.0.x (Ilford)
2.5.x	2020.0.x+ / 2021.0.x

我曾经踩过一个坑：把 Spring Boot 从 2.3 升级到 2.5，但忘了升级 Spring Cloud。结果启动报错，说找不到某个 Bean。看了半天官方文档，才发现版本矩阵不匹配。

解决方案：
要么降级一个库，要么升级另一个。我倾向于 按官方推荐走，别自己瞎搭配。用 BOM（Bill of Materials）最省心：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2020.0.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

远程仓库不可达：下载失败

这个场景很常见，尤其在国内。Maven 中心仓库、npm 官方源，可能因为网络被墙、DNS 解析慢、公司内网限制等原因没法访问。

错误日志大概长这样：

[ERROR] Failed to execute goal on project my-app: Could not resolve dependencies for project ...
[ERROR] Could not transfer artifact org.springframework:spring-core:5.3.0 from/to central (https://repo.maven.apache.org/maven2): Connection timed out

怎么解决？

1. 换镜像：国内用阿里云、华为云、腾讯云的 Maven 镜像。修改 ~/.m2/settings.xml 或项目里的 pom.xml。
2. 提前下载并离线缓存：在公司内网环境，我经常先把所有依赖下载到本地，然后配置 -Dmaven.repo.local 指向缓存目录。
3. 检查代理：如果是公司内网需要代理，配置 settings.xml 里的 proxy 节点。

下面是一个阿里云镜像的配置示例：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

npm 的话，直接改 .npmrc：

registry=https://registry.npmmirror.com/

我个人还习惯在 Jenkins 里配置 离线模式，防止每次构建都去远程拉依赖。前提是本地仓库已经缓存了全部 jar。