Tomcat ei käynnisty: käytännön vianmääritys


Julkaistu:

Päivitetty:


Artikkelit › Tomcat ei käynnisty: käytännön vianmääritys

Tilanne vuonna 2026 ja turvallinen käyttö

Johtopäätös: Lue ensimmäinen syypoikkeus Tomcatissa ja palvelunhallinnan lokeissa ennen määrityksen muuttamista. Tarkista sitten Java-yhteensopivuus, portin omistajuus, tiedostojen käyttöoikeudet, XML-syntaksi, levytila ja tehokas CATALINA_BASE.

Mitä opit

  • Toistettavissa oleva järjestys palvelun tilan, lokien, ympäristön ja liittimien tarkistamiseksi.
  • JVM-käynnistysvirheen erottaminen Tomcat-kokoonpanon tai käyttöönotetun sovelluksen virheestä.
  • Miksi työhakemistojen poistaminen tai muistin lisääminen ilman todisteita voi piilottaa todellisen ongelman.

Kenelle artikkeli on tarkoitettu: Kehittäjät ja järjestelmänvalvojat reagoivat Tomcat-prosessiin, joka sulkeutuu tai ei koskaan avaa liitintään.

Tilanne vuonna 2026: Alkuperäiset tapaukset ovat edelleen hyödyllisiä diagnostiikkakuvioita, mutta tiedostojen sijainnit ja tuetut Java-versiot riippuvat asennetusta Tomcat-perheestä ja pakkauksesta. Älä käytä vanhoja JVM-asetuksia uudelleen tarkistamatta nykyistä Java-dokumentaatiota.

Turvallisuushuomautus: Alkuperäisen artikkelin komentoja ja määritysesimerkkejä ei ole suoritettu uudelleen nykyaikaisessa tuotantoympäristössä. Tarkista tuetut versiot, ota varmuuskopio ja valmistele palautus erillisessä testiympäristössä ennen käyttöönottoa.

Viralliset lähteet

Yleiskatsaus

Tässä osassa kuvataan syitä, joiden vuoksi Tomcat ei käynnisty, ja miten niitä käsitellään. Tämä on syy ja ratkaisu tapauksiin, joissa Tomcat ei jostain syystä käynnisty ja virhe ilmenee, vaikka startup.bat tai startup.sh suoritetaan. Seuraavassa selitetään tämän Tomcatin version '9.0.27' perusteella.

Sisällysluettelo

  1. Tomcat ei käynnisty: käytännön vianmääritys
  2. Yhteenveto

1. Tomcat ei käynnisty: käytännön vianmääritys

Tomcatin käynnistymättä jäämiseen on useita syitä, mutta tässä osassa kuvataan tärkeimmät tapahtumat, jotka voivat aiheuttaa Tomcatin käynnistymättä jäämisen.

1-1. JAVA_HOME ei ole asetettu.

[syy]

Jos JAVA_HOMEa tai JRE_HOMEa ei ole asetettu, seuraava virheilmoitus tulee.

startup.bat


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

[Miten käsitellä sitä]

Aseta JAVA_HOME tai JRE_HOME kohdassa 'Järjestelmän ominaisuudet, Lisäasetukset, Ympäristömuuttujat'. Jos asetukset on määritetty oikein, komentoriville kirjoitettu komento 'echo %JAVA_HOME%', 'echo %JRE_HOME%' jne. tuottaa seuraavan tulosteen. Käynnistä komentorivi varmuuden vuoksi uudelleen, jos muutat ympäristömuuttujia. Ympäristömuuttujat luetaan, kun komentorivi käynnistetään.

C:\Users\user>echo %JAVA_HOME%
C:\Program Files (x86)\Java\jdk-11

1-2. JAVA-versio ei ole yhteensopiva Tomcatin kanssa.

[syy]

Tomcatilla on tuettu Java-versio. Se löytyy seuraavalta Tomcat-sivustolta.

https://tomcat.apache.org/whichversion.html

Esimerkiksi Tomcatin versio "9.0.27" olisi "9.0.x" edellä mainitulla sivustolla olevasta "Apache Tomcat Version" -versiosta, joka on "8 ja uudempi".

Tämä tarkoittaa, että Java 8 tai uudempi versio toimii.

[Miten käsitellä sitä]

Kirjoita ympäristömuuttujat uudelleen seuraavaan Tomcatin verkkosivustoon perustuviin vastaaviin Java-muuttujiin.

https://tomcat.apache.org/whichversion.html

1-3. JRE_HOME on käytössä.

[syy]

Tomcat kelpaa "JRE_HOME" -asetukselle, jos "JRE_HOME" ja "JAVA_HOME" on asetettu. Vaikka katsoisit "JAVA_HOME" ja näkisit, että Java on yhteensopiva Tomcatin kanssa, "JRE_HOME" toimii, joten "JRE_HOME" on oltava Java-yhteensopiva Tomcatin kanssa.

[Miten käsitellä sitä]

Kirjoita 'Järjestelmän ominaisuudet, Lisäasetukset, Ympäristömuuttujat' -kohdassa JRE_HOME-kohdassa oleva Java uudelleen Tomcatia vastaavaksi Javaksi.

1-4. Ristiriitaiset porttinumerot.

[syy]

Tomcat käynnistyy oletusarvoisesti portissa 8080. Jos portissa 8080 on käynnissä muita sovelluksia, näyttöön tulee seuraava virheilmoitus.

Critical [main] org.apache.catalina.util.LifecycleBase.handleSubClassException Failed to initialize component [Connector[HTTP/1.1-8080]]

[Miten käsitellä sitä]

Muuta Tomcatin porttia tai lopeta käynnissä olevat sovellukset, joiden porttinumerot ovat ristiriidassa keskenään.

Seuraava komento kertoo, onko porttinumeroristiriita olemassa. "8080"-osio on mukautettava omaan ympäristöön. Jos asetuksia ei ole muutettu, arvo on 8080. Jos mitään ei ole aktivoitu, vastausta ei palauteta.

Huomautus:Seuraavat komennot ovat 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. yhteenveto

Jos Tomcat ei käynnisty, tarkista seuraavat neljä kohtaa.

  • JAVA_HOME ei ole asetettu.
  • JAVA-versio ei ole yhteensopiva Tomcatin kanssa.
  • JRE_HOME on käytössä.
  • Ristiriitaiset porttinumerot.

Jos tämä ei toimi, lue seuraava artikkeli siitä, miten Tomcat ylipäätään käynnistyy.

Apache Tomcatin käynnistyminen: startup, Bootstrap ja Catalina

Tässä ovat tärkeimmät huomioitavat vaiheet ja rajoitukset.

Aiheeseen liittyvät artikkelit

■Artikkelit

Kaikki tekniset artikkelit


■Profiili

Tekijän profiili


■Yhteystiedot

Ota yhteyttä artikkelia koskevissa asioissa

↑