Tomcat ne démarre pas : guide pratique de dépannage
Date de publication:
Mise à jour :
Articles > Tomcat ne démarre pas : guide pratique de dépannage
Statut 2026 et utilisation sûre
Conclusion : Lisez la première exception de cause première dans les journaux Tomcat et du gestionnaire de services avant de modifier la configuration. Vérifiez ensuite la compatibilité Java, la propriété du port, les autorisations de fichiers, la syntaxe XML, l'espace disque et le CATALINA_BASE effectif.
Ce que vous apprendrez
- Un ordre reproductible pour vérifier l'état du service, les journaux, l'environnement et les connecteurs.
- Comment distinguer un échec de lancement de JVM d'un échec de configuration Tomcat ou d'application déployée.
- Pourquoi la suppression de répertoires de travail ou l'augmentation de la mémoire sans preuve peuvent masquer le véritable problème.
À qui s'adresse : Développeurs et administrateurs répondant à un processus Tomcat qui quitte ou n'ouvre jamais son connecteur.
Position 2026 : Les cas d'origine restent des modèles de diagnostic utiles, mais les emplacements des fichiers et les versions Java prises en charge dépendent de la famille Tomcat installée et de l'emballage. Ne réutilisez pas les anciennes options JVM sans consulter la documentation Java actuelle.
Note de sécurité : les commandes et exemples de configuration de l'article d'origine n'ont pas été rejoués dans un environnement de production actuel. Avant toute application, vérifiez les versions prises en charge, les sauvegardes, les contrôles d'accès et la procédure de retour arrière dans un environnement de test isolé.
Sources primaires officielles
Vue d’ensemble
Cette section décrit les causes du non démarrage de Tomcat et comment y remédier. C'est la cause et le remède pour les cas où Tomcat ne démarre pas pour une raison quelconque et une erreur se produit même si startup.bat ou startup.sh est exécuté. Cette section explique cela en me basant sur la version 9.0.27 de Tomcat.
Table des matières
1. Tomcat ne démarre pas : guide pratique de dépannage
Il existe différentes causes de non-démarrage de Tomcat, mais cette section décrit les principaux événements qui peuvent provoquer le non-démarrage de Tomcat.
1-1. JAVA_HOME n'est pas défini.
(cause)
Si ni JAVA_HOME ni JRE_HOME ne sont définis, l'erreur suivante s'affiche.
C:\Users\user>C:\apache-tomcat-9.0.27\bin\startup.bat
The JRE_HOME environment variable is not defined correctly
This environment variable is needed to run this program
(Comment y faire face)
Définissez JAVA_HOME ou JRE_HOME dans 'Propriétés du système, Paramètres avancés, Variables d'environnement'. Si la configuration est correcte, la saisie de "echo %JAVA_HOME%", "echo %JRE_HOME%", etc. à l'invite de commande produira le résultat suivant. Par précaution, redémarrez l'invite de commande si vous modifiez les variables d'environnement. Les variables d'environnement sont lues lorsque l'invite de commande est lancée.
C:\Users\user>echo %JAVA_HOME%
C:\Program Files (x86)\Java\jdk-11
1-2. La version de JAVA n'est pas compatible avec Tomcat.
(cause)
Tomcat a une version de Java supportée. Il peut être trouvé sur le site web suivant de Tomcat.
https://tomcat.apache.org/whichversion.html
Par exemple, la version de Tomcat "9.0.27" correspondrait à "9.0.x" de la "version d'Apache Tomcat" sur le site ci-dessus, qui est "8 et plus".
Cela signifie que la mise en place de Java 8 ou d'une version ultérieure fonctionnera.
(Comment y faire face)
Réécrivez les variables d'environnement dans les Java correspondants en fonction du site Web Tomcat suivant.
https://tomcat.apache.org/whichversion.html
1-3. JRE_HOME est activé.
(cause)
Tomcat est valable pour "JRE_HOME" si "JRE_HOME" et "JAVA_HOME" sont définis. Même si vous regardez "JAVA_HOME" et voyez que Java est compatible avec Tomcat, "JRE_HOME" fonctionnera, donc "JRE_HOME" doit être compatible Java avec Tomcat.
(Comment y faire face)
Dans 'Propriétés du système, Paramètres avancés, Variables d'environnement', réécrivez Java dans JRE_HOME en Java correspondant à Tomcat.
1-4. Numéros de port contradictoires.
(cause)
Tomcat démarre sur le port 8080 par défaut. Si d'autres applications fonctionnent sur le port 8080, l'erreur suivante est affichée.
Critical [main] org.apache.catalina.util.LifecycleBase.handleSubClassException Failed to initialize component [Connector[HTTP/1.1-8080]]
(Comment y faire face)
Changez le port de Tomcat ou arrêtez les applications en cours d'exécution avec des numéros de port conflictuels.
La commande suivante vous indiquera s'il y a un conflit de numéros de port. La partie "8080" doit être adaptée à votre propre environnement. Si aucun paramètre n'a été modifié, la valeur est 8080. Si rien n'est activé, aucune réponse n'est renvoyée.
Remarque : Les commandes suivantes sont Windows.
C:\Users\user>netstat -nao | find "8080"
TCP 0.0.0.0:8080 0.0.0.0:0 LISTENING 5748
TCP [::]:8080 [::]:0 LISTENING 5748
TCP [::1]:8080 [::1]:58259 TIME_WAIT 0
TCP [::1]:8080 [::1]:58260 TIME_WAIT 0
TCP [::1]:8080 [::1]:58261 TIME_WAIT 0
2. résumé
Si Tomcat ne démarre pas, vérifiez les quatre points suivants.
- JAVA_HOME n'est pas défini.
- La version de JAVA n'est pas compatible avec Tomcat.
- JRE_HOME est activé.
- Numéros de port contradictoires.
Si cela ne fonctionne pas, veuillez vous référer à l'article suivant sur la façon dont Tomcat démarre en premier lieu.