MySQL Connector/J: cómo conectar Java con MySQL mediante JDBC

Para que una aplicación Java se conecte a MySQL necesita un controlador JDBC compatible: MySQL Connector/J. El conector traduce las llamadas de la API JDBC de Java al protocolo que entiende el servidor MySQL. Añadirlo al proyecto no basta por sí solo: también hay que indicar la URL de conexión, las credenciales y las condiciones de acceso al servidor.

La mayoría de los fallos se localizan comprobando esas piezas por separado. Si la aplicación no encuentra el controlador, el problema suele estar en las dependencias; si el controlador carga pero la conexión se rechaza, hay que revisar la red, el nombre de la base de datos, la autenticación o la configuración de MySQL.

Qué aporta Connector/J y qué no configura

JDBC, sigla de Java Database Connectivity, es la interfaz estándar que permite a una aplicación Java ejecutar operaciones sobre bases de datos. Connector/J es la implementación de esa interfaz para MySQL. El código de la aplicación utiliza clases y métodos JDBC, mientras que el controlador se ocupa de comunicarse con el servidor MySQL.

El conector no instala ni inicia MySQL, no crea automáticamente la base de datos y tampoco concede permisos al usuario. Esas tareas corresponden al servidor y a su administración. En una conexión remota, además, la máquina donde se ejecuta Java debe poder alcanzar el servidor por la red y el usuario de MySQL debe tener permisos desde ese origen.

Para una solución de análisis o gestión de datos, Connector/J es una pieza de acceso, no una herramienta para procesar grandes volúmenes por sí sola. El diseño de tablas, las consultas y la gestión de datos pertenecen a otras capas. En el portal se pueden consultar contenidos sobre bases de datos para ampliar esa parte del trabajo.

Instalar el controlador en el proyecto

En un proyecto Java moderno lo habitual es declarar Connector/J en el sistema de construcción para que la dependencia se descargue y se incluya en el classpath. El identificador Maven utilizado por el conector es com.mysql:mysql-connector-j. La versión debe elegirse atendiendo a la versión de Java, del servidor MySQL y a las dependencias del proyecto; no es recomendable copiar una versión al azar de un ejemplo antiguo.

En Maven, la dependencia se declara dentro de <dependencies> con ese grupo y artefacto, además de una versión adecuada al entorno. En Gradle se incorpora con la configuración de dependencias que corresponda al tipo de aplicación, por ejemplo como dependencia de ejecución si solo se necesita durante la ejecución. Tras modificar el archivo del proyecto, hay que sincronizar o reconstruirlo y comprobar que el artefacto aparece en las dependencias resueltas.

Si se gestiona el classpath manualmente, el archivo JAR del controlador debe estar disponible tanto al compilar como al ejecutar la aplicación, según cómo se use el código. Un error del tipo «No suitable driver» suele indicar que el controlador no está presente en el entorno de ejecución o que la URL no es compatible con él. En aplicaciones gestionadas por un servidor o empaquetadas como contenedor, también hay que verificar que el JAR se distribuya en el artefacto final y no solo en el entorno de desarrollo.

Crear una conexión JDBC sin complicar el código

Una URL de conexión habitual tiene esta forma: jdbc:mysql://servidor:3306/base_datos. En ella, servidor es el nombre DNS o la dirección del equipo que aloja MySQL, 3306 es el puerto predeterminado frecuente y base_datos identifica el esquema al que se quiere acceder. El puerto real puede ser distinto si el servidor se ha configurado de otra manera.

Este ejemplo es hipotético y muestra la estructura básica; los valores entre corchetes deben sustituirse por los del entorno:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

String url = "jdbc:mysql://[servidor]:3306/[base_datos]";
String usuario = "[usuario]";
String contrasena = "[secreto]";

try (Connection conexion = DriverManager.getConnection(url, usuario, contrasena)) {
    System.out.println("Conexión establecida");
} catch (SQLException e) {
    System.err.println("No se pudo conectar: " + e.getMessage());
}

El bloque try-with-resources cierra la conexión automáticamente al terminar, incluso si se produce una excepción. En una aplicación real, las credenciales no deberían escribirse directamente en el código fuente ni subirse al repositorio. Es preferible obtenerlas de la configuración protegida del entorno o de un gestor de secretos, con permisos limitados para la cuenta utilizada por la aplicación.

En las versiones actuales del ecosistema JDBC, el controlador se registra automáticamente cuando está disponible en el classpath. Por eso, llamar a Class.forName("com.mysql.cj.jdbc.Driver") suele ser innecesario en proyectos modernos. Si un sistema antiguo lo requiere, hay que distinguir esa carga explícita de la instalación del JAR: escribir el nombre de la clase no incorpora el controlador al proyecto.

Localizar el fallo según el mensaje y el punto de conexión

El controlador no aparece

Si Java indica que no encuentra un controlador adecuado, comprueba primero que la dependencia se ha resuelto y que está incluida al ejecutar. Revisa también que la cadena empieza por jdbc:mysql: y no por un prefijo de otro motor. Si funciona desde el IDE pero no desde el servidor, compara el classpath de ambos entornos y el contenido del paquete desplegado.

El servidor no responde

Un tiempo de espera agotado suele apuntar a conectividad: dirección o puerto incorrectos, cortafuegos, reglas de red, servidor detenido o servicio que solo escucha en una interfaz local. Comprueba desde el mismo equipo o contenedor que ejecuta Java si el host y el puerto son accesibles. Una conexión que funciona en el portátil del desarrollador no demuestra que funcione desde producción, porque pueden existir redes y permisos distintos.

MySQL rechaza el acceso

Un error de autenticación exige revisar usuario, contraseña, base de datos y permisos. En MySQL, los permisos de una cuenta pueden depender también del origen desde el que se conecta. Por tanto, una cuenta válida en una consola local podría no tener autorización para acceder desde otra máquina. Evita resolverlo concediendo permisos amplios sin evaluar el alcance necesario: la aplicación debería utilizar una cuenta con acceso limitado a las operaciones y esquemas que necesita.

La conexión se establece, pero falla al consultar

Si la conexión se abre y el error aparece al ejecutar una consulta, el diagnóstico cambia: revisa la sentencia SQL, los nombres de tablas y columnas, los tipos de datos y los privilegios de la operación. También importa el ciclo de vida de la conexión. En una aplicación con varias solicitudes concurrentes, abrir una conexión nueva para cada operación sin control puede consumir recursos; suele ser más apropiado utilizar un pool de conexiones, configurado para el entorno.

Opciones de URL, seguridad y despliegue

La URL puede incluir parámetros para ajustar aspectos de la conexión, pero no conviene añadirlos por costumbre. Algunas opciones relacionadas con zonas horarias, codificación o TLS dependen de la versión del controlador y de la configuración del servidor. Si aparece un error de zona horaria, identifica primero el mensaje exacto y comprueba cómo están configurados Java y MySQL; no añadas parámetros encontrados en una respuesta antigua sin verificar que corresponden a la versión instalada.

Para conexiones que atraviesan redes no confiables, la protección del transporte debe configurarse de forma coherente en el cliente y en el servidor. Desactivar la verificación o el cifrado para silenciar un error no es una solución segura. En producción, confirma qué certificados y políticas exige el entorno y prueba la conexión con esa configuración.

Antes de desplegar, verifica desde el entorno real que el controlador está empaquetado, que la URL apunta al servidor correcto, que las credenciales se cargan desde una fuente protegida y que la cuenta tiene permisos suficientes, pero acotados. Prueba también el cierre de conexiones y el comportamiento ante una interrupción de red. Así se separan con rapidez los problemas de dependencia de los de acceso, configuración o consulta, que requieren correcciones distintas.