maven(配置)
1. 仓库优先级与查找顺序
当 Maven 需要解析一个依赖时(如执行mvn install
),它会按照以下顺序查找:
-
本地仓库
- 优先检查本地仓库(
E:\maven\maven_home
)是否已存在该依赖。 - 如果找到:直接使用,不访问网络。
- 如果未找到:继续下一步。
- 优先检查本地仓库(
-
激活的远程仓库
- 由于你配置了
<activeProfile>my-repo</activeProfile>
,Maven 会访问你定义的远程仓库(http://192.168.17.101:22/maven
)。 - 如果找到:下载到本地仓库并使用。
- 如果未找到:继续下一步(取决于你的配置)。
- 由于你配置了
-
中央仓库
- 默认行为:如果远程仓库中没有找到依赖,Maven不会自动回退到中央仓库。
- 例外情况:只有以下两种情况会继续访问中央仓库:
- 配置了镜像:如果通过
<mirrors>
标签配置了中央仓库的镜像(如阿里云),Maven 会访问镜像地址。 - 在
<repositories>
中显式声明中央仓库:如果你在<repositories>
中同时添加了中央仓库和你的私有仓库。
- 配置了镜像:如果通过
2.settings.xml
<?xml version="1.0" encoding="UTF-8"?><settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><!-- 本地仓库:Maven下载的依赖会存储在这里 -->
<localRepository>E:\maven\repository</localRepository><!-- 1. 远程仓库配置:定义Maven从哪里下载依赖 --><profiles><profile><id>my-repo</id><repositories><repository><id>company-repo</id> <!-- 仓库唯一标识,用于匹配认证信息 --><url>http://192.168.17.101:22/maven</url> <!-- 远程仓库地址(注意:22端口通常用于SSH,需确认是否正确) --><releases><enabled>true</enabled> <!-- 允许下载正式版本的依赖 --></releases><snapshots><enabled>true</enabled> <!-- 允许下载快照版本的依赖(开发中版本) --></snapshots></repository><!-- 显式添加中央仓库(让Maven同时访问两个仓库) --><repository><id>central</id><url>https://repo.maven.apache.org/maven2</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository></repositories></profile><!-- 其他可能的profile配置(如针对不同环境的仓库) --></profiles><!-- 2. 服务器认证:配置访问远程仓库所需的账号密码 --><servers><server><id>company-repo</id> <!-- 必须与上面repository的id完全一致 --><username>123</username> <!-- 登录远程仓库的用户名 --><password>123</password> <!-- 登录远程仓库的密码 --></server><!-- 其他服务器认证配置(如部署服务器) --></servers><!-- 3. 激活配置:让上面定义的profile生效 --><activeProfiles><activeProfile>my-repo</activeProfile> <!-- 激活名为my-repo的profile --></activeProfiles><!-- 插件组:定义Maven命令缩写的解析规则 --><pluginGroups><!-- 例如配置了com.your.plugins后,就可以用"mvn your:goal"替代完整插件名 --></pluginGroups><!-- 代理服务器:如果需要通过代理访问网络,配置这里 --><proxies><!-- 示例:配置HTTP代理服务器 --><!--<proxy><id>http-proxy</id><active>true</active><protocol>http</protocol><host>proxy.example.com</host><port>8080</port><username>proxyuser</username><password>proxypass</password><nonProxyHosts>localhost|127.0.0.1</nonProxyHosts> <!-- 不需要代理的地址 --><!--</proxy>--></proxies><!-- 镜像配置:用镜像地址替代原始仓库地址(例如用阿里云镜像加速下载) --><mirrors><mirror><id>aliyunmaven</id><mirrorOf>central</mirrorOf> <name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url></mirror></mirrors><!-- 其他配置:如离线模式、交互式模式等 --><!-- 通常使用默认值即可,无需修改 --></settings>
3.Maven 的依赖解析流程如下:
-
检查本地仓库
- Maven 首先检查
E:\maven\repository
中是否存在所需依赖。 - 如果存在:直接使用,不访问网络。
- 如果不存在:继续下一步。
- Maven 首先检查
-
按顺序访问远程仓库
- 由于
<repositories>
中定义了两个仓库,Maven 会按配置顺序依次尝试:- 私有仓库(
company-repo
)- 访问
http://192.168.17.101:22/maven
,使用账号123/123
认证。 - 如果找到依赖:下载到本地仓库并使用。
- 如果未找到:继续访问下一个仓库。
- 访问
- 中央仓库(
central
)- 由于配置了
<mirrorOf>central</mirrorOf>
,Maven 会实际访问阿里云镜像https://maven.aliyun.com/repository/public
。 - 如果找到依赖:从阿里云下载到本地仓库并使用。
- 如果未找到:报错
Could not find artifact
。
- 由于配置了
- 私有仓库(
- 由于
-
镜像的影响
- 配置的镜像
aliyunmaven
仅对<id>central</id>
的仓库生效,不会影响company-repo
。 - 如果你希望所有仓库都通过阿里云加速,可以配置
<mirrorOf>*</mirrorOf>
。
- 配置的镜像
4.本地映射远程文件
https://cloud.tencent.com/developer/article/1974419
若以此为,则可以实现局域网共享远程仓库