Comment corriger les avertissements de blocage du thread serveur

Un avertissement de blocage du thread serveur signifie qu'une frame serveur a pris plus de temps que prévu. Un avertissement pendant le démarrage n'est pas la même chose que des blocages répétés en cours de jeu. Capturez la charge de travail et identifiez le délai avant de remplacer du matériel ou de désactiver des ressources.

Les exemples de configuration et de code ici ciblent FiveM pour GTA V Legacy. Enhanced a des règles d'exécution et de compatibilité différentes ; vérifiez les changements Legacy-to-Enhanced de Cfx.re avant de les appliquer à un serveur Enhanced.

Déterminez à quel moment le blocage se produit

Enregistrez l'avertissement, son horodatage, le nombre de joueurs et l'action en cours. Notez les modifications récentes de ressources ou de configuration. Comparez le démarrage, un serveur inactif et l'action de jeu qui déclenche le problème. Vérifiez le CPU de l'hôte, la pression mémoire et l'activité du disque en même temps.

Capturez la charge de travail du serveur

Exécutez ces commandes dans la console FXServer ou dans la console du serveur de txAdmin. Le nombre est exprimé en frames, non en millisecondes.

profiler record 500
profiler status

Attendez que l'enregistrement soit terminé, puis examinez-le :

profiler view

Pour une capture serveur, copiez le lien du visualiseur dans votre navigateur. Concentrez l'enregistrement sur le problème. Recherchez du code de ressource à exécution longue autour des frames lentes ; examinez également la contention de l'hôte ou les traitements bloquants lorsque l'avertissement ne correspond à aucun pic de script.

Effectuez une seule modification fondée sur des preuves

Si la capture pointe vers une ressource, examinez la boucle, le gestionnaire d'événements ou l'accès aux données concerné. Les traitements répétés ont peut-être leur place dans un événement ou dans une mise à jour moins fréquente ; les requêtes coûteuses nécessitent une analyse propre à chaque requête. N'augmentez pas aveuglément les temps d'attente dans le code de contrôle du jeu exécuté à chaque frame.

Désactivez une ressource suspecte facultative uniquement sur une copie de test et vérifiez d'abord ses dépendances. Mettez à jour les artefacts en utilisant la procédure de mise à jour d'exécution documentée ; un git pull générique ne met pas à jour toutes les installations FXServer.

Vérifiez le résultat

Répétez la même action sous une charge de travail comparable et réalisez une nouvelle capture. Vérifiez la fréquence et la durée des blocages ainsi que l'expérience des joueurs. Annulez la modification si elle perturbe le jeu ou si elle ne traite pas la cause mesurée. Un problème de FPS côté client ou une latence réseau nécessite sa propre analyse.

Référence

Guide du profiler Cfx.re