Tutoriais de VPS
MySQL 1040 no VPS: conexões, pools e max_connections (2026)
Recupere a administração, localize conexões e calcule todos os pools antes de ajustar limites conforme memória e carga reais.

Se o site apresenta ERROR 1040 (HY000): Too many connections, as APIs não acessam o MySQL e até as ferramentas administrativas deixam de conectar, as vagas para clientes comuns podem estar esgotadas. Isso não significa necessariamente um VPS pequeno: mais processos, pools multiplicados, conexões não devolvidas e consultas lentas também causam esse cenário.
A referência principal é MySQL 8.4. Recupere o acesso administrativo, descubra quem ocupa as conexões e ajuste pools e capacidade. Para MySQL 8.0, consulte a documentação dessa versão. MariaDB tem diferenças em privilégios, tabelas e configuração persistente; não copie instruções específicas do MySQL sem revisão.
| Erro ou sintoma | O que investigar |
|---|---|
MySQL 1040 Too many connections | Limite de conexões comuns do servidor esgotado |
Too many user connections ou limite de recursos da conta | Limite por conta, não necessariamente max_connections global |
Access denied ou 1045 | Conta, senha e autenticação |
2003, Connection refused ou timeout | Serviço, endereço, escuta e rede |
Erros da aplicação como QueuePool limit ... timeout | Espera do pool; o servidor pode ainda ter vagas |
Não aumente max_connections apenas porque a aplicação não conecta. Para rede/login, use o guia MySQL/MariaDB; para 1040, consulte Too many connections.
Pause importações, relatórios, consumidores de fila ou instâncias problemáticas identificados como não essenciais. Limite tentativas e use espera progressiva: repetir imediatamente cada requisição pode criar uma tempestade de conexões.
Mantenha a sessão administrativa existente aberta e evite abrir várias outras. Conecte localmente com uma conta já configurada e informe a senha no prompt:
mysql --connect-timeout=5 -u db_admin -p
Substitua a conta de exemplo db_admin e use socket, host e autenticação corretos. sudo mysql não garante acesso sem senha em toda instalação. Em um projeto Compose existente:
docker compose exec mysql mysql --connect-timeout=5 -u root -p
Substitua mysql pelo serviço real. Executar o cliente dentro do contêiner evita misturar falha de rede e limite, mas não contorna esse limite.
O MySQL normalmente reserva uma conexão adicional para contas com CONNECTION_ADMIN. É uma vaga compartilhada, não uma por administrador. Se estiver ocupada, outra janela pode falhar. Prepare privilégios restritos e interfaces administrativas antecipadamente; não dê esse privilégio à aplicação para contornar limites nem exponha 3306 publicamente.
Se ainda não conseguir administrar, reduza tráfego/processos confirmados da aplicação para liberar conexões. Só considere reiniciar o MySQL depois de avaliar impacto, preservar evidências e planejar a recuperação. O reinício derruba todos os clientes, perde informações e pode gerar reconexões simultâneas que repetem o problema.
Confirme primeiro a instância:
SELECT VERSION(), @@hostname, @@port, CURRENT_USER(), CONNECTION_ID();
SHOW GLOBAL VARIABLES
WHERE Variable_name IN (
'max_connections', 'max_user_connections',
'wait_timeout', 'interactive_timeout'
);
SHOW GLOBAL STATUS
WHERE Variable_name IN (
'Threads_connected', 'Threads_running',
'Max_used_connections', 'Connection_errors_max_connections',
'Connections', 'Uptime'
);
Colete amostras pela mesma sessão administrativa:
Threads_connected: conexões abertas atualmente.Threads_running: threads não ociosas, não porcentagem de CPU.Max_used_connections: maior quantidade registrada, não a quantidade atual.Connection_errors_max_connections: recusas por atingir o limite; observe o aumento no intervalo.Connections: tentativas acumuladas; calcule taxas usando diferenças de tempo.
Registre horário e Uptime, pois reinícios e resets mudam a referência. Uma amostra normal após o pico não descarta um 1040 anterior. Consulte as variáveis de status.
No MySQL 8.4, consulte Performance Schema, agrupando por conta/estado antes de examinar sessões longas:
SELECT USER, COMMAND, COUNT(*) AS connection_count,
MAX(TIME) AS longest_state_seconds
FROM performance_schema.processlist
GROUP BY USER, COMMAND
ORDER BY connection_count DESC;
SELECT ID, USER, HOST, DB, COMMAND, TIME, STATE
FROM performance_schema.processlist
ORDER BY TIME DESC
LIMIT 50;
Relacione conta, endereço, logs da aplicação e horário do deploy. HOST costuma incluir a porta do cliente: portas diferentes podem vir da mesma aplicação. Ordenar apenas por TIME não identifica a causa.
Ver sessões de outras contas exige privilégios adequados. Tabelas indisponíveis ou monitoramento incompleto podem produzir uma lista parcial. Veja estrutura e visibilidade de processlist.
Sleep significa que a sessão não executa uma instrução naquele momento. Pools mantêm conexões ociosas. Confira:
- Quantidade frente a réplicas, processos e capacidade.
- Devolução, reutilização e descarte previsto ao fim das requisições.
- Pools novos criados em cada requisição ou tarefa.
- Conexões retidas em erros/cancelamentos e transações sem commit/rollback.
Uma sessão ociosa pode manter transação aberta. Consulte InnoDB:
SELECT trx_mysql_thread_id, trx_started, trx_state
FROM information_schema.innodb_trx
ORDER BY trx_started;
Associe trx_mysql_thread_id ao ID da conexão. Não encerre a transação apenas por existir: verifique função e esperas de bloqueio. Transações longas ocupam conexões e bloqueiam requisições, ampliando latência e pressão.
Controle primeiro a aplicação que as cria. Os IDs abaixo são exemplos; use alvos verificados agora:
KILL CONNECTION 12345;
KILL CONNECTION encerra a conexão e afeta o trabalho; transações pendentes podem sofrer rollback demorado. KILL QUERY interrompe somente a instrução e mantém a conexão, portanto não garante uma vaga. Consulte KILL e seus privilégios.
Não encerre tudo acima de um limite arbitrário de Sleep nem interrompa replicação, backups, administração ou pools normais. Se a aplicação reconecta imediatamente, KILL apenas esvazia a lista por um instante.
Configurar pool_size=10 não limita necessariamente o serviço inteiro a dez conexões. Cada réplica pode ter vários processos com pools independentes e conexões de overflow.
Para pools por processo, calcule réplicas × processos por réplica × capacidade máxima do pool, somando filas, tarefas, administração e outros serviços. No SQLAlchemy QueuePool limitado, a quantidade emprestada depende de pool_size + max_overflow; veja a documentação de pools. Este orçamento é hipotético, não uma medição:
| Origem | Conexões potenciais |
|---|---|
| API: 2 réplicas × 4 processos × (10 do pool + 10 overflow) | 160 |
| Tarefas de fundo | 20 |
| Outros sites e tarefas agendadas | 10 |
| Reserva administrativa e monitoramento | 10 |
| Total | 200 |
Um limite comum de 151 pode ser excedido. É capacidade potencial: o pool não precisa abrir tudo ao iniciar. Compare com observações.
Reduza capacidade, overflow e concorrência desnecessários conforme demanda e capacidade do banco. Preserve margem administrativa. Verifique devolução no sucesso, erro e cancelamento, commit/rollback no prazo e inicialização no ciclo correto do processo. Recalcule ao aumentar réplicas/workers: deploys graduais mantêm versões novas e antigas juntas; aquecimento e reinícios simultâneos geram picos.
Com uso razoável e margem de memória/processamento, pode caber um aumento moderado. No MySQL 8.4, max_connections é global e dinâmico; recursos do sistema podem afetar o valor efetivo. Veja as variáveis de sistema.
Confira memória do host e limites do contêiner:
free -h
vmstat 1 5
docker stats --no-stream
Execute o último comando somente com Docker. A memória livre do host pode superar o limite do contêiner. O custo por conexão varia com buffers, tabelas temporárias e consultas. Colocar 1000 sem medir pode transformar 1040 em OOM; consulte MySQL Docker e memória.
200 é exemplo de sintaxe, não recomendação. Registre o original e calcule um valor adequado:
SET @incident_old_max_connections = @@GLOBAL.max_connections;
SELECT @incident_old_max_connections;
SET GLOBAL max_connections = 200;
SELECT @@GLOBAL.max_connections;
São necessários privilégios administrativos. SET GLOBAL muda o valor em execução sem reiniciar, mas normalmente não o mantém após reinício. Evite ajustar vários parâmetros de memória simultaneamente.
Para reverter na mesma sessão:
SET GLOBAL max_connections = @incident_old_max_connections;
A variável de sessão @incident_old_max_connections desaparece ao desconectar: registre também o número original fora da sessão. Ao reconectar, restaure explicitamente esse número. Reduzir o limite não limpa sessões existentes; avalie as vagas para conexões seguintes.
Com pools, métricas e negócio estáveis, escolha uma forma clara de administrar a configuração. SET PERSIST altera o valor atual e o persiste:
SET PERSIST max_connections = 200;
Substitua o exemplo; consulte SET. Para remover essa configuração persistida:
RESET PERSIST max_connections;
RESET PERSIST remove a persistência sem restaurar o valor atual. Restaure-o separadamente pelo registro. Consulte RESET PERSIST. Se gerencia arquivos, confirme o que é carregado para evitar conflitos entre my.cnf, valores persistidos e argumentos do deploy.
Recriar o contêiner não necessariamente apaga configurações persistidas no diretório de dados. Preserve o volume; o guia MySQL 8.4 com Docker cobre configuração, dados e backups.
wait_timeout controla sessões ociosas, não consultas lentas em execução. Um valor muito curto pode levar o pool a reutilizar conexões encerradas pelo servidor. Diferencie valores globais das sessões existentes e coordene timeout com reciclagem, verificação de conexão e transações longas. Corrija vazamentos e ciclo do pool primeiro; nem 30 nem 60 segundos servem universalmente.
Use a conta e a rota originais para testar login, leitura, escrita e transações importantes. Retome tarefas gradualmente e observe um intervalo que cubra tráfego normal e tarefas agendadas:
Threads_connectedpermanece no orçamento, sem crescimento contínuo.- 1040 e
Connection_errors_max_connectionsdeixam de aumentar. - Latência, espera no pool, erros e memória permanecem aceitáveis.
- Deploys e picos conjuntos de filas/tarefas mantêm margem.
Um login bem-sucedido ou zero conexões após reiniciar não comprovam a correção. Guarde amostras, limites, pools e reversão para incluir o orçamento do banco nas próximas ampliações da aplicação.