Watchdog : serveur bloqué, thread dump
Ce que le watchdog de Paper affiche lorsque le serveur se bloque, comment lire un thread dump et comment trouver le coupable.
Mis à jour le 13 août 2026
[Server Watchdog] The server has stopped responding! THIS IS NOT A PAPER BUG!
[Server Watchdog] Please report this to the makers of the plugin/mod...
Current Thread: Server thread
...
Le watchdog a détecté que le thread principal ne répondait pas plus longtemps que la limite autorisée et a affiché la pile d'appels.
Comment la lire
Lisez les lignes de la pile de haut en bas et cherchez le premier nom de paquet non vanilla : com.example.plugin..., net.someMod.... C'est le coupable — il exécutait une opération qui ne s'est jamais terminée.
Si toute la pile est vanilla, regardez de quelle opération il s'agit : génération de chunks, traitement des entités, sauvegarde du monde.
Constats fréquents
| Dans la pile | Cause |
|---|---|
| Nom d'un plugin | Plugin — Un plugin fait planter le serveur |
Accès à la base de données (java.sql, jdbc) | MySQL injoignable, requête synchrone |
Appel réseau (HttpURLConnection) | Le plugin attend un service externe |
ChunkGenerate, ServerChunkCache | Génération lourde — Chargement des chunks |
| Threads du GC et longues pauses | Mémoire — Garbage collector |
Configuration
Le seuil du watchdog se règle dans config/paper-global.yml (watchdog.early-warning-every, early-warning-delay). Augmenter le délai d'attente juste pour qu'il « ne plante pas » ne fait que masquer le problème.
Que faire ensuite — Le serveur est bloqué.
