image

Bolsas de estudo DIO PRO para acessar bootcamps ilimitados

Disponível apenas:

291 vagas
Article image
Jefferson Soares
Jefferson Soares23/06/2025 08:54
Compartilhe
Microsoft Azure Cloud Native 2026Recomendados para vocêMicrosoft Azure Cloud Native 2026

Resolvendo problema de instalação do Maven e Gradle com IA Gemimi

  • #Java

Bom dia!

Durante a aula do bootcamp NTT data - Java e IA, mas precisamente na aula onde o professor ensinava como instalar o Maven e o Gradle, houve um momento após realizar todos os passos ensinados por ele que ao testar se o maven estava instalado se descobriu que não. O professor tentou descobrir o problema, parecia ser uma questão de permissão do windows. Comigo aconteceu o mesmo problema porém a solução de habiliatar todas as permissões do windows não mudava nada, continuava aparecendo a mesma mensagem no terminal.

"gradle não é reconhecido como um comando interno

ou externo, um programa operável ou um arquivo em lotes."

Desliguei o computador e fui dormir.

No dia seguinte fiz algumas pesquisa na internet porém sem sucesso, foi quando me lembrei da IA Gemini uma ferramenta que uso como compaheiro de estudo. Lancei o problema para ela, e a solução que obtive foi a seguinte:

Puxa, que chato que nem o Gradle nem o Maven estão funcionando! Isso geralmente indica um problema fundamental na configuração das variáveis de ambiente ou na própria instalação do Java (JDK). Vamos investigar isso de forma mais sistemática para encontrar a causa.

Vamos por Partes: Verificando o Básico

Para que o Gradle e o Maven funcionem, o seu computador precisa primeiro "saber" onde o Java Development Kit (JDK) está instalado. Eles são construídos em Java, então dependem dele.

  • Verifique a Instalação do JDK (Java Development Kit):Abra o Prompt de Comando (no Windows) ou Terminal (no Linux/macOS).
  • Digite os seguintes comandos, um de cada vez, e me diga o que aparece:
  • Bash
java -version
javac -version
echo %JAVA_HOME%
  • (No Linux/macOS, o último comando seria echo $JAVA_HOME)
  • Resultados Esperados:
  • java -version: Deveria mostrar a versão do Java instalada (ex: openjdk version "17.0.2").
  • javac -version: MUITO IMPORTANTE! Este comando verifica se o compilador Java (que faz parte do JDK) está acessível. Se ele não for reconhecido, você tem o JRE (Java Runtime Environment) e não o JDK, ou o JDK não está configurado corretamente no PATH.
  • echo %JAVA_HOME% (ou $JAVA_HOME): Deveria mostrar o caminho completo para a pasta raiz do seu JDK (ex: C:\Program Files\Java\jdk-17).

Se o JDK Não Estiver Certo (Provável Causa)

Se o javac -version não funcionar, ou se %JAVA_HOME% estiver vazio/errado, o problema está aqui.

  • Instale o JDK: Se você não tiver o JDK, baixe-o de uma fonte confiável (Oracle JDK ou OpenJDK, como o Adoptium Temurin). Escolha uma versão LTS (Long Term Support) como a 11, 17 ou 21.
  • Configure a Variável JAVA_HOME:No Windows: Vá em "Propriedades do Sistema" -> "Configurações avançadas do sistema" -> "Variáveis de Ambiente...".
  • Em "Variáveis do sistema", clique em "Nova...".
  • Nome da variável: JAVA_HOME
  • Valor da variável: O caminho completo para a pasta raiz do seu JDK. Ex: C:\Program Files\Java\jdk-17.
  • Edite a Variável Path do Sistema:Na mesma janela de "Variáveis de Ambiente", encontre a variável Path (em "Variáveis do sistema") e clique em "Editar...".
  • Adicione uma nova entrada: %JAVA_HOME%\bin (ou o caminho direto para a pasta bin do JDK, ex: C:\Program Files\Java\jdk-17\bin).
  • Mova essa entrada para cima na lista, se houver muitos outros caminhos, para garantir que ela seja encontrada primeiro.

Reavaliando Gradle e Maven Após Configurar o Java

Depois de ter certeza de que o Java (JDK) está funcionando perfeitamente (testando java -version, javac -version e echo %JAVA_HOME%), vamos refazer os passos para Gradle/Maven:

  1. Caminho de Instalação: Onde exatamente você extraiu o Gradle e o Maven? Por exemplo:
  • Gradle: C:\dev\gradle\gradle-x.x\bin
  • Maven: C:\dev\maven\apache-maven-x.x.x\bin
  1. Variável Path do Sistema:
  • Vá novamente em "Variáveis de Ambiente..." e edite a variável Path em "Variáveis do sistema".
  • Certifique-se de que os caminhos para as pastas bin do Gradle e do Maven estão lá. Por exemplo:
  • C:\dev\gradle\gradle-x.x\bin ( lembrando que o "x" é o número da sua versão)
  • C:\dev\maven\apache-maven-x.x.x\bin
  • Remova Caminhos Duplicados ou Incorretos: Verifique se não há entradas antigas ou erradas que possam estar causando conflito.
  1. Reinicie TUDO: Depois de fazer essas alterações, é crucial:
  • Fechar todos os Prompts de Comando/Terminais abertos.
  • Idealmente, reiniciar o computador. Isso garante que todas as variáveis de ambiente sejam recarregadas corretamente pelo sistema.
  1. Teste Novamente:
  • Abra um novo Prompt de Comando/Terminal.
  • Digite: Bash
