Porta padrão no Spring Boot: 5 maneiras de configurar

Por que seu Spring Boot "não quer" escutar na porta 8080?

Você inicia sua primeira aplicação Spring Boot, vê o banner tão esperado no console, abre o navegador — e aparece "Connection refused". Situação familiar? Na maioria das vezes, o problema é que a porta 8080 já está ocupada por outro processo (por exemplo, Skype, Docker ou uma segunda instância da sua própria aplicação). Ou, ao contrário, você precisa executar três microsserviços na mesma máquina, e todos eles querem capturar a mesma porta.

Neste artigo, vamos abordar todas as principais maneiras de configurar a porta no Spring Boot — desde as mais simples até as "de produção" para ambientes reais. Você aprenderá como sobrescrever a porta através de arquivos de configuração, variáveis de ambiente, argumentos de linha de comando e até mesmo programaticamente. E no final, darei uma lista de verificação sobre qual método escolher dependendo da situação.

Método 1: application.properties — o clássico

O método mais comum e intuitivo. No arquivo src/main/resources/application.properties, basta adicionar uma linha:

server.port=9090

Pronto. Após reiniciar a aplicação, ela escutará na porta 9090. Se precisar voltar para a 8080, basta remover ou comentar a linha.

Vantagens: simplicidade, clareza, funciona "de fábrica".

Desvantagens: fica fixo no código — para cada ambiente (dev, test, prod) será necessário alterar o arquivo manualmente ou usar perfis.

Método 2: application.yml (YAML) — para quem gosta de estrutura

Se você prefere o formato YAML, a configuração ficará assim:

server:\n  port: 9090

Observe a indentação: dois espaços antes de port. O YAML é sensível a espaços, mas permite agrupar configurações. Por exemplo, você pode definir também o caminho de contexto:

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

Quando usar: se seu projeto já utiliza YAML para todas as configurações (por exemplo, para Spring Cloud Config).

Método 3: Argumentos de linha de comando — flexibilidade para DevOps

O método mais flexível, frequentemente usado em contêineres e CI/CD. Ao iniciar o arquivo JAR, basta passar o parâmetro:

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

Ou, se estiver usando o plugin Maven/Gradle:

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

Os argumentos de linha de comando têm a maior prioridade entre todos os métodos de configuração no Spring Boot. Isso significa que eles sobrescreverão até mesmo o que está escrito no application.properties.

Ideal para: contêineres Docker, Kubernetes, deploys automatizados.

Método 4: Variáveis de ambiente — padrão de aplicações twelve-factor

O Spring Boot lê automaticamente as variáveis de ambiente e as converte em propriedades. A regra é simples: SERVER_PORT (em maiúsculas, sublinhado no lugar do ponto) se torna server.port.

No Linux/macOS:

export SERVER_PORT=9090\njava -jar myapp.jar

No Windows (cmd):

set SERVER_PORT=9090\njava -jar myapp.jar

No Docker Compose, fica ainda mais elegante:

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

Por que isso é legal: as variáveis de ambiente não vão para o repositório, são fáceis de alterar para diferentes ambientes e seguem a metodologia 12-factor app.

Método 5: Configuração programática — para microgerenciamento

Às vezes, é necessário calcular a porta dinamicamente (por exemplo, encontrar uma porta livre ou obtê-la de um serviço externo). Nesse caso, o código Java vem ao resgate.

A opção mais simples é sobrescrever o método setServerPort na clas