Resposta rápida
Se um agente ou job em Durable Objects para quando o navegador, aplicativo ou cliente HTTP desconecta, atualize o Worker para compatibility_date 2026-10-01 ou posterior. Em um projeto que ainda precisa manter uma data anterior, adicione a flag durable_object_io_tasks_prevent_eviction. A mudança faz operações de I/O pendentes continuarem impedindo a remoção do objeto da memória mesmo sem um cliente conectado.
A proteção não torna a execução ilimitada nem transforma memória em armazenamento durável. Cada operação pendente evita a parada por até 15 minutos, a cobrança de duração continua e o processo ainda pode reiniciar por deploy, atualização da plataforma ou decisão do runtime. Salve checkpoints no Durable Object Storage e projete o trabalho para retomar com segurança.
O que mudou em 1º de outubro
A Cloudflare passou a proteger tarefas sem cliente conectado quando existe uma chamada pendente por service binding, RPC ou fetch para outro Durable Object. Promessas enviadas a ctx.waitUntil(), timers de setTimeout() e setInterval() e this.ctx.container.monitor() também entram no novo comportamento.
Antes dessa mudança, o runtime podia considerar o Durable Object ocioso depois que o cliente encerrava a conexão e remover a instância da memória enquanto uma dessas operações ainda aguardava resposta. O efeito aparecia como job incompleto, ferramenta de agente interrompida ou monitoramento de Container que desaparecia sem o retorno esperado.
Como ativar sem mudar todo o runtime de uma vez
A opção padrão é definir compatibility_date como 2026-10-01 ou uma data posterior no wrangler.jsonc ou wrangler.toml. A nova data só passa a valer no próximo deploy. Como a data também ativa outras mudanças de compatibilidade acumuladas, teste o Worker, suas bindings e os fluxos de armazenamento antes de promover a versão para produção.
Se o projeto precisa conservar uma compatibility date antiga, use durable_object_io_tasks_prevent_eviction em compatibility_flags. Para desligar explicitamente o comportamento em uma data nova, existe a flag durable_object_io_tasks_do_not_prevent_eviction. Não configure as duas ao mesmo tempo e registre a escolha para evitar que um deploy posterior mude o comportamento sem revisão.
- Crie um ambiente de teste com a mesma configuração de bindings e storage da produção.
- Atualize compatibility_date ou adicione apenas a flag de ativação.
- Faça o deploy e registre a versão usada no teste.
- Inicie um job, encerre o cliente e confira se a operação termina e grava o checkpoint esperado.
- Promova gradualmente e acompanhe duração, erros e reinicializações.
Quais operações agora mantêm o objeto ativo
O anúncio cobre service bindings aguardando resposta, chamadas RPC ou fetch para outro Durable Object, promises registradas com ctx.waitUntil(), timers pendentes e container.monitor(). Para Containers, monitor() resolve quando o processo termina e rejeita quando ele falha, por isso o padrão recomendado continua sendo registrá-lo em waitUntil() e tratar os dois resultados.
O sinal importante é uma operação realmente pendente. Criar uma Promise sem trabalho de I/O, iniciar uma função sem await ou guardar estado apenas em uma variável não oferece continuidade confiável. Quando o Durable Object reinicia, o constructor roda novamente e qualquer monitor em memória precisa ser registrado outra vez se o Container ainda estiver ativo.
O limite de 15 minutos e a cobrança
Cada operação pendente impede a eviction por no máximo 15 minutos. Uma nova operação iniciada depois pode estender o período em que o objeto permanece na memória, mas o limite é aplicado a cada operação, não como uma garantia de execução contínua para o job inteiro. Um loop que cria operações apenas para manter a instância viva aumenta custo e não substitui uma arquitetura recuperável.
Enquanto a operação evita a remoção, o Durable Object continua gerando cobrança de duração. Compare a duração antes e depois do deploy, principalmente em agentes que esperam ferramentas, Containers ou outros objetos. Se o trabalho pode aguardar sem manter memória ativa, alarmes, filas e retomada por checkpoint costumam ser escolhas mais previsíveis.
Por que waitUntil não elimina checkpoints
ctx.waitUntil() informa ao runtime que uma Promise faz parte do trabalho em segundo plano, mas não promete que a mesma instância viverá para sempre. Deploys, falhas e reinicializações continuam possíveis. Antes de cada etapa com efeito externo, grave um identificador idempotente, o estágio atual e os dados mínimos necessários para retomar sem repetir uma cobrança, envio ou alteração.
Para tarefas longas, divida o fluxo em etapas pequenas e confirmáveis. Ao retomar, leia o estado durável, detecte o que já foi concluído e execute somente o próximo passo. Use alarmes ou uma fila para reagendar o que ultrapassa a janela, em vez de depender de um timer em memória por tempo indefinido.
- Crie um ID único para o job e registre o estado inicial no storage.
- Salve o checkpoint antes e depois de cada chamada externa relevante.
- Torne cada etapa idempotente para que uma repetição não duplique efeitos.
- Defina timeout e tratamento de erro para toda dependência remota.
- Reagende pelo mecanismo durável quando a janela de execução não for suficiente.
Como testar a desconexão de verdade
Não valide apenas mantendo a aba aberta. Inicie uma tarefa que chama outro Durable Object, uma service binding ou monitor(), capture o ID do job e feche a conexão do cliente antes da resposta. Depois, consulte o estado por uma nova requisição e confirme nos logs que a operação original terminou, que o checkpoint foi salvo e que não houve execução duplicada.
Repita o teste com uma dependência que demora, outra que falha e uma execução próxima de 15 minutos. Compare compatibility date, flag ativa, versão implantada e timestamps. Se todas as sessões falham ao mesmo tempo, consulte o Cloudflare Status; se apenas um ID falha, investigue o fluxo, a binding, o checkpoint e a exceção daquele objeto.
Falhas comuns depois da migração
O primeiro erro é alterar o arquivo de configuração sem fazer um novo deploy. Outros casos incluem usar a flag de desativação por engano, iniciar trabalho assíncrono fora de waitUntil(), esquecer await em uma chamada, confiar em estado apenas na memória ou interpretar 15 minutos como duração garantida do job completo.
Também é possível a tarefa terminar e o cliente não receber a resposta, porque a conexão já foi encerrada. Separe o estado do job da resposta HTTP: devolva um identificador, ofereça um endpoint de consulta e registre conclusão ou erro no storage. Não exponha IDs internos, conteúdo privado, tokens ou payloads sensíveis em logs públicos.
Limitações e próxima ação útil
Este guia foi verificado em 1º de outubro de 2026. A mudança protege operações pendentes específicas, não qualquer código assíncrono. Ela também não preserva variáveis, timers ou promises depois que o objeto reinicia. A documentação de ciclo de vida continua sendo a referência para hibernação, eviction, shutdown e cobrança.
Faça um teste controlado hoje: ative o comportamento em um ambiente de teste, inicie um job com checkpoint, desconecte o cliente e confirme a conclusão por uma nova consulta. Meça a duração cobrada e simule uma reinicialização. Só depois aplique a compatibilidade nova aos agentes e jobs de produção.
Faça o próximo teste
Fontes consultadas
Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.
- Pending I/O operations keep Durable Objects activeCloudflare Changelog
- Lifecycle of a Durable ObjectCloudflare Docs
- Compatibility datesCloudflare Docs
- Durable Object Container APICloudflare Docs
- Cloudflare StatusCloudflare
