Como remover a mensagem de erro "Request headers must contain only ASCII characters"

Publicado em25/07/2024

•

Última atualização em14/08/2025

4 min de leitura

A mensagem "Request headers must contain only ASCII characters" pode ser exibida no navegador do usuário quando ele está navegando na loja e tenta acessar uma nova página ou realizar uma ação no site, por exemplo, adicionando itens no carrinho de compras.

Este cenário ocorre se a página ou funcionalidade solicitada contém um cookie com caracteres especiais (não-ASCII).

${"base64":" ","img":{"width":652,"height":165,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":23377,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/removendo-mensagem-de-erro-request-headers-must-contain-only-ascii_1.png"}}$

Segundo as normas do IETF (Internet Engineering Task Force), instituição responsável por documentar os padrões utilizados na internet, cookies não devem conter caracteres especiais (não-ASCII). Para mais informações sobre os caracteres aceitos em cookies e headers, acesse IETF - Request for Comments 7230 - Section 3.2.6 - Field Value Components.

Soluções

Para remover a mensagem de erro e permitir que a página ou funcionalidade possa ser acessada novamente, é necessário realizar as seguintes ações:

Identificar cookie com caracteres especiais
Desabilitar cookie com caracteres especiais
Criar script de limpeza do cache

Identificando cookies com caracteres especiais

Na página em que a mensagem "Request headers must contain only ASCII characters" foi exibida, siga os passos abaixo para identificar qual cookie contém caracteres especiais:

Acesse o DevTools em seu navegador pressionando a tecla F12 ou clicando com o botão direito, e escolhendo a opção Inspecionar.
Na barra superior da tela, acesse a aba Rede e ordene as requisições clicando em Status. A informação 400 no status indica que uma requisição não foi processada corretamente e, dentre os erros possíveis, pode haver cookies incorretos.

${"base64":" ","img":{"width":1093,"height":601,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":247660,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/removendo-mensagem-de-erro-request-headers-must-contain-only-ascii_2.png"}}$

Clique sobre uma requisição e depois na aba Visualização para identificar se o erro encontrado é referente à mensagem "Request headers must contain only ASCII characters".

${"base64":" ","img":{"width":1126,"height":664,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":162802,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/removendo-mensagem-de-erro-request-headers-must-contain-only-ascii_3.png"}}$

Clique na aba Cabeçalhos e copie os dados do cookie.

${"base64":" ","img":{"width":1143,"height":673,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":309887,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/removendo-mensagem-de-erro-request-headers-must-contain-only-ascii_4.png"}}$

Acesse um validador online de caracteres ASCII e insira a informação do cookie. Se um ou mais caracteres especiais forem identificados, os tipos e posições serão exibidas na parte inferior do validador de caracteres.

${"base64":" ","img":{"width":805,"height":745,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":556868,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/removendo-mensagem-de-erro-request-headers-must-contain-only-ascii_5.png"}}$

Repita os passos 3 a 5 com todas as requisições com erro para identificar quais delas contêm cookies com caracteres especiais.

Desabilitando cookies com caracteres especiais

Uma vez identificados os cookies contendo caracteres especiais, é necessário verificar a sua origem para que sejam removidos da página. As fontes mais comuns de cookies incorretos são:

UTMs criados em sua loja ou em campanhas de publicidade do Google, Facebook, entre outros, que possuam caracteres acentuados. Exemplo de UTM utilizado em data comemorativa: www.site.com?utm_source=dia-das-mães.
Javascripts customizados, onde implementações de front-end utilizadas para armazenar dados ou outro tipo de função podem conter caracteres especiais.
Scripts de clientes parceiros que criam cookies com caracteres especiais.

Assim que localizar a procedência do cookie, realize os procedimentos necessários para removê-lo da página ou solicite ao cliente parceiro que interrompa o envio do cookie para a sua loja.

Criando script para remoção de cookies

Ao remover o cookie com caracteres especiais, a página ou funcionalidade deve voltar ao normal e a mensagem "Request headers must contain only ASCII characters" não será mais exibida. Entretanto, esse cenário ocorrerá somente para novos usuários da página, ou seja, clientes que ainda não haviam acessado a página durante o tempo em que o cookie incorreto esteva habilitado.

Usuários que acessaram a página ou funcionalidade enquanto o cookie incorreto estava habilitado continuarão a ver a mensagem de erro "Request headers must contain only ASCII characters" em seu navegador. Isto ocorre porque o cookie foi armazenado no cache do navegador do usuário.

Para resolver este problema, e permitir que todos os usuários tenham acesso correto na loja, é necessário criar um script na página a ser executado no navegador do usuário (client-side) visando realizar a expiração do cookie incorreto.

O script deve configurar o cookie para expirar em uma data antiga (qualquer período anterior a criação do script). Veja um exemplo abaixo:

document.cookie = "cookiename= ; expires = Thu, 01 Jan 1970 00:00:00 GMT"

Se desejar, você também pode incluir no script as seguintes funções:

Interceptar valores de cookies no momento do request da página
Realizar a validação de caracteres ASCII nos cookies
Expirar automaticamente os cookies contendo caracteres especiais
Acionar o recarregamento da página por meio da função window.location.reload()

A remoção dos cookies via script não é uma solução definitiva. Conforme descrito na seção Desabilitando cookies com caracteres especiais, é necessário identificar a origem e interromper o processo de envio de cookies com caracteres especiais.