Depure um problema do FiveM reproduzindo um sintoma, encontrando o primeiro erro relevante e alterando uma causa em um servidor de teste. Mantenha os últimos arquivos funcionando e o banco de dados correspondente disponíveis antes de mexer na produção.
Escolha a evidência certa
Uma falha apenas do cliente ou erro de UI precisa da saída F8 do jogador afetado e dos passos de reprodução. Uma saída de processo do servidor precisa dos logs do FXServer/host e de qualquer referência de falha. Uma entrada lenta precisa de tempo por estágio; FPS baixo precisa de evidência de tempo de quadro do cliente. Vários jogadores com lag juntos podem precisar de medições de servidor e rede.
Registre o horário UTC, jogadores afetados, localização, ação, artefato, versões de framework/recurso e mudanças recentes. Remova credenciais e identificadores pessoais dos logs compartilhados.
Leia o primeiro erro
Use seu ambiente de lançamento real: console txAdmin e seus logs configurados, um diário de serviço ou saída de processo redirecionada. Não há um caminho universal server-data/server.log para cada instalação.
Leia o primeiro erro envolvendo o recurso, incluindo seu arquivo, linha e rastreamento de pilha. Exportações ausentes posteriores podem ser consequências de uma dependência anterior falha. Para um valor nulo, inspecione o produtor do valor e o caminho de retorno em vez de inserir um padrão cegamente.
Reproduza com segurança
- Crie uma cópia isolada com configuração representativa e dados de teste. Confirme se o erro ainda ocorre lá.
- Verifique dependências, nomes exatos de pastas e ordem de inicialização antes de editar a lógica. Em um host sensível a maiúsculas e minúsculas, a capitalização do caminho do arquivo importa.
- Reduza a reprodução ao menor conjunto de recursos afetados, preservando as dependências necessárias. Desative um suspeito por vez.
- Aplique uma correção direcionada, repita a ação original e teste o caminho de falha relevante com um jogador sem privilégios.
- Reconecte, reinicie o recurso e execute uma reinicialização completa do servidor. Mantenha a correção apenas se a persistência e as permissões permanecerem corretas.
Use diagnósticos para seu propósito real
A referência de comandos do servidor documenta refresh, ensure e restart. Esses comandos podem interromper o estado ativo dos recursos; use-os em um ambiente de testes ou em uma janela de manutenção coordenada.
se_debug true habilita o log de ACL/segurança, não um modo de depuração de script geral. Desative-o com se_debug false após a investigação de permissão. Um set debug_mode true personalizado não tem efeito a menos que um recurso leia explicitamente essa convar.
Use o profiler para analisar a execução de scripts. O Resmon funciona no cliente e não informa o tempo das consultas ao banco de dados nem o custo total para a GPU.
Escalone com um relatório útil
Inclua o comportamento esperado versus o real, os passos exatos de reprodução, o primeiro erro completo, as versões relevantes e o que mudou. Forneça um pequeno trecho de configuração com segredos removidos. Mantenha os despejos de recursos não relacionados e os dados do jogador privados.
Se o problema de produção piorar, restaure o último recurso/configuração aceito. Restaure um banco de dados apenas quando necessário e após contabilizar o progresso mais recente do jogador.