gradle -v
mvn -v

Me diga qual sistema operacional você está usando (Windows, macOS, Linux) e os resultados dos comandos de verificação do Java. Com essas informações, consigo te ajudar de forma mais direcionada!

Obiviamente o meu JDK já estava instalado sendo minha versão a 24, assim que segui os demais passo, ao reiniciar meu computador, voltei a testar e tudo esta funcionando corretamente.

Espero que também ajude a vocês!😄

Bons Estudos!😉

Compartilhe
Recomendados para você
CI&T - Backend com Java & AWS
PcD Tech Bradesco - Java & QA Developer
Riachuelo - Primeiros Passos com Java
Comentários (3)
Stéphanie Silva
Stéphanie Silva - 09/01/2026 14:48

Obrigada pela ajuda, Jefferson.

No meu caso, mesmo seguindo os passos que colocou eu não consegui resolver o problema. No entanto usando o chat GPT consegui resolver a situação para o meu caso e vou compartilhar para caso alguém também esteja na mesma situação.

Diagnostincando o problema

Como relatei para a IA que executando o comando "mvn -version" no modo administrador o comando funcionava, mas não no modo usuário a IA me informou que muito provavelmente a variavel de ambiente estava configurada para o sistema, mas não para o usuário.

Para realizar o teste, me pediu para digitar:

echo %PATH%

Isso no prompt como modo administrador e no prompt no modo usuário.

Para minha supresa no modo administrador foi impresso o caminho da variável MAVEN_HOME (além de outros caminhos de variáveis configuradas na Path) e no modo usário só aparecia %MAVEN_HOME%. O que indicava, segundo o chat GPT, que minha variável Path do sistema possuía a variável MAVEN_HOME configurada, mas minha variável de usuário Path não.

Solucionando o problema

Para resolver, na mesma janela indicada pelo professor para fazermos as configurações, ali em variáveis de usuário (onde adicionamos as variáveis JAVA_HOME e MAVEN_HOME) também existe uma variável Path na lista e se abri-la vai perceber que as variaveis JAVA_HOME e MAVEN_HOME não existem, pois não configuramos as mesmas para a Path do usuário.

Basta Clicar duas vezes na variavel Path e na janela que irá se abrir, clicar em "Novo" e adicionar:

%MAVEN_HOME%\bin

Essa configuração deve ser feita nas duas variáveis Path.

image

image

Isso vale também para o Gradle.

Confirme as configurações e abra o prompt novamente para testar:

java -version
mvn -version
gradle -v

Espero ter ajudado quem ainda não conseguiu.


E obrigada, Jefferson, sem sua explicação detalhada eu não teria entendido os possíveis motivos da falha e assim saber o que perguntar ao GPT para resolver o problema no meu caso.

Jefferson Soares
Jefferson Soares - 23/06/2025 19:12

Boa noite Dio Community!

Normalmente procuro idetificar o problema, usando tecnica " Dividir para conquistar". Divido o problemas em partes menores e vou procurando ver o que esta correto e o que não. Sempre procuro ver se o problema ocasionado já tem alguma solução dada nos forúns de comunidades de desenvolvedores. E tento aplicar a soluções anteriormente usadas.

Nesse caso toda a parte de intalação estava bem feita porém não havia uma resposta favoravél e todas as soluções que encontrei nas minhas pesquisas não deram resutados. Assim que criei um prompt apresentando o que já tinha sido feito e o que não estava funcionando , fui filtrando até chegar ao resultado final.

Ainda tenho um grande Jornada pela frente!!

E estou aqui para ajudar no que puder! 😊

DIO Community
DIO Community - 23/06/2025 16:43

Jefferson, o seu relato sobre o problema de instalação do Maven e Gradle é extremamente útil e bastante comum para quem está começando com ferramentas de desenvolvimento. Você conseguiu resolver a questão de forma prática e, mais importante, compartilhou um passo a passo claro para outros desenvolvedores enfrentarem o mesmo desafio.

A forma como você usou a IA Gemini para diagnosticar o problema foi uma ótima estratégia e uma demonstração do poder da inteligência artificial na solução de problemas técnicos. Eu também gosto de como você detalhou a importância das variáveis de ambiente e a configuração correta do JDK, algo que muitas vezes pode passar despercebido, mas que é essencial para o funcionamento de muitas ferramentas de desenvolvimento.

Minha pergunta para você é: qual o seu processo para identificar a causa raiz de problemas técnicos, além de contar com ferramentas como a IA? Você tem algum método específico para depurar problemas quando eles não são tão claros?

Recomendados para vocêMicrosoft Azure Cloud Native 2026