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
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:
Leitura sem acerto
GET relatorio:mesA chave não existe, o Redis responde nil e soma uma leitura ao keyspace_misses.
Consulta ao banco
O app faz a consulta original no PostgreSQL ou no MySQL e monta a resposta.
Gravação com prazo
SET relatorio:mes "..." EX 300O app grava a resposta com validade de 300 segundos.
Leituras com acerto
GET relatorio:mesEnquanto a chave existe, a resposta sai da memória. Cada acerto soma uma leitura ao keyspace_hits.
Expiração
TTL relatorio:mesQuando o prazo chega a zero, o Redis apaga a chave e o ciclo recomeça.
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:
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.