Tutoriales de VPS
MySQL 2006/2013 en VPS: conexión perdida, pools y paquetes (2026)
Diagnostica por el momento del fallo: reinicios, pools antiguos, paquetes y plazos. Valida reintentos seguros y ajustes reversibles.

La primera petición tras inactividad falla con MySQL server has gone away, una importación se detiene en ERROR 2006 o una exportación larga devuelve ERROR 2013: Lost connection to MySQL server during query. Todos indican conexión perdida, pero la fase determina la reparación.
Registra hora, error completo, operación y logs antes de distinguir conexión antigua del pool, paquete grande, timeout de transporte/cliente o reinicio. La guía cubre MySQL 8.0/8.4 autogestionado en Linux, con ejemplos contrastados con documentación 8.4. MariaDB, servicios gestionados y otros drivers requieren sus referencias de parámetros y privilegios.
| Momento | Primera investigación | Validación |
|---|---|---|
| Primera petición tras inactividad; recargar funciona | Sesión caducada del pool o timeout intermedio | Esperar más que el intervalo original y probar la primera petición |
| Importación/INSERT falla en un punto similar | Tamaño de sentencia/BLOB y límites de ambos lados | Repetir lote aislado y verificar filas/resultados |
| Consulta/exportación se corta | Timeout del driver, red, transferencia y logs | Completar por la ruta original |
| Varias aplicaciones a la vez | Reinicio, OOM, mantenimiento o cambio de proxy | Uptime y errores |
| Conexión nueva falla con authorization packet | Negociación, red y connect_timeout | Conectar desde el cliente original |
MySQL describe 2006/CR_SERVER_GONE_ERROR como imposibilidad de enviar la petición y 2013/CR_SERVER_LOST como respuesta incompleta. Describen el fallo, no la causa. Consulta errores del cliente. Para 1040 Too many connections, usa pools/max_connections: más conexiones no reparan una cerrada.
Bash se ejecuta en el VPS; SQL, en el cliente. Sustituye diagnostic_user por una cuenta diagnóstica existente; -p solicita contraseña. Para globals/cambios necesitas privilegios adecuados.
# 数据库确实监听在本机 TCP 3306 时使用
mysql --protocol=TCP -h 127.0.0.1 -P 3306 -u diagnostic_user -p --skip-reconnect
En Docker usa el proyecto Compose correcto; db es ejemplo:
docker compose exec db mysql -u diagnostic_user -p --skip-reconnect
Mantén privados los puertos. Desactivar reconexión automática del cliente hace visible el fallo; no cambia el driver web. Consulta opciones mysql.
Guarda consultas de solo lectura con hora:
SELECT NOW() AS sampled_at, VERSION() AS mysql_version,
@@hostname AS server_host, @@port AS server_port,
CONNECTION_ID() AS diagnostic_connection_id;
SELECT @@GLOBAL.wait_timeout AS global_wait_timeout,
@@SESSION.wait_timeout AS session_wait_timeout,
@@GLOBAL.interactive_timeout AS global_interactive_timeout,
@@GLOBAL.max_allowed_packet AS global_max_allowed_packet,
@@SESSION.max_allowed_packet AS session_max_allowed_packet,
@@SESSION.net_read_timeout AS session_net_read_timeout,
@@SESSION.net_write_timeout AS session_net_write_timeout,
@@GLOBAL.connect_timeout AS global_connect_timeout;
SHOW GLOBAL STATUS
WHERE Variable_name IN
('Uptime', 'Aborted_clients', 'Aborted_connects',
'Threads_connected', 'Threads_running');
SHOW GLOBAL VARIABLES
WHERE Variable_name IN ('log_error', 'log_error_verbosity');
SESSION corresponde a esta sesión diagnóstica. La aplicación puede inicializar otros valores. Aborted_clients y Aborted_connects acumulan cierres anormales de sesiones establecidas e intentos de conexión fallidos respectivamente. Compara incrementos; un total no atribuye el incidente. Consulta errores de comunicación.
Si fallan varias aplicaciones, revisa MySQL. Unifica zonas horarias de aplicación, base y kernel. En systemd el servicio puede ser mysqld:
sudo systemctl status mysql --no-pager -l
sudo journalctl -u mysql --since '30 minutes ago' --no-pager -n 200
sudo journalctl -k --since '30 minutes ago' --no-pager |
rg -i 'out of memory|oom|killed process'
free -h
df -h
df -i
Sin rg, usa grep -Ei. Lee el archivo log_error si journal no contiene todos los errores.
En el proyecto Docker:
docker compose ps -a
docker compose logs --since 30m --tail 200 db
db_container_id=$(docker compose ps -a -q db)
if [ -n "$db_container_id" ]; then
docker inspect --format 'Name={{.Name}} RestartCount={{.RestartCount}} State={{json .State}}' "$db_container_id"
docker stats --no-stream "$db_container_id"
fi
Supone un contenedor db; revisa todas las réplicas. Relaciona salidas, reinicios, OOMKilled e inicio con la desconexión. El estado actual puede ocultar la salida anterior; OOMKilled=false no sustituye el kernel histórico.
Ante OOM, revisa memoria del host/contenedor, conexiones y picos. No aumentes pools y paquetes juntos con poca RAM. Reiniciar borra pruebas; eliminar datos o docker compose down -v no repara desconexiones. Consulta server has gone away.
La aplicación devuelve la sesión; la base/proxy la cierra; la próxima petición lo descubre al enviar SQL. Revisa:
wait_timeouten la conexión real de la aplicación.- Límites más cortos en proxy, túnel o red.
- Comprobación al retirar, descarte y reciclado por edad.
wait_timeout controla espera ociosa no interactiva; clientes interactivos pueden inicializar distinto. SET GLOBAL normalmente no actualiza las sesiones existentes. Consulta variables de sistema.
En un servicio que ya utiliza SQLAlchemy 2.x/PyMySQL, modifica su Engine existente:
import os
from sqlalchemy import create_engine
engine = create_engine(
os.environ["DATABASE_URL"],
pool_pre_ping=True,
pool_recycle=900,
)
Proporciona mysql+pymysql por entorno sin imprimirlo. 900 segundos es ilustrativo: debe quedar por debajo de la caducidad comprobada, considerando coste de conexión. No crees Engine por petición.
pool_pre_ping verifica al retirar; pool_recycle sustituye por edad al retirar. No protegen una conexión ya prestada en una transacción. Evita compartir conexiones entre padre/hijos. Consulta SQLAlchemy pools. Otros lenguajes usan opciones diferentes. Espera el intervalo original tras desplegar y prueba la primera petición; recargar justo tras reinicio no reproduce el fallo.
Busca ER_NET_PACKET_TOO_LARGE y mide una sentencia, BLOB o cadena. Una copia de 2 GB no requiere paquetes de 2 GB: importa el paquete individual, SQL o fila. Cliente y servidor tienen límites; consulta Packet Too Large.
Reduce lotes primero. Si necesitas 128 MiB según datos, registra original y verifica memoria antes del ejemplo:
-- 由有权限的管理员执行;这是运行时修改
SELECT @@GLOBAL.max_allowed_packet AS original_packet_limit;
SET GLOBAL max_allowed_packet = 134217728;
En MySQL 8.4, max_allowed_packet de sesión es de solo lectura; SET SESSION no lo cambia. Cambia global, reconecta y verifica nuevas sesiones; renueva pools ordenadamente. No reserva todo el máximo al abrir, pero paquetes grandes concurrentes consumen más. Consulta max_allowed_packet.
Usa destino aislado, respaldado y verificable. El ejemplo muestra importación TCP local:
mysql --protocol=TCP -h 127.0.0.1 -P 3306 \
-u restore_user -p --skip-reconnect --max-allowed-packet=128M \
restore_test < /srv/backups/restore-test.sql
Adapta cuenta, archivo y base. --max-allowed-packet pertenece al CLI, no necesariamente al driver. Revisa USE, CREATE DATABASE y nombres de base cualificados; restringe permisos al destino.
No repitas a ciegas una importación parcial: puede haber commits. Determina lotes completos, conflictos únicos y seguridad de repetición; recrea el destino aislado o continúa un lote confirmado. --force no convierte omitir errores en éxito.
| Ajuste | Controla | Interpretación equivocada |
|---|---|---|
wait_timeout | Sesión conectada ociosa | Duración de toda SQL |
connect_timeout | Negociación de conexión | Consultas ya conectadas |
net_read_timeout | Espera de datos del cliente | Cualquier exportación |
net_write_timeout | Envío al cliente | Ignorar consumo lento |
| Timeout lectura/escritura del driver | Espera/envío del cliente | Cambia automáticamente con el servidor |
| HTTP/proxy/tarea | Plazo de petición o trabajo | Siempre desconexión SQL |
Consulta variables del servidor. Ante duraciones similares, compara todos los plazos. Un driver a 30 segundos con consulta de 45 exige revisar plan/índices/diseño antes de ampliar. Para resultados grandes, revisa paginación, streaming, consumo y red; evita escaneos ilimitados en producción.
Solo con pruebas de timeout de carga, ajusta temporalmente la misma conexión dedicada de importación y restaura/cierra al terminar. 2013 por sí solo no basta. Compara la misma SQL local y remota, luego proxy, túnel, pérdidas y resets. El éxito local solo reduce el ámbito; consulta conexión perdida.
Valida primero en ejecución. Registra globals, valores de aplicación, origen de configuración, hora, alcance y resultado. En un archivo ya cargado, este es un ejemplo:
[mysqld]
max_allowed_packet=128M
Editar archivo no cambia necesariamente el runtime. Confirma montajes, argumentos y volumen Docker; cambios en su capa escribible pueden perderse. Programa reinicios necesarios, sin interrumpir por una variable dinámica.
SET PERSIST modifica global y escribe mysqld-auto.cnf en datos. Coordina archivos, argumentos y persistencia. Se conserva al recrear solo con directorio/carga adecuados. Consulta variables persistidas.
Revierte runtime y fuente al original. Con SET PERSIST, restaura persistencia anterior o elimina solo la nueva excepción. RESET PERSIST elimina persistencia sin restaurar runtime; no borres todos los ajustes. Relee globals y sesiones nuevas para detectar sobrescritura al inicializar.
Lecturas admiten reintentos limitados si el negocio lo permite. En pedidos, pagos, inventario o migraciones, no recibir éxito no prueba ausencia de ejecución/commit.
- Descarta conexión inválida y crea otra.
- Comprueba ID de negocio, clave idempotente o auditoría.
- Si es necesario y seguro, repite la transacción completa con límite y espera progresiva.
- Reconcilia resultados inciertos/efectos externos sin repetir automáticamente una sentencia.
Reconectar no conserva transacciones, variables ni temporales; consulta efectos de reconexión. Health checks no evitan fallos durante transacciones; SQLAlchemy exige tratarlos en la aplicación.
- Proceso estable: uptime aumenta sin reinicio/OOM/crash correlacionado.
- Pool estable: primera petición tras el intervalo funciona sin reconexión infinita.
- Paquetes grandes: lote original aislado completo con filas/resultados verificados.
- Operaciones largas: ruta original devuelve resultados completos.
- Ajustes efectivos: runtime, persistencia y sesiones nuevas coherentes.
- Capacidad: conexiones, memoria e incrementos sin nuevos 1040/OOM.
- Reintentos seguros: sin duplicar pedidos, migraciones o importaciones.
Un SELECT 1 correcto acredita esa conexión. Observa condiciones originales durante al menos un ciclo del fallo.
Renueva conexiones/libera recursos, pero timeout, paquetes y OOM pueden repetirse. Conserva pruebas y valida la condición.
Retrasa limpieza ociosa, pero no arregla proxy/red ni transacciones; mantiene recursos más tiempo. Corrige descarte y presupuesto primero.
No: red, salida del proceso, paquetes o plazo del cliente también. Relaciona hora y logs antes de cambiar SQL/timeouts.
Exige fase, valor, logs, capacidad y reversión de cada ajuste. Puede ordenar cronología, revisar inicialización del pool y preparar diferencias. Conserva conciliación explícita antes de repetir escrituras/migraciones.