Tomcat nepasileidžia: praktinis trikčių šalinimo sąrašas

Paskelbimo data: 2021 m. sausio 8 d.

Atnaujinta: 2026 m. rugpjūčio 16 d.

Apžvalga

Šiame straipsnyje aptariamos dažnos priežastys, dėl kurių Tomcat nepasileidžia net įvykdžius startup.bat arba startup.sh. Pavyzdžiai pagrįsti Tomcat 9.0.27, todėl diegdami kitą leidimą taip pat tikrinkite jo dokumentaciją ir žurnalus.

1. Kodėl Tomcat nepasileidžia

Tomcat gali nepasileisti dėl daugelio priežasčių. Toliau aprašyti keturi dažni atvejai ir jų tikrinimo būdai.

1-1. Nenustatytas JAVA_HOME

Priežastis

Jei nenustatytas nei JAVA_HOME, nei JRE_HOME, paleidimo scenarijus pateikia klaidą.

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

Sprendimas

Windows lange „System Properties“ → „Advanced“ → „Environment Variables“ nustatykite JAVA_HOME arba JRE_HOME. Reikšmę patikrinkite naujai atvertame komandų eilutės lange: jau veikiantis langas aplinkos kintamųjų pakeitimų neperima.

C:\Users\user>echo %JAVA_HOME%

C:\Program Files (x86)\Java\jdk-11

1-2. Java versija nesuderinama su Tomcat

Priežastis

Kiekvienai Tomcat versijos šakai taikomi konkretūs Java versijos reikalavimai. Jie pateikti oficialioje suderinamumo lentelėje.

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

Pavyzdyje naudojamas Tomcat 9.0.27 priklauso 9.0.x šakai, kuriai lentelėje nurodyta Java 8 arba naujesnė versija.

Vis dėlto konkretaus leidimo būseną ir naujausius reikalavimus visada tikrinkite oficialioje dokumentacijoje.

Sprendimas

Nustatykite JAVA_HOME arba JRE_HOME į su naudojama Tomcat versija suderinamą Java diegimą.

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

1-3. Pirmenybė teikiama JRE_HOME

Priežastis

Jei nustatyti abu kintamieji, Tomcat paleidimo scenarijus gali naudoti JRE_HOME. Todėl vien teisingos JAVA_HOME reikšmės nepakanka: ir JRE_HOME turi rodyti į suderinamą Java aplinką.

Sprendimas

Windows aplinkos kintamųjų lange pataisykite arba pašalinkite pasenusią JRE_HOME reikšmę, kad paleidimo scenarijus naudotų su Tomcat suderinamą Java aplinką.

1-4. Prievadas jau naudojamas

Priežastis

Numatytoji Tomcat HTTP jungtis naudoja 8080 prievadą. Jei jo jau klausosi kita programa, Tomcat jungties paleisti nepavyks.

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

Sprendimas

Pakeiskite Tomcat jungties prievadą arba sustabdykite kitą procesą, kuris jį naudoja.

Toliau pateikta Windows komanda parodo, ar klausomas 8080 prievadas. Jei konfigūracijoje naudojamas kitas prievadas, atitinkamai pakeiskite skaičių. Kai prievado niekas nenaudoja, komanda rezultato nepateikia.

Pastaba: pateikta komanda skirta 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. Santrauka

Jei Tomcat nepasileidžia, pirmiausia patikrinkite šiuos keturis punktus:

• ar nustatytas JAVA_HOME;
• ar Java versija suderinama su Tomcat;
• ar pasenusi JRE_HOME reikšmė neperrašo JAVA_HOME;
• ar reikiamas prievadas nėra užimtas.

Jei šių patikrų nepakanka, peržiūrėkite žurnalus ir palyginkite paleidimo eigą su šiame straipsnyje aprašytu procesu:

Kaip paleidžiamas Apache Tomcat