Repositorio Maven
En la terminología de Maven, un repositorio es un lugar (place).
El repositorio Maven es la biblioteca de terceros de la que depende el proyecto; la ubicación donde se encuentra esta biblioteca se llama repositorio.
En Maven, cualquier dependencia, complemento (plugin) o resultado de la compilación del proyecto puede denominarse artefacto.
El repositorio Maven nos ayuda a gestionar artefactos (principalmente JAR); es el lugar donde se almacenan todos los archivos JAR (WAR, ZIP, POM, etc.).
Tipos de repositorio Maven:
| Tipo de repositorio | Ubicación de almacenamiento | Función | Prioridad de acceso |
|---|---|---|---|
| Repositorio local | En el directorio del usuario.m2/repository | Almacena en caché las dependencias descargadas de forma remota | 1 |
| Repositorio remoto | Servidor de red | Proporciona almacenamiento centralizado de dependencias y complementos (plugins) | 2 |
| - Repositorio central | repo.maven.apache.org | Repositorio predeterminado mantenido oficialmente por Maven | 2.1 |
| - Repositorio privado (servidor privado) | Construido internamente en la empresa (como Nexus) | Aloja dependencias privadas y acelera la compilación | 2.2 |
| - Otros repositorios públicos | Como Alibaba Cloud, JCenter, etc. | Espejo o complemento del repositorio central | 2.3 |
Repositorio local
El repositorio local de Maven no se crea después de instalar Maven; se crea la primera vez que se ejecuta el comando maven.
Al ejecutar Maven, cualquier artefacto que Maven necesite se obtiene directamente del repositorio local. Si no está en el repositorio local, primero intenta descargar el artefacto desde un repositorio remoto al repositorio local y luego utiliza el artefacto del repositorio local.
De forma predeterminada, tanto en Linux como en Windows, cada usuario tiene un directorio de repositorio con la ruta .m2/repository/ en su directorio de usuario.
Windows:
C:\Users\<用户名>\.m2\repositoryLinux/macOS:
~/.m2/repository
El repositorio local de Maven se crea de forma predeterminada en el directorio %USER_HOME%. Para modificar la ubicación predeterminada, defina otra ruta en el archivo settings.xml de Maven en el directorio %M2_HOME%\conf.
Cuando ejecuta comandos de Maven, Maven descarga los archivos de dependencias a la ruta que usted especifique.
Limpiar el repositorio local:
mvn dependency:purge-local-repository # 或手动删除~/.m2/repository目录
Repositorio central
El repositorio central de Maven es un repositorio proporcionado por la comunidad de Maven, que contiene una gran cantidad de bibliotecas de uso común.
El repositorio central contiene la gran mayoría de los artefactos Java de código abierto más populares, así como el código fuente, la información del autor, SCM, información, información de licencia, etc. En general, los artefactos de los que dependen los proyectos Java simples se pueden descargar aquí.
Conceptos clave del repositorio central:
- Este repositorio es gestionado por la comunidad de Maven.
- No requiere configuración.
- Se necesita acceso a través de la red.
Dirección predeterminada del repositorio central (sin necesidad de configuración explícita):https://repo.maven.apache.org/maven2/
Repositorio remoto
Configuración de repositorio personalizado
Si Maven no encuentra los archivos de dependencias en el repositorio central, detendrá el proceso de compilación y mostrará un mensaje de error en la consola. Para evitar esta situación, Maven proporciona el concepto de repositorio remoto, que es un repositorio personalizado por los desarrolladores, que contiene las bibliotecas de código necesarias o los archivos jar utilizados en otros proyectos.
Por ejemplo, utilizando el siguiente pom.xml, Maven descargará desde el repositorio remoto los archivos de dependencias declarados en ese pom.xml (que no se pueden obtener en el repositorio central).
Ejemplo
<repository>
<id>aliyun</id>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled> <!-- Deshabilitar versiones SNAPSHOT -->
</snapshots>
</repository>
</repositories>
Repositorio espejo (recomendado)
Configurar en settings.xml:
Ejemplo
<mirror>
<id>aliyun</id>
<name>Aliyun Mirror</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf> <!-- Sobrescribir el repositorio central -->
</mirror>
</mirrors>
Repositorio Maven de Alibaba Cloud (Aliyun)
El repositorio Maven está predeterminadamente en el extranjero, por lo que su uso en China puede ser lento; podemos cambiarlo al repositorio de Alibaba Cloud.
Modifique el archivo settings.xml en la carpeta conf del directorio raíz de Maven y agregue el siguiente contenido en el nodo mirrors:
Si desea utilizar otros repositorios proxy, puede<repositories></repositories>agregar la dirección de uso del repositorio correspondiente en el nodo. Tomando como ejemplo el uso del repositorio proxy de Spring:
En su archivo pom.xml<denpendencies></denpendencies>agregue la información de los archivos que desea referenciar en el nodo:
Ejecute el comando de extracción:
mvn install
Guía de configuración de Gradle
Agregue el siguiente código en el archivo build.gradle:
Si desea utilizar otros repositorios proxy, tomando como ejemplo el repositorio de Spring, el código es el siguiente:
Agregue la información de los archivos que desea referenciar:
Ejecute el siguiente comando para instalar las dependencias:
gradle dependencies 或 ./gradlew dependencies
Repositorio privado (servidor privado)
Tipos de repositorio:
| Tipo de repositorio | Uso |
|---|---|
| hosted | Almacenar artefactos privados |
| proxy | Actuar como proxy de repositorios remotos |
| group | Agregar múltiples repositorios |
Publicar en el repositorio privado
Configurar en pom.xml:
<distributionManagement>
<repository>
<id>nexus-releases</id>
<url>http://your-nexus/repository/maven-releases</url>
</repository>
<snapshotRepository>
<id>nexus-snapshots</id>
<url>http://your-nexus/repository/maven-snapshots</url>
</snapshotRepository>
</distributionManagement>
Configurar la autenticación en settings.xml:
<servers>
<server>
<id>nexus-releases</id>
<username>deploy-user</username>
<password>deploy-pwd</password>
</server>
</servers>Comando de publicación:
mvn deploy
Orden de búsqueda de dependencias de Maven
Cuando ejecutamos un comando de compilación de Maven, Maven comienza a buscar las bibliotecas de dependencias en el siguiente orden:
- Paso 1- Buscar en el repositorio local; si no se encuentra, vaya al paso 2; si se encuentra, realizar otras operaciones.
- Paso 2- Buscar en el repositorio central; si no se encuentra y se ha configurado uno o más repositorios remotos, vaya al paso 4; si se encuentra, descargarlo al repositorio local para su referencia futura.
- Paso 3- Si no se ha configurado ningún repositorio remoto, Maven simplemente se detendrá y lanzará un error (no se puede encontrar el archivo de dependencia).
- Paso 4- Buscar el archivo de dependencia en uno o más repositorios remotos; si se encuentra, descargarlo al repositorio local para su referencia futura; de lo contrario, Maven se detendrá y lanzará un error (no se puede encontrar el archivo de dependencia).
Comandos comunes
| Comando | Función |
|---|---|
mvn dependency:resolve | Resolver dependencias |
mvn dependency:tree | Ver el árbol de dependencias |
mvn dependency:purge-local-repository | Limpiar el repositorio local |
mvn deploy | Publicar en el repositorio remoto |
Solución de problemas comunes
1. Síntoma de fallo en la descarga de dependencias:Could not transfer artifact...
Solución:- Verificar la conexión de red
- Verificar que la URL del repositorio sea correcta
- Desactivar temporalmente el cortafuegos para probar
2. Síntoma de fallo de autenticación:401 Unauthorized
Solución:
- Verificar la configuración de <server> en settings.xml
- Confirmar si el nombre de usuario/contraseña tiene permisos de acceso al repositorio
3. Conflicto de dependencias
Investigación:
mvn dependency:tree -Dverbose
Solución: unificar las versiones en <dependencyManagement>
Otras extensiones