Port par défaut dans Spring Boot : 5 méthodes de configuration

Pourquoi votre Spring Boot « ne veut pas » écouter sur le 8080 ?

Vous lancez votre première application Spring Boot, vous voyez la bannière tant attendue dans la console, vous ouvrez le navigateur — et là, « Connection refused ». Une situation familière ? Le plus souvent, le problème est que le port 8080 est déjà occupé par un autre processus (par exemple, Skype, Docker ou une deuxième instance de votre propre application). Ou, à l'inverse, vous devez lancer trois microservices sur une seule machine, et ils veulent tous s'emparer du même port.

Dans cet article, nous allons passer en revue toutes les principales méthodes de configuration du port dans Spring Boot — des plus simples aux plus « robustes » pour la production. Vous apprendrez à redéfinir le port via les fichiers de configuration, les variables d'environnement, les arguments de ligne de commande et même par programmation. Et à la fin, je vous donnerai une liste de contrôle pour choisir la méthode adaptée à chaque situation.

Méthode 1 : application.properties — la classique

La méthode la plus courante et la plus intuitive. Dans le fichier src/main/resources/application.properties, il suffit d'ajouter une ligne :

server.port=9090

Voilà. Après le redémarrage, l'application écoutera sur le port 9090. Si vous voulez revenir au 8080, supprimez ou commentez simplement la ligne.

Avantages : simplicité, clarté, fonctionne « prêt à l'emploi ».

Inconvénients : codé en dur — pour chaque environnement (dev, test, prod), vous devrez modifier le fichier manuellement ou utiliser des profils.

Méthode 2 : application.yml (YAML) — pour les amateurs de structure

Si vous préférez le format YAML, la configuration ressemblera à ceci :

server:\n  port: 9090

Attention aux indentations : deux espaces avant port. YAML est sensible aux espaces, mais il permet de regrouper les paramètres. Par exemple, vous pouvez définir à la fois le port et le chemin de contexte :

server:\n  port: 9090\n  servlet:\n    context-path: /myapp

Quand l'utiliser : si votre projet utilise déjà YAML pour toutes les configurations (par exemple, pour Spring Cloud Config).

Méthode 3 : Arguments de ligne de commande — flexibilité pour DevOps

La méthode la plus flexible, souvent utilisée dans les conteneurs et les CI/CD. Lors du lancement du fichier JAR, transmettez simplement le paramètre :

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

Ou, si vous utilisez le plugin Maven/Gradle :

mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=9090

Les arguments de ligne de commande ont la plus haute priorité parmi toutes les méthodes de configuration dans Spring Boot. Cela signifie qu'ils remplaceront même ce qui est écrit dans application.properties.

Idéal pour : les conteneurs Docker, Kubernetes, les déploiements automatisés.

Méthode 4 : Variables d'environnement — le standard des applications twelve-factor

Spring Boot lit automatiquement les variables d'environnement et les convertit en propriétés. La règle est simple : SERVER_PORT (en majuscules, souligné au lieu du point) deviendra server.port.

Sous Linux/macOS :

export SERVER_PORT=9090\njava -jar myapp.jar

Sous Windows (cmd) :

set SERVER_PORT=9090\njava -jar myapp.jar

Dans Docker Compose, c'est encore plus élégant :

services:\n  myapp:\n    image: myapp:latest\n    ports:\n      - "9090:9090"\n    environment:\n      - SERVER_PORT=9090

Pourquoi c'est génial : les variables d'environnement ne sont pas stockées dans le dépôt, elles sont faciles à modifier pour différents environnements, et elles suivent la méthodologie 12-factor app.

Méthode 5 : Configuration programmatique — pour le micromanagement

Parfois, vous devez calculer le port dynamiquement (par exemple, trouver un port libre ou l'obtenir depuis un service externe). Dans ce cas, le code Java vient à la rescousse.

L'option la plus simple est de redéfinir la méthode setServerPort dans la clas