VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
mysql2, e então mede o que acontece com a contagem de conexões do MySQL sob carga concorrente com cada padrão.
O Que Este Guia Testou, e O Que Não Testou
Tudo abaixo foi executado contra um servidor VillageSQL local real e um processo Node real. A aplicação é um app Hono construído com o templatenodejs (npm create hono@latest), que roda como um processo Node comum de longa duração durante os testes deste guia, sem ser implantado no Cloudflare Workers, no AWS Lambda ou no edge runtime da Vercel.
Isso importa para uma afirmação específica que este guia faz e para uma que ele não faz:
- O que foi testado de verdade: um handler de requisição que abre uma conexão MySQL nova toda vez que é executado, em comparação com um handler que reutiliza um pool de conexões criado uma vez no carregamento do módulo. Disparar requisições HTTP concorrentes contra cada versão e observar a contagem de conexões do MySQL é uma reprodução fiel do que acontece dentro de uma única instância de função serverless que processa invocações concorrentes, ou de uma instância em cold start cujo código de nível de módulo é executado novamente.
- O que não foi testado: o efeito de multiplicação de muitos ambientes de execução separados fazendo cold start ao mesmo tempo, cada um rodando sua própria cópia deste processo e abrindo seu próprio pool. Um pico real de tráfego no AWS Lambda ou no Cloudflare Workers pode iniciar dezenas de instâncias isoladas simultaneamente, e um pool de 10 conexões em cada uma delas se acumula rápido, mesmo com a correção deste guia aplicada. A seção “Além de uma Única Instância” abaixo cobre o que fazer a respeito, mas isso não era algo que o processo Node deste guia, que é uma única instância por definição, pudesse reproduzir.
Configure o Banco de Dados
Crie um banco de dados dedicado e um usuário restrito a ele:Crie a Estrutura da Aplicação
Este guia usa o templatenodejs do Hono, que roda sobre @hono/node-server e não exige uma plataforma de nuvem específica para o desenvolvimento:
mysql2 e o drizzle-kit:
drizzle-orm e drizzle-kit publicam tags de pré-lançamento (beta, rc) em dist-tags ao lado de latest. Verifique antes de instalar:
latest para drizzle-orm resolve para 0.45.2 e para drizzle-kit resolve para 0.31.10, ambas versões estáveis, não release candidates.
Defina a string de conexão em .env:
Defina o Esquema e Execute a Migração
src/db/schema.ts
drizzle.config.ts
O Antipadrão: Uma Conexão por Requisição
A forma mais comum em que esse problema aparece é um código que parece razoável isoladamente. Ele abre uma conexãomysql2, executa uma consulta e fecha a conexão, tudo dentro do handler da requisição:
src/index.bad.ts
Demonstrando o Esgotamento
Omax_connections do MySQL é um teto para o servidor inteiro, e reduzi-lo em um servidor compartilhado para forçar uma falha afetaria todas as outras conexões daquela instância. Uma forma mais direcionada de reproduzir um teto de conexões para uma única aplicação, e que os provedores de MySQL em nuvem usam exatamente por essa razão, é o MAX_USER_CONNECTIONS na própria conta:
serverless_app limitado a 15 conexões, uma rajada de 30 requisições concorrentes por 5 segundos (usando o autocannon) produziu isto:
serverless_app durante a rajada, a cada 150 ms com SELECT COUNT(*) FROM information_schema.processlist WHERE user = 'serverless_app', mostrou a contagem subindo até o limite de 15 conexões e passando dele (15, 15, 16, 17, 17, 17, 17, 25 nas amostras mais altas). Essas 3614 respostas não 2xx são esse limite sendo atingido. O handler acima captura o erro e o retorna no corpo de cada 503, então isto é o que as respostas com falha carregavam:
MAX_USER_CONNECTIONS. Um servidor sem nenhum limite por usuário mostraria a mesma contagem crescente contra o max_connections, e o mesmo erro com outro nome (ERROR 1040 (08004): Too many connections) assim que o teto do servidor inteiro fosse atingido. O limite por usuário é o que torna isso reproduzível sem perturbar qualquer outra coisa em execução no mesmo servidor.
A Correção: Crie o Pool Uma Vez, Fora do Handler
A correção não é parar de usar pool. É garantir que o pool seja criado exatamente uma vez, no carregamento do módulo, em vez de dentro da função que trata cada requisição:src/db/index.ts
src/index.ts
db/index.ts executa sua chamada mysql.createPool() de nível superior exatamente uma vez, sempre que o módulo é importado pela primeira vez. Em um servidor Node de longa duração, isso significa uma vez na inicialização do processo. Em um runtime serverless cujo provedor reutiliza o ambiente de execução para uma requisição posterior sem cold start, o módulo importado ainda está na memória, então o pool da primeira invocação é reutilizado em vez de recriado. Somente um cold start genuíno, que recarrega o módulo do zero, abre um novo pool.
Executando a mesma rajada de 30 requisições concorrentes por 5 segundos contra esta versão, ainda com serverless_app limitado a 15 conexões:
connectionLimit do pool, em todas as amostras coletadas. O pool nunca pediu ao MySQL mais conexões do que foi configurado para manter abertas, independentemente de quantas requisições concorrentes chegaram. A vazão total também foi cerca de três vezes maior na mesma janela de 5 segundos (77.000 requisições contra 25.000). Parte dessa diferença é a versão com pool pulando um handshake TCP completo e uma rodada de autenticação em cada requisição; outra parte é que muitas das 25.000 requisições da versão do antipadrão foram falhas 503 rápidas depois que o limite de conexões foi atingido, em vez de uma consulta concluída, o que infla sua contagem de requisições sem fazer trabalho real.
Além de uma Única Instância
A correção acima resolve o problema que este guia pôde reproduzir: requisições concorrentes dentro de uma instância em execução. Ela não resolve um segundo problema que só aparece em uma plataforma serverless real: muitas instâncias separadas fazendo cold start ao mesmo tempo durante um pico de tráfego, cada uma rodando sua própria cópia deste código e, portanto, abrindo seu próprio pool. Um pool abre conexões de forma preguiçosa, somente conforme as requisições concorrentes realmente precisam delas, então dez instâncias ociosas não abrem 100 conexões só por existirem. Mas, assim que cada instância está processando um tráfego modesto e comum, dez instâncias com umconnectionLimit de 10 cada podem somar 100 conexões bem antes de a carga de trabalho parecer algo fora do normal. O processo Node deste guia não pôde reproduzir isso, porque é um processo, não muitos.
Duas abordagens tratam disso, e nenhuma delas substitui a correção acima; elas são aditivas:
- Defina um
connectionLimitmuito menor por instância, frequentemente 1 ou 2 em vez de 10, já que cada instância em execução concorrente processa um número pequeno de requisições por vez na maioria das plataformas serverless. - Coloque um proxy de pooling de conexões na frente do MySQL, como o ProxySQL, para que muitas instâncias serverless separadas compartilhem um número muito menor de conexões MySQL reais. Consulte Pooling de Conexões no MySQL para ver como o ProxySQL se encaixa nisso.
Perguntas Frequentes
Por que não simplesmente aumentar max_connections?
Isso eleva o teto, mas não o remove, e cada conexão tem um custo real de memória no servidor (consulte Pooling de Conexões no MySQL para o detalhamento do custo por conexão). Uma carga de trabalho serverless que pode escalar para centenas de instâncias concorrentes vai acabar atingindo qualquer teto fixo; a correção é impedir que cada instância abra mais conexões do que precisa, não elevar o número que essas instâncias podem esgotar.
Isso se aplica ao Express tanto quanto ao Hono?
Sim. O modo de falha diz respeito a onde o pool ou a conexão é criado em relação ao handler da requisição, não a qual framework web roteia a requisição. Um app Express commysql.createConnection() chamado dentro de um handler de rota tem o problema idêntico, e mysql.createPool() chamado uma vez no escopo do módulo tem a correção idêntica.
O pool integrado do mysql2 é suficiente, ou preciso de algo como o ProxySQL?
Para um único servidor de longa duração, o pool do mysql2 é suficiente por si só; é isso que Pooling de Conexões no MySQL cobre. Em uma plataforma serverless, o padrão de pool em nível de módulo deste guia impede que uma instância abra mais conexões do que seu connectionLimit, mas ele não consegue coordenar entre instâncias separadas em execução concorrente. Um proxy como o ProxySQL é o que coordena entre instâncias.
Por que a contagem de conexões da versão corrigida ficou exatamente em 10 em vez de subir até 30, acompanhando a concorrência do teste?
Porque o pool temwaitForConnections: true e um connectionLimit de 10. Assim que 10 conexões estão em uso, a décima primeira requisição concorrente espera que uma delas seja devolvida ao pool em vez de abrir uma nova. As requisições entram em fila brevemente em vez de o pool crescer sem limite.
Solução de Problemas
Veja também
- Pooling de Conexões no MySQL — como o pooling funciona em um servidor de longa duração, e como o ProxySQL coordena o pooling entre vários servidores de aplicação
- Next.js e Drizzle com MySQL — o mesmo esquema e a mesma configuração do Drizzle em um servidor Next.js de longa duração, sem o ciclo de vida de conexão serverless
- Usando MySQL com ORMs: Django, Rails e Prisma — configurando as opções de pool específicas do MySQL em ORMs além do Drizzle