Tutoriais de VPS
MySQL 2006/2013 no VPS: conexão perdida, pools e pacotes (2026)
Diagnostique pelo momento da falha: reinícios, pools antigos, pacotes e prazos. Valide tentativas seguras e ajustes reversíveis.

A primeira requisição após inatividade falha com MySQL server has gone away, uma importação para em ERROR 2006 ou uma exportação longa retorna ERROR 2013: Lost connection to MySQL server during query. Todos indicam conexão perdida, mas a etapa determina a correção.
Registre horário, erro completo, operação e logs antes de diferenciar conexão antiga do pool, pacote grande, timeout de transporte/cliente ou reinício. O guia cobre MySQL 8.0/8.4 autogerenciado no Linux, com exemplos conferidos na documentação 8.4. MariaDB, serviços gerenciados e outros drivers exigem referências próprias de parâmetros/permissões.
| Momento | Primeira investigação | Validação |
|---|---|---|
| Primeira requisição após pausa; atualizar funciona | Sessão expirada no pool ou timeout intermediário | Aguardar além do intervalo original e testar a primeira requisição |
| Importação/INSERT falha no mesmo ponto | Tamanho de instrução/BLOB e limites dos dois lados | Repetir lote isolado e conferir registros |
| Consulta/exportação interrompida | Timeout do driver, rede, transferência e logs | Completar pela rota original |
| Várias aplicações juntas | Reinício, OOM, manutenção ou troca de proxy | Uptime e erros |
| Nova conexão falha com authorization packet | Handshake, rede e connect_timeout | Conectar do cliente original |
O MySQL descreve 2006/CR_SERVER_GONE_ERROR como incapacidade de enviar a requisição e 2013/CR_SERVER_LOST como resposta incompleta. Descrevem a falha, não a causa. Veja erros do cliente. Para 1040 Too many connections, use pools/max_connections: mais vagas não corrigem uma conexão encerrada.
Bash roda no VPS; SQL, no cliente. Troque diagnostic_user por conta diagnóstica existente; -p solicita senha. Globals/alterações exigem permissões adequadas.
# 数据库确实监听在本机 TCP 3306 时使用
mysql --protocol=TCP -h 127.0.0.1 -P 3306 -u diagnostic_user -p --skip-reconnect
No Docker, use o projeto Compose correto; db é exemplo:
docker compose exec db mysql -u diagnostic_user -p --skip-reconnect
Mantenha portas privadas. Desativar reconexão automática do cliente revela falhas; não altera o driver web. Veja opções mysql.
Colete consultas de leitura com horário:
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 pertence a esta sessão diagnóstica. A aplicação pode inicializar valores diferentes. Aborted_clients e Aborted_connects acumulam encerramentos anormais de sessões estabelecidas e falhas de conexão, respectivamente. Compare incrementos; um total não atribui o incidente. Veja erros de comunicação.
Se várias aplicações falham juntas, confira MySQL. Unifique fusos de aplicação, banco e kernel. No systemd, o serviço pode 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
Sem rg, use grep -Ei. Leia o arquivo log_error quando journal não tiver todos os erros.
No projeto 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
Supõe um contêiner db; confira todas as réplicas. Relacione saídas, reinícios, OOMKilled e inicialização ao horário. Estado atual pode esconder a saída anterior; OOMKilled=false não substitui logs históricos do kernel.
Em OOM, confira memória do host/contêiner, conexões e picos. Não aumente pools e pacotes juntos com pouca RAM. Reiniciar perde evidências; apagar dados ou docker compose down -v não corrige desconexão. Veja server has gone away.
A aplicação devolve a sessão; banco/proxy a fecha; a próxima requisição descobre ao enviar SQL. Confira:
wait_timeoutna conexão real da aplicação.- Prazos menores no proxy, túnel ou rede.
- Verificação ao emprestar, descarte e reciclagem por idade.
wait_timeout controla espera ociosa não interativa; clientes interativos podem inicializar diferente. SET GLOBAL normalmente não atualiza sessões existentes. Veja variáveis do sistema.
Em serviço que já usa SQLAlchemy 2.x/PyMySQL, altere o Engine existente:
import os
from sqlalchemy import create_engine
engine = create_engine(
os.environ["DATABASE_URL"],
pool_pre_ping=True,
pool_recycle=900,
)
Forneça mysql+pymysql pelo ambiente sem imprimir. 900 segundos é ilustrativo: fique abaixo da expiração confirmada, considerando custo de reconexão. Não crie Engine por requisição.
pool_pre_ping verifica ao emprestar; pool_recycle substitui por idade ao emprestar. Não protegem conexão já em uso numa transação. Evite compartilhar conexões entre pai/filhos. Veja SQLAlchemy pools. Outros drivers têm opções próprias. Após deploy, aguarde o intervalo original e teste a primeira requisição; atualizar logo após reiniciar não reproduz a condição.
Procure ER_NET_PACKET_TOO_LARGE e meça instrução, BLOB ou string individuais. Backup de 2 GB não exige pacote de 2 GB: importa o pacote, SQL ou registro. Cliente e servidor têm limites; veja Packet Too Large.
Reduza lotes primeiro. Se dados comprovam necessidade de 128 MiB, registre o original e confira memória antes do exemplo:
-- 由有权限的管理员执行;这是运行时修改
SELECT @@GLOBAL.max_allowed_packet AS original_packet_limit;
SET GLOBAL max_allowed_packet = 134217728;
No MySQL 8.4, max_allowed_packet de sessão é somente leitura; SET SESSION não altera. Mude global, reconecte e confira novas sessões; renove pools ordenadamente. Não aloca todo o limite ao abrir, mas pacotes grandes concorrentes pressionam memória. Veja max_allowed_packet.
Use destino isolado, com backup e resultados verificáveis. Este exemplo mostra importação 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
Adapte conta, arquivo e banco. --max-allowed-packet pertence ao CLI, não necessariamente ao driver. Confira USE, CREATE DATABASE e nomes qualificados de banco; restrinja a conta ao destino.
Não repita importação parcial cegamente: pode haver commits. Determine lotes completos, conflitos únicos e segurança de repetição; recrie o destino isolado ou continue lote confirmado. --force não transforma ignorar erros em sucesso.
| Ajuste | Controla | Interpretação incorreta |
|---|---|---|
wait_timeout | Sessão conectada ociosa | Duração de toda SQL |
connect_timeout | Handshake de conexão | Consulta já conectada |
net_read_timeout | Espera de dados do cliente | Toda exportação |
net_write_timeout | Envio ao cliente | Ignorar consumo lento |
| Timeout de leitura/escrita do driver | Espera/envio no cliente | Muda automaticamente com o servidor |
| HTTP/proxy/tarefa | Prazo de requisição/job | Sempre desconexão SQL |
Veja variáveis do servidor. Em falhas após tempos semelhantes, compare todos os prazos. Driver a 30 segundos com consulta de 45 exige revisão de plano/índices/tarefa antes de aumentar. Para resultados grandes, confira paginação, streaming, consumo e rede; evite scans ilimitados em produção.
Somente com evidência de timeout de upload, ajuste temporariamente a mesma conexão dedicada de importação e restaure/feche ao terminar. 2013 sozinho não basta. Compare a mesma SQL local/remota, depois proxy, túnel, perdas e resets. Sucesso local apenas reduz o escopo; veja conexão perdida.
Valide runtime primeiro. Registre globals, sessões da aplicação, origem, horário, alcance e resultado. Em arquivo já carregado, este é um exemplo:
[mysqld]
max_allowed_packet=128M
Editar arquivo não muda necessariamente runtime. Confira montagens, argumentos e volumes Docker; alterações na camada gravável podem desaparecer. Programe reinícios necessários sem interromper por variável dinâmica.
SET PERSIST altera globals e escreve mysqld-auto.cnf nos dados. Coordene arquivo, argumentos e persistência. Recriar preserva apenas com diretório/carregamento apropriados. Veja variáveis persistidas.
Reverta runtime e origem ao registrado. Com SET PERSIST, restaure persistência anterior ou remova apenas a nova exceção. RESET PERSIST remove persistência sem restaurar runtime; não limpe todas as configurações. Releia globals/sessões novas para detectar sobrescrita na inicialização.
Leituras permitem tentativas limitadas conforme o negócio. Em pedidos, pagamentos, estoque ou migrações, não receber sucesso não prova ausência de execução/commit.
- Descarte conexão inválida e crie outra.
- Confira ID de negócio, chave idempotente ou auditoria.
- Se necessário e seguro, repita a transação completa com limite e espera progressiva.
- Reconcilie resultado incerto/efeitos externos sem repetir automaticamente uma instrução.
Reconectar não preserva transações, variáveis ou temporários; veja efeitos da reconexão. Health checks não evitam falhas durante transações; SQLAlchemy exige tratamento na aplicação.
- Processo estável: uptime aumenta sem reinício/OOM/crash correlacionado.
- Pool estável: primeira requisição após intervalo funciona sem reconectar infinitamente.
- Pacotes grandes: lote original isolado completo, com registros/resultados conferidos.
- Operações longas: rota original retorna resultados completos.
- Ajustes efetivos: runtime, persistência e novas sessões coerentes.
- Capacidade: conexões, memória e incrementos sem novos 1040/OOM.
- Tentativas seguras: sem duplicar pedidos, migrações ou importações.
Um SELECT 1 bem-sucedido comprova essa tentativa. Observe condições originais por pelo menos um ciclo da falha.
Renova conexões/libera recursos, mas expiração, pacotes e OOM podem voltar. Preserve evidências e teste a condição.
Atrasa limpeza ociosa, mas não corrige proxy/rede ou transações e mantém recursos por mais tempo. Corrija descarte e orçamento primeiro.
Não: rede, saída do processo, pacotes e prazo do cliente também. Relacione horário/logs antes de mudar SQL/timeouts.
Exija etapa, valor, logs, capacidade e reversão de cada ajuste. Ele pode ordenar cronologia, revisar inicialização do pool e preparar diferenças. Preserve reconciliação explícita antes de repetir escritas/migrações.