Depura un problema de FiveM reproduciendo un síntoma, encontrando el primer error relevante y cambiando una causa en un servidor de prueba. Mantén los últimos archivos funcionales y la base de datos correspondiente disponibles antes de tocar la producción.
Elige la evidencia correcta
Un fallo solo del cliente o un error de interfaz de usuario necesita la salida F8 del jugador afectado y los pasos de reproducción. Una salida del proceso del servidor necesita los registros de FXServer/host y cualquier referencia de fallo. Una conexión lenta al servidor requiere medir el tiempo de cada etapa; un FPS bajo necesita evidencia del tiempo de fotograma del cliente. Varios jugadores con lag juntos pueden necesitar mediciones del servidor y de la red.
Registra la hora UTC, los jugadores afectados, la ubicación, la acción, el artefacto, las versiones del framework/recurso y los cambios recientes. Oculta las credenciales y los identificadores personales en los registros que compartas.
Lee el primer error
Usa tu entorno de lanzamiento real: la consola de txAdmin y sus registros configurados, un diario de servicio o la salida del proceso redirigida. No existe una ruta universal server-data/server.log para cada instalación.
Lee el primer error que involucre el recurso, incluyendo su archivo, línea y pila de llamadas. Las exportaciones faltantes posteriores pueden ser consecuencias de una dependencia anterior fallida. Para un valor nulo, inspecciona el productor del valor y la ruta de retorno en lugar de insertar un valor predeterminado a ciegas.
Reproduce de forma segura
- Crea una copia aislada con una configuración representativa y datos de prueba. Confirma que el error aún ocurre allí.
- Verifica las dependencias, los nombres exactos de las carpetas y el orden de inicio antes de editar la lógica. En un host sensible a mayúsculas y minúsculas, la capitalización de la ruta del archivo es importante.
- Reduce la reproducción al conjunto de recursos afectados más pequeño, conservando las dependencias requeridas. Deshabilita un sospechoso a la vez.
- Aplica una corrección específica, repite la acción original y prueba la ruta de fallo relevante con un jugador sin privilegios.
- Vuelve a conectar, reinicia el recurso y realiza un reinicio completo del servidor. Mantén la corrección solo si la persistencia y los permisos siguen siendo correctos.
Usa los diagnósticos para su propósito real
La referencia de comandos del servidor documenta refresh, ensure y restart. Estos comandos pueden alterar el estado de recursos activos; utilízalos en el entorno de pruebas o durante una ventana de mantenimiento coordinada.
se_debug true habilita el registro de ACL/seguridad, no un modo de depuración de script general. Desactívalo con se_debug false después de la investigación de permisos. Un set debug_mode true personalizado no tiene efecto a menos que un recurso lea explícitamente esa convar.
Utiliza el perfilador para la ejecución de scripts. Resmon funciona del lado del cliente y no informa del tiempo de las consultas a la base de datos ni del coste total de GPU.
Escala con un informe útil
Incluye el comportamiento esperado versus el real, los pasos exactos de reproducción, el primer error completo, las versiones relevantes y lo que cambió. Proporciona un pequeño extracto de configuración con los secretos eliminados. Mantén privados los volcados de recursos no relacionados y los datos del jugador.
Si el problema de producción empeora, restaura el último recurso/configuración aceptado. Restaura una base de datos solo cuando sea necesario y después de contabilizar el progreso más reciente del jugador.