Ir para o conteúdo
Promovaweb

Cache, expiração e memória no Redis

O cache no Redis é uma chave com prazo de validade, o TTL, que o próprio servidor apaga quando o prazo vence. Quando a memória reservada pelo maxmemory enche, a política de despejo escolhe quais chaves saem, mas a política padrão, noeviction, não apaga nenhuma e faz o Redis recusar as gravações novas do app.

Ficha e sumário da página

Referência técnica
Redis 8.10.3
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O caminho de uma chave de cache
  2. Como o TTL apaga as chaves
  3. O limite do maxmemory
  4. A política de despejo
  5. Como conferir se o cache funciona

O caminho de uma chave de cache

Um cache guarda a cópia de uma resposta que custa caro produzir, como uma consulta pesada ao banco do app. A documentação do Redis registra que essas entradas são cópias de algo gravado em outro lugar, por isso perder uma chave de cache custa só uma consulta refeita. O app consulta o Redis primeiro e só vai ao banco quando a chave não existe:

  1. Leitura sem acerto

    GET relatorio:mes

    A chave não existe, o Redis responde nil e soma uma leitura ao keyspace_misses.

  2. Consulta ao banco

    O app faz a consulta original no PostgreSQL ou no MySQL e monta a resposta.

  3. Gravação com prazo

    SET relatorio:mes "..." EX 300

    O app grava a resposta com validade de 300 segundos.

  4. Leituras com acerto

    GET relatorio:mes

    Enquanto a chave existe, a resposta sai da memória. Cada acerto soma uma leitura ao keyspace_hits.

  5. Expiração

    TTL relatorio:mes

    Quando o prazo chega a zero, o Redis apaga a chave e o ciclo recomeça.

O ciclo de uma chave de cache: a primeira leitura falha, o app consulta o banco e grava a resposta com prazo, as leituras seguintes saem da memória até o TTL vencer.

O Laravel segue esse desenho no método Cache::remember, que lê a chave e, quando ela falta, executa a função que você passou, grava o resultado com o prazo informado e devolve o valor. Com o driver redis, o cache usa a conexão cache do config/database.php, que aponta para o banco lógico 1. As filas ficam no banco 0, na conexão default.

Como o TTL apaga as chaves

O prazo entra junto com a gravação, como no SET com a opção EX, ou depois, com o comando EXPIRE. O comando TTL devolve quantos segundos faltam, enquanto o PERSIST remove o prazo. Um SET novo sobre a mesma chave também zera o prazo, porque ele substitui o valor inteiro. Já os comandos que alteram o valor, como INCR ou LPUSH, mantêm o prazo que existia.

A documentação do comando EXPIRE descreve as duas formas de apagar chaves vencidas. Na forma passiva, o Redis confere o prazo quando um cliente tenta ler a chave e, se ela venceu, apaga a chave e responde como se ela não existisse. Na forma ativa, o servidor sorteia periodicamente algumas chaves com prazo e apaga as vencidas, para que uma chave que ninguém lê de novo não ocupe memória indefinidamente.

O limite do maxmemory

A diretiva maxmemory define quanto de RAM o Redis pode usar para as chaves. O valor padrão é zero, que significa sem limite nos sistemas de 64 bits. Numa VPS com o banco do app, o worker e o Traefik dividindo a memória, um Redis sem limite pode crescer até o kernel encerrar, por falta de memória, algum processo, que pode ser o próprio Redis ou o banco.

Com o limite definido, o Redis compara a memória usada com o maxmemory quando um comando precisa de memória nova e aplica a política de despejo quando passa do limite. A documentação recomenda deixar uma folga de RAM além do maxmemory quando o Redis grava AOF ou tem réplicas, porque os buffers dessas funções não entram no cálculo do limite.

A política de despejo

A diretiva maxmemory-policy escolhe o que acontece quando o limite chega. O redis.conf da versão 8.10.3 traz noeviction como padrão:

PolíticaQuais chaves podem sairQuando faz sentido
noevictionNenhuma. Comandos que precisam de memória nova, como SET e LPUSH, recebem erro. As leituras continuam funcionando.Redis com filas, porque uma tarefa apagada some sem aviso.
allkeys-lruQualquer chave, começando pelas usadas há mais tempo.Redis só de cache. A documentação aponta esta como o ponto de partida quando você não tem motivo para outra.
allkeys-lfuQualquer chave, começando pelas usadas com menos frequência.Cache com um grupo pequeno de chaves lidas muito mais que as outras.
volatile-lruSó chaves com TTL, começando pelas usadas há mais tempo.Um Redis que mistura cache com prazo e chaves que precisam ficar.
volatile-ttlSó chaves com TTL, começando pelas de menor prazo restante.Quando o seu código define prazos curtos para as chaves mais baratas de refazer.

A lista oficial tem ainda a volatile-lfu, que aplica a frequência de uso só às chaves com prazo. Desde o Redis 8.6, as variantes allkeys-lrm e volatile-lrm olham para a última modificação em vez da última leitura. Há também as variantes aleatórias allkeys-random e volatile-random. As políticas volatile-* se comportam como noeviction quando nenhuma chave tem prazo.

Como conferir se o cache funciona

O comando INFO stats traz os números que mostram o comportamento do cache. O keyspace_hits registra as leituras que encontraram a chave, enquanto o keyspace_misses registra as que não encontraram. A documentação calcula a taxa de acerto dividindo os acertos pela soma dos dois. Com a taxa abaixo do esperado e o evicted_keys alto, a política está despejando as chaves erradas com frequência. Para esse quadro, a documentação sugere testar o allkeys-lru. Com o evicted_keys baixo e o expired_keys alto, o app está usando prazos curtos demais ou pondo prazo nas chaves erradas.

O INFO memory mostra a memória usada e o pico. Com esses números, você escolhe o maxmemory pelo consumo real do app. Um cache que não chega ao limite dispensa a política de despejo, porque o TTL já apaga as chaves antes. Quando o Redis guarda filas, o número que importa é outro: o tamanho de cada lista, que a página Filas e pub/sub nos apps explica a partir do Sidekiq, do n8n e do Laravel.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.