Errores de MySQL en plugins

Muchos plugins guardan sus datos en MySQL. Estos son los errores más frecuentes al conectarlos y cómo resolverlos. Si aún no tienes una base de datos, empieza por crearla en el panel.

«Access denied for user»

[ERROR] Access denied for user 'usuario'@'host' (using password: YES)

Las credenciales del plugin no coinciden con las del panel.

• Compara usuario, contraseña y nombre de la base de datos con lo que muestra Bases de datos. Errores típicos: un espacio al copiar la contraseña, confundir el nombre de la base de datos con el usuario.
• Si eliminaste y volviste a crear la base de datos, las credenciales cambiaron: actualízalas en el plugin.
• Si migraste o copiaste la configuración de otro servidor, las credenciales eran de otra instancia: usa las nuevas.

«Communications link failure» / «Can't connect to MySQL server»

CommunicationsException: Communications link failure
Can't connect to MySQL server on 'host' (Connection refused)

• Host incorrecto: no es localhost. Copia el host exactamente como aparece en Bases de datos.
• Puerto incorrecto: usa el que indica el panel, no asumas el 3306.
• Un fallo puntual: reinicia el servidor de Minecraft. Si persiste, contacta con soporte.
• MySQL externo (no el de MixelNodes): su cortafuegos debe permitir conexiones desde el servidor.

«Too many connections»

Se alcanzó el límite de conexiones simultáneas. Pasa si muchos plugins comparten la misma base de datos, si un plugin no cierra bien sus conexiones o si el servidor se reinicia muchas veces seguidas.

• Reduce el tamaño del *pool* de conexiones del plugin. En LuckPerms, por ejemplo, pool-settings.maximum-pool-size (10 es un valor razonable; prueba con menos).
• Reinicia el servidor para cerrar las conexiones huérfanas.
• Si sigue, avísanos: puede que haya que ajustar el límite.

«Unknown database» / «Table doesn't exist»

• Unknown database: el nombre en la configuración del plugin no existe. Comprueba en Bases de datos que existe y que el nombre es exacto (distingue mayúsculas).
• Table doesn't exist: el plugin no llegó a crear sus tablas, normalmente porque el primer arranque falló a medias. Si no tienes datos que conservar, borra la base de datos, créala de nuevo con el mismo nombre y reinicia: el plugin creará las tablas desde cero.

Gestión avanzada

Puedes conectarte con un cliente como DBeaver, HeidiSQL, TablePlus o MySQL Workbench usando los datos de Bases de datos.

Modificar tablas a mano puede estropear los datos de un plugin. Hazlo solo si sabes lo que haces y tienes una copia reciente.

Para una copia manual de una base de datos desde tu ordenador:

mysqldump -h HOST -P PUERTO -u USUARIO -p NOMBRE_DB > copia.sql
mysql -h HOST -P PUERTO -u USUARIO -p NOMBRE_DB < copia.sql   # para restaurarla

Lista de comprobación

• La base de datos existe en Bases de datos.
• El host y el puerto son los del panel (no localhost, no 3306 por suposición).
• Usuario, contraseña y nombre de la base de datos, sin espacios y con las mayúsculas correctas.
• Reiniciaste el servidor después de cambiar la configuración del plugin.