Após ativar a aceleração do Alibaba Cloud CDN, alguns elementos da página não carregam porque a filtragem de parâmetros remove as query strings antes de encaminhar as solicitações à origem. Desative a filtragem de parâmetros para restaurar o acesso.
Sintoma
Após ativar a aceleração CDN para o seu domínio, os visitantes relatam que determinados elementos — imagens, scripts ou outros recursos — não carregam. O domínio funcionava corretamente antes da aceleração CDN.
Causa
A filtragem de parâmetros está ativada no seu domínio CDN. Quando ativa, o CDN remove todos os parâmetros de consulta das URLs antes de encaminhar as solicitações ao servidor de origem. Por exemplo:
Um visitante solicita:
https://example.com/image.jpg?version=2&size=largeO CDN encaminha à origem:
https://example.com/image.jpg
Isso afeta o comportamento de cache de duas formas:
O CDN trata todas as solicitações para o mesmo recurso — independentemente dos parâmetros de consulta — como idênticas, servindo o conteúdo a partir de uma única cópia em cache.
Recursos que dependem de parâmetros de consulta para retornar conteúdo diferente (como imagens geradas dinamicamente ou ativos baseados em API) recebem respostas incorretas ou vazias.
Se o seu site usa URLs com parâmetros após o ponto de interrogação (?), a filtragem de parâmetros faz com que essas solicitações falhem ou retornem resultados inesperados.
Solução
Desative a filtragem de parâmetros para o domínio afetado.
Faça login no console do Alibaba Cloud CDN e clique em Domain Names no painel de navegação à esquerda.
Encontre o nome de domínio que deseja gerenciar e clique em Manage na coluna Actions. Na página de gerenciamento, desative a filtragem de parâmetros.
Verifique a correção
Após desativar a filtragem de parâmetros, confirme que o carregamento dos elementos foi restaurado:
Limpe o cache do navegador e o cache do CDN para o domínio afetado.
Solicite um recurso usando uma URL que inclua parâmetros de consulta.
Verifique se o conteúdo correto carrega. Se a sua origem retorna respostas diferentes de acordo com os parâmetros de consulta, confirme que o CDN entrega cada variante corretamente.
Práticas recomendadas
Considere o seguinte para evitar problemas semelhantes:
Use uma ordem de parâmetros consistente. O CDN trata URLs com os mesmos parâmetros em ordens diferentes como chaves de cache separadas. Por exemplo,
image.jpg?color=red&size=largeeimage.jpg?size=large&color=redsão armazenados em cache como dois objetos distintos. Liste os parâmetros sempre na mesma ordem — a ordem alfabética é uma convenção confiável.Use capitalização consistente nos parâmetros. Nomes e valores de parâmetros diferenciam maiúsculas de minúsculas na correspondência de chaves de cache. Use letras minúsculas de forma consistente em todas as suas URLs.
Revise a filtragem de parâmetros antes de ativá-la. A filtragem de parâmetros é adequada apenas para recursos em que os parâmetros de consulta não afetam a resposta — por exemplo, parâmetros de rastreamento adicionados a URLs de ativos estáticos. Ativá-la para recursos dinâmicos ou dependentes de parâmetros causa esse problema.