Produto sumiu do Live Search: a sequência certa do saas:resync

Olhe as duas telas antes de rodar comando

A primeira parada é System > Data Transfer > Data Feed Sync Status. Ela mostra, feed por feed, o que foi exportado e o que ficou pelo caminho. A segunda é System > Data Transfer > Data Management Dashboard, que confirma se o dado exportado realmente chegou nos serviços conectados. Uma coisa é o Magento ter gerado o feed; outra é a Adobe ter recebido.

Depois, o log. Todo o processo de exportação grava em um arquivo só:

tail -n 200 var/log/saas-export.log

E confira o básico da casa, porque é aqui que mora metade dos casos: cron e indexadores rodando. Os requisitos do Live Search listam os dois explicitamente, junto com Adobe Commerce 2.4.4 ou mais novo. Cron parado significa feed parado, e nenhum comando manual vai consertar isso de forma duradoura.

Vale saber também que a própria Adobe não recomenda rodar saas:resync de rotina. Os cenários previstos são três: sincronização inicial, troca do SaaS Data Space ID e solução de problema. Quando o Live Search é ativado, a carga inicial acontece sozinha.

A pegadinha que faz o resync não resolver nada

Aqui está o detalhe que faz muita gente rodar o comando, esperar duas horas e não ver diferença. A documentação diz, com todas as letras, que o saas:resync só transmite item novo, alterado ou que falhou no envio anterior. Item cujo hash de conteúdo não mudou desde a última exportação é simplesmente pulado.

Ou seja: se o seu produto foi exportado com um problema lá atrás e o conteúdo dele não mudou desde então, um saas:resync --feed products vai ignorar exatamente o SKU que você quer consertar.

A saída é o --by-ids, que pula a verificação de hash e força o envio:

bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'

Por padrão os valores são SKU. Para usar ID de produto, acrescente --id-type='productId':

bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'

Esse é o comando de primeira tentativa quando o problema é um produto ou um punhado deles. Ele é rápido, cirúrgico e não mexe no resto do catálogo. O --by-ids funciona nos feeds products, productAttributes, productOverrides, inventoryStockStatus, prices, variants e categoryPermissions.

A sequência completa, quando é geral

Se o buraco é maior — trocou o data space, restaurou um dump antigo, catálogo inteiro fora do ar na busca — aí sim vale a sequência completa:

bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed productAttributes
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed products
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed productoverrides

A documentação avisa que não existe dependência rígida entre os feeds — eles podem rodar em qualquer ordem. Essa sequência começa pelos escopos porque é o que os outros feeds referenciam, então é a ordem que dá menos dor de cabeça para conferir.

Nem toda instalação tem todos esses feeds. O productOverrides, por exemplo, exige Adobe Commerce em cloud, on-premises ou como serviço; o feed de orders depende do módulo de vendas. A documentação avisa isso na cara: a lista muda conforme os módulos instalados, então pule o que não existe no seu ambiente.

Prepare-se para esperar. Dependendo do tamanho do catálogo, um resync leva de alguns minutos a algumas horas. Rode em screen ou tmux, não numa sessão SSH que vai cair.

O que não sair fazendo

Tem uma opção que aparece em fórum como bala de prata e não é: o --cleanup-feed. O aviso da Adobe é explícito — ela limpa o estado local de exportação e pode levar a sincronização incompleta. Produto que você apagou no Magento pode continuar aparecendo na busca, e entidade velha pode ficar presa no índice remoto. O uso previsto é reconstrução completa de ambiente, tipo depois de limpar o data space.

Antes de partir para qualquer coisa destrutiva, use a dupla que serve para investigar:

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102'

O --dry-run reindexa o feed sem enviar nada e sem gravar na tabela, e a variável EXPORTER_EXTENDED_LOG=1 despeja o payload gerado no var/log/saas-export.log. É assim que você descobre que o produto está indo sem preço, sem categoria ou com o atributo errado — o que muda completamente o rumo da investigação.

Se o resync do catálogo inteiro morreu no meio, não recomece do zero:

bin/magento saas:resync --feed products --continue-resync

Esse retoma de onde parou, e funciona nos feeds products, productAttributes e productOverrides.

Uma última observação de contexto: Live Search exige Adobe Commerce. Se a sua loja é Open Source, esse serviço não é uma opção — a diferença entre as duas edições está no guia de Adobe Commerce e Open Source.