Hogyan olvasd a szervernaplókat és az összeomlási jelentéseket
Keresd meg a lényeges sort egy játékszerver naplójában: naplószintek, stack trace-ek, az első hiba szabálya, és hogy hol élnek a naplók és az összeomlási jelentések a paneledben.
5 perc olvasás · Frissítve: 2026. okt. 21. · Szerző: GuavaHost Team
Amikor egy szerver összeomlik vagy nem akar elindulni, az ok szinte mindig le van írva a naplójában. A naplók ijesztően néznek ki, de ritkán kell az egészet megértened: egyetlen sort kell megtalálnod. Ez az útmutató megmutatja, hogyan olvass el egy naplósort, mit jelentenek a szintek, hogyan olvass egy stack trace-t, és hol élnek a naplók és az összeomlási jelentések a paneledben.
Egy naplósor anatómiája
Itt egy jellemző sor egy Minecraft szerverről:
[14:02:11] [Server thread/INFO]: Done (8.412s)! For help, type "help"
- A
[14:02:11]az időpont. Ez a szerver órája, ami nem biztos, hogy egyezik a te időzónádéval. - A
Server threadazt mondja meg, a program melyik része írta. A server thread a fő játékciklus. - Az
INFOa szint: mennyire súlyos a sor. - Minden, ami a kettőspont után van, maga az üzenet.
Más játékok máshogy formázzák a sorokat, de szinte mindegyik tartalmaz valahol egy időpontot, egy szintet és egy üzenetet.
Naplószintek
| Szint | Jelentés | Aggódnod kell? |
|---|---|---|
| DEBUG vagy TRACE | Finom részletek fejlesztőknek | Rendszerint el van rejtve; hagyd figyelmen kívül |
| INFO | Normál tevékenység: indulás, belépés, mentés | Nem |
| WARN | Valami nem stimmel, de a szerver megy tovább | Néha; sok figyelmeztetés ártalmatlan zaj |
| ERROR | Valami elhasalt | Igen, ha egybeesik a problémáddal |
| FATAL vagy SEVERE | A szerver nem tud folytatni | Igen, rendszerint ez maga az összeomlás |
Ne hajszolj minden figyelmeztetést. Rengeteg jó állapotú szerver ugyanazokat az ártalmatlan figyelmeztetéseket írja ki minden indulásnál. Azokra a hibákra koncentrálj, amelyek akkor történnek, amikor a problémád.
Az első hiba szabálya
Egyetlen valódi probléma gyakran egy kupac hibát okoz maga után, ahogy a szerver más részei belebotlanak az első elhasalásba. A képernyőn látható utolsó hiba rendszerint tünet. Az első hiba az utolsó normálisnak tűnő sor után rendszerint az ok.
- Keresd meg az utolsó sort, ahol minden normálisnak látszott.
- Olvass lefelé az első
ERROR,ExceptionvagyFATALbejegyzésig. - Javítsd meg azt az egyet, indítsd újra, és olvasd megint. Ha a szerver most tovább jut, mielőtt elhasal, haladsz.
Egy stack trace olvasása
A stack trace azoknak a lépéseknek a listája, amelyeket a program éppen végzett, amikor elhasalt. Itt egy gyakori példa egy pluginos Minecraft szerverről:
[12:40:03 ERROR]: Error occurred while enabling ExampleShop v2.1 (Is it up to date?)
java.lang.NoClassDefFoundError: net/milkbowl/vault/economy/Economy
at com.example.shop.ShopPlugin.onEnable(ShopPlugin.java:57)
...
Caused by: java.lang.ClassNotFoundException: net.milkbowl.vault.economy.Economy
Hogyan olvasd:
- Az első sor megmondja, mi hasalt el: az ExampleShop plugin nem tudott elindulni.
- A kivétel típusa megmondja, miért: a
NoClassDefFoundErrorazt jelenti, hogy olyan kódra volt szüksége, ami nincs ott. - Az
atsorok megmutatják, hol. Olyan nevet keress, amit felismersz, például magának a pluginnak a nevét, ne a játék belső részeit. - A
Caused bya gyökér. Amikor egy trace-ben több is van, rendszerint az utolsóCaused byaz igazi ok. Itt egy Vaultból származó osztály hiányzik, úgyhogy a megoldás az, hogy telepítsd a Vault plugint, amelyre ez a shop épül.
Gyakori hibák és általában mit jelentenek
| Amit látsz | Általában azt jelenti |
|---|---|
NoClassDefFoundError, ClassNotFoundException | Hiányzó függőség, vagy más verzióra készült plugin vagy mod |
NoSuchMethodError | Valami, amit más játékverzióra építettek |
OutOfMemoryError | A szervernek elfogyott a RAM-ja |
FAILED TO BIND TO PORT vagy Address already in use | A port foglalt, gyakran egy még futó második példány miatt |
found character '\t' that cannot start any token | Tabulátor egy YAML konfigurációs fájlban; a YAML csak szóközt engedélyez |
NullPointerException | Programhiba, vagy egy hiányzó, illetve elírt konfigurációs érték |
Összeomlási jelentések
Néhány játék külön, részletesebb jelentést is ír, amikor összeomlik.
- A Minecraft a
crash-reportsmappába menti őket, a dátummal és az időponttal elnevezve. A fájl eleje közelében találsz egyDescriptionsort és a kivételt. A moddolt szerverek felsorolják minden betöltött modot, a Forge és a NeoForge jelentései pedig gyakran rámutatnak egy megvádolt modra. - Egy Java összeomlás, amely magát a Javát viszi le, egy
hs_err_pidfájlt hagy maga után (a név után egy számmal) a szerver fő mappájában. Ezek rendszerint a memóriára vagy egy natív könyvtárra mutatnak, nem egy pluginra.
Hol élnek a naplók a paneledben
A Console (konzol) fül az élő kimenetet mutatja. Csak a friss sorokat tartja meg, ezért bármi régebbihez nyisd meg a naplófájlokat a Files (fájlok) fülön, vagy töltsd le őket SFTP segítségével.
| Játék | Hol keresd |
|---|---|
| Minecraft Java | logs/latest.log; a régebbi naplók .log.gz fájlok a logs mappában (töltsd le és csomagold ki); az összeomlások a crash-reports mappában |
| Valheim BepInEx-szel | BepInEx/LogOutput.log |
| ARK: Survival Evolved és Ascended | ShooterGame/Saved/Logs/ShooterGame.log |
| Don't Starve Together | server_log.txt a DoNotStarveTogether/config/server/Master és a .../Caves mappában, szilánkonként egy |
| Enshrouded | Az enshrouded_server.json fájl logDirectory beállításában megadott mappa, alapértelmezés szerint a logs |
| Más játékok | Amit a Console kiírt; keress egy logs vagy Logs mappát, illetve .log végű fájlokat is |
Amikor a panel összeomlást jelent
Ha a szerverfolyamat váratlanul megáll, a panel kiírhatja a saját üzenetét arról, hogy a szerver összeomlott, egy kilépési kóddal együtt. Néhány, amit érdemes ismerni:
- 0: normál leállás.
- 1: a játék hiba miatt lépett ki; olvasd el a közvetlenül fölötte lévő sorokat.
- 137: a folyamatot erőszakkal leállították, rendszerint azért, mert túllépte a memóriakorlátját. Lásd a jelek, hogy a szervered kifogy a RAM-ból útmutatót.
- 139: natív összeomlás magában a játékban.
Egy hosszú napló átkutatása
- Töltsd le a naplót, és nyisd meg egy szövegszerkesztőben.
- Használd a keresést (Ctrl+F, Macen Cmd+F) az
ERROR, aztán azException, aztán aCaused bykifejezésre. - Keress rá a legutóbb hozzáadott plugin vagy mod nevére.
- Vesd össze az időbélyegeket azzal, amikor a probléma történt.
Segítségkérés naplóval
Másold ki az utolsó normál sortól az első hiba végéig, és szövegként illeszd be, ne képernyőképként. Mielőtt bárhol megosztod, vedd ki belőle a jelszavakat, a tokeneket és minden privát dolgot. Aztán hozd be a Discordunkba, ahol a csapat veled együtt el tudja olvasni. Kifejezetten az indulási problémákról lásd a szerver elakadt az indulásnál útmutatót.
Még mindig elakadtál? Gyere be a Discordunkra a discord.gg/GuavaHost címen, és a csapat segít.
- logs
- crash report
- stack trace
- console
- troubleshooting
- errors
Még mindig elakadtál? Csapatunk a nap 24 órájában online, és megválaszolja a kérdéseidet.