Magento 2

Cannot query field no GraphQL do Magento 2: o campo existe e some

A query volta com Cannot query field "meu_campo" on type "ProductInterface" e o campo está lá, escrito no schema.graphqls do seu módulo. Em nove de cada dez vezes o schema não tem culpa: é cache. O Magento costura os arquivos de todos os módulos uma vez, guarda o resultado, e enquanto a versão velha estiver de pé aquele campo simplesmente não existe para o servidor.

A limpeza que resolve

cd /var/www/loja
sudo -u www-data rm -rf generated/code generated/metadata
sudo -u www-data bin/magento setup:upgrade
sudo -u www-data bin/magento setup:di:compile
sudo -u www-data bin/magento cache:flush

Duas ressalvas antes de colar isso em produção. A loja fica fora do ar entre o rm -rf generated/ e o fim do setup:di:compile, então rode em janela de manutenção. E o cache:clean config sozinho não adianta: o schema costurado é gravado com o id Magento_Framework_GraphQlSchemaStitching_Config_Data e sem a tag CONFIG, e o cache:clean apaga por tag. Quem derruba é o cache:flush, que esvazia o storage inteiro. Apagar var/cache na unha também só resolve se o backend for arquivo; com Redis não tem nada ali.

Confirme o que o servidor carregou

Em vez de adivinhar, pergunte ao próprio endpoint quais campos o tipo tem hoje:

curl -s https://sualoja.com.br/graphql 
  -H 'Content-Type: application/json' 
  -d '{"query":"{ __type(name: "ProductInterface") { fields { name } } }"}'

Se a resposta for GraphQL introspection is not allowed, o bloqueio é o graphql/disable_introspection do app/etc/env.php; em produção ele fica ligado mesmo, faça o teste em homologação. Campo fora da lista é problema no servidor: o arquivo precisa estar em app/code/Vendor/Modulo/etc/schema.graphqls, e não em etc/frontend/, porque o leitor de schema roda no escopo global e não olha em subpasta de área. Depois disso, confira se o módulo está ligado com bin/magento module:status Vendor_Modulo.

Última pegadinha: consulta GraphQL por GET entra no full page cache. Depois de mexer no schema, teste com POST, senão você vai debugar meia hora uma resposta que ficou congelada.

Post Recentes

Varnish VCL Magento 2.4.8: gerar o default.vcl com ACL de purge e probe

VCL copiado de tutorial velho não aceita PURGE do admin e não tem probe, então o Varnish serve página de…

37 minutos atrás

Teste de carga no checkout com k6: o script, a leitura do resultado e a hora de parar

Um script k6 que coloca produto no carrinho e abre o checkout do WooCommerce, com thresholds que abortam o teste…

7 horas atrás

Descrição de produto no ChatGPT: o prompt com ficha técnica que não inventa medida

Com a ficha técnica colada no prompt e uma regra para marcar o que falta, o ChatGPT para de inventar…

23 horas atrás

Magento 2 config:set: gravar configuração só num website ou store view

Mude uma configuração apenas para um website pela linha de comando, com --scope e --scope-code, e entenda a herança que…

1 dia atrás

Capturar erro fatal no PHP com register_shutdown_function

Estouro de memória e timeout não caem no try/catch e a página fica branca. Registre um shutdown handler com error_get_last…

2 dias atrás

CLAUDE.md para projeto WordPress: as regras que evitam o Claude Code quebrar o tema

O CLAUDE.md que funciona em projeto WordPress é curto: versões, onde o Claude Code pode mexer, comandos do projeto e…

4 dias atrás