Guía rápida para cambiar el puerto Spring Boot predeterminado

Introducción

Spring Boot es un marco poderoso que simplifica el desarrollo de nuevas aplicaciones Spring a través de valores predeterminados sensatos. Una de sus muchas características es el servidor integrado preconfigurado, que permite a los desarrolladores ejecutar aplicaciones desde el primer momento. Sin embargo, puede haber situaciones en las que el puerto predeterminado del servidor (normalmente 8080) entre en conflicto con otras aplicaciones o no cumpla con requisitos de implementación específicos. Esta guía lo guiará a través del proceso de cambiar el puerto predeterminado en una aplicación Spring Boot, asegurando que su aplicación se ejecute sin problemas en el puerto deseado.

Puerto predeterminado de Spring Boot

Antes de sumergirse en la personalización, es esencial comprender cómo Spring Boot configura su servidor integrado. De forma predeterminada, las aplicaciones Spring Boot utilizan Tomcat como servidor integrado y escuchan en el puerto 8080. Esta configuración es flexible y se puede ajustar fácilmente mediante las propiedades de la aplicación o mediante programación.

Método 1: usar archivos de configuración

La forma más sencilla de cambiar el puerto predeterminado es especificar un nuevo puerto en el archivo application.properties o application.yml ubicado en el directorio src/main/resources.

Para propiedades de aplicación:

server.port=9090

Para aplicación.yml:

server:
 port: 9090

Después de configurar el puerto deseado, reinicie la aplicación. Ahora debería ser accesible en la nueva puerta.

Para aplicaciones implementadas en diferentes entornos (por ejemplo, desarrollo, prueba, producción), es eficaz utilizar perfiles Spring para definir configuraciones específicas del entorno, incluidos los puertos del servidor.

Para propiedades de desarrollo de aplicaciones:

server.port=9090

Active el perfil configurando la propiedad spring.profiles.active cuando se inicie la aplicación:

java -jar myapplication.jar --spring.profiles.active=dev

Esta configuración permite configuraciones flexibles y específicas del entorno, lo que facilita la administración de la configuración del puerto en diversos escenarios de implementación.

Método 2: configurar el puerto mediante programación

Si necesita un control más dinámico sobre la configuración del puerto, puede configurar el puerto mediante programación. Este enfoque es útil cuando necesita determinar el puerto en tiempo de ejecución en función de condiciones específicas o configuraciones externas.

Código de ejemplo:

import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.web.server.WebServerFactoryCustomizer;
 import org.springframework.boot.web.servlet.server.ConfigurableServletWebServerFactory;
 import org.springframework.context.annotation.Bean;

 @SpringBootApplication
 public class MyApplication {

 public static void main(String[] args) {
 SpringApplication.run(MyApplication.class, args);
 }

 @Bean
 public WebServerFactoryCustomizer webServerFactoryCustomizer() {
 return factory -> factory.setPort(9090);
 }
 }

Este fragmento de código define un bean WebServerFactoryCustomizer que personaliza el puerto del servidor integrado antes de que se inicie la aplicación.

Método 3: usar argumentos de línea de comando

También puede anular el puerto predeterminado especificando un argumento de línea de comando cuando se inicia la aplicación. Este método es especialmente útil para cambios temporales o cuando se implementa la aplicación en diferentes entornos que requieren diferentes puertos.

java -jar myapplication.jar --server.port=9090

Este comando inicia la aplicación Spring Boot con el servidor integrado escuchando en el puerto 9090.

Conclusión

Cambiar el puerto predeterminado en una aplicación Spring Boot es simple y se puede lograr mediante varios métodos según sus requisitos específicos. Ya sea a través de las propiedades de la aplicación, mediante programación, usando argumentos de línea de comando o con configuraciones específicas del entorno, Spring Boot brinda la flexibilidad para garantizar que su aplicación se ejecute en el puerto que mejor se adapte a sus necesidades. Si sigue esta guía, puede personalizar la configuración del puerto de su aplicación Spring Boot para alinearse con sus estrategias de implementación y evitar conflictos de puertos, lo que garantiza procesos de implementación y desarrollo de aplicaciones sin problemas.