Resolução de problemas de erros de fluxo na nuvem

Algo correu mal com o teu fluxo. Comece aqui para encontrar a solução rapidamente.

Comece por aqui: O que aconteceu?

Sintoma Ir para
O meu fluxo não salva Erros de gravação
O meu fluxo foi guardado mas não é executado Problemas de disparo
O meu flow corre, mas uma ação falha Erros de ação
O meu fluxo corre mas produz resultados errados Questões lógicas
Não percebo a mensagem de erro Mensagens de erro comuns

Erros de gravação

O teu fluxo não se guarda no designer.

Causa mais comum: Uma expressão tem um erro de sintaxe, ou um campo obrigatório está vazio.

Verificação rápida: Procure contornos vermelhos nas ações no designer. Expanda qualquer ação com um ícone de aviso e leia a mensagem de validação.

Como resolver:

  1. Verifique cada ação quanto aos campos realçados a vermelho. Preencha os campos obrigatórios que estejam em branco.
  2. Se editou recentemente uma expressão, abra-a e procure parênteses incompatíveis, aspas em falta ou nomes de funções incorretos.
  3. Se o botão de guardar mostrar Gravar... indefinidamente, atualiza a página e tenta novamente. As tuas alterações não guardadas podem estar perdidas. Use Ctrl + s frequentemente.

Tip

Copie texto de expressão complexa para um ficheiro de texto separado antes de guardar. Se o save falhar, podes colá-lo de volta em vez de reescrever da memória.

Ainda preso? Copie o texto exato do erro de validação e pesquise-o no Power Automate Fóruns da Comunidade ou cole num assistente de IA para interpretação.

Problemas de ativação

O teu fluxo foi guardado com sucesso, mas não aparecem corridas no histórico de corridas.

Causa mais comum: O evento de gatilho não ocorreu, ou o disparador tem uma condição de filtro que exclui os seus eventos de teste.

Verificação rápida: abra o histórico de execuções. Se estiver vazio (sem corridas nenhumas), o gatilho nunca disparou.

Como resolver:

  1. Gatilhos agendados: Verifique se a data de início está no passado, a recorrência está correta e o fuso horário corresponde à sua expectativa. Um fluxo definido para "A cada 1 dia" a partir de "amanhã" só é executado amanhã.
  2. Disparadores baseados em eventos (quando um item é criado, quando um ficheiro é modificado, e semelhantes): Crie um novo item ou ficheiro de teste. Espera 5-10 minutos. Os gatilhos não são instantâneos. Há um intervalo de votação.
  3. Condições de gatilho: Se o seu gatilho tiver uma expressão condicional, remova-a temporariamente e teste. Se o fluxo correr sem a condição, a condição está a filtrar os seus eventos.
  4. O fluxo está desligado ou suspenso: Verifique o estado do fluxo na página de detalhes. Os fluxos suspensos deixam de disparar até corrigires o problema subjacente e os voltares a ligar.

Observação

Os gatilhos baseados em eventos no Power Automate usam intervalos de sondagem, não notificações push em tempo real. O intervalo padrão de sondagem varia consoante o conector (tipicamente 1-5 minutos). Podes configurar o intervalo nas definições do trigger.

Ainda preso? Participe num tutorial detalhado em Corrigir falhas de conexão em fluxos na cloud.

Erros de ação

O seu fluxo é executado, mas uma ou mais ações falham (em vermelho no histórico de execução).

Causa mais comum: Uma ligação expirou, ou o recurso alvo foi alterado (renomeado, apagado ou permissões removidas).

Verificação rápida: Abrir a execução falhada. Encontra a ação vermelha. Expande-o e lê o código de estado e a mensagem de erro.

Corrigir por código de erro

Código Significado O que fazer
401 Falha na autenticação Re-autentica a ligação. Vai a Ligações no navegador esquerdo, encontra a que está avariada, seleciona Corrigir ligação.
403 Permissão negada Perdeu o acesso ao recurso, ou uma política DLP está a bloquear o conector. Verifique as suas permissões primeiro; depois confirma com o teu administrador sobre o DLP.
404 Recurso não encontrado A lista, ficheiro, caixa de correio ou endpoint do SharePoint foi renomeado, movido ou eliminado. Atualiza a ação para apontar para o recurso correto.
429 Taxa limitada Adicione uma ação de atraso antes deste passo, ou ative a tentativa novamente com recuo nas definições da ação.
500 Erro do servidor O serviço alvo está a ter problemas. Espera e tenta novamente. Consulte a página de saúde do serviço.

Correção para erros de expressão

Se o erro disser "Template inválido" ou "Impossível processar expressões da linguagem template", abra a ação e verifique cada expressão. Os erros mais comuns são:

  • Referenciar conteúdo dinâmico de um passo que não foi executado (dentro de um ramo de condição que não foi tomado).
  • Usar o tipo de dado errado (passar uma cadeia onde se espera um número).
  • Valores nulos. Adicione um coalesce() ou if(empty(...)) verificação.

Tip

Aprenda sobre os padrões de expressão prontos a usar com avisos de erros comuns no Livro de Receitas de Expressões para Fluxos de Nuvem.

Ainda preso? Siga um tutorial detalhado por conector em Corrigir falhas de ligação em fluxos na nuvem, ou obtenha uma explicação detalhada de cada código de erro na referência de códigos de erro de fluxo na nuvem.

Questões lógicas

O teu fluxo corre com sucesso (todos os marcadores de verificação estão verdes), mas a saída está errada.

Causa mais comum: uma condição avalia de forma diferente do esperado, ou conteúdo dinâmico faz referência ao campo errado.

Verificação rápida: Abra uma execução concluída e passe por cada ação. Expande cada um e compara as entradas e saídas com o que esperas.

Como resolver:

  1. Resultado incorreto da condição: Expanda a ação da condição no histórico de execução. Verifique os valores reais que foram comparados. Problemas comuns: espaços finais em strings, sensibilidade à caixa ("Approved" vs "approved"), comparando um número com a sua representação em string (1 vs "1").
  2. Dados errados nas ações: Selecione a ação e verifique as suas entradas. Se um campo mostrar um valor inesperado, selecione a expressão ou token de conteúdo dinâmico para saber de onde vem. Podes estar a referir-te a um campo do passo errado ou ao item errado num ciclo.
  3. Aplicar a Cada para processar itens incorretos: Verifique a Select an output from previous steps entrada. Se o array contiver mais ou menos itens do que o esperado, a ação Get Items ou List Rows anterior pode necessitar de um filtro.
  4. Problemas de temporização: Se o teu fluxo atualiza um registo e depois o lê imediatamente, a leitura pode devolver dados obsoletos. Adicione uma curta ação de atraso (5-30 segundos) entre a escrita e a leitura.

Tip

Adicione ações Compose em pontos-chave no seu fluxo para inspecionar valores intermédios. Define a entrada do Compose para o conteúdo dinâmico que queres verificar. Executa o fluxo e depois verifica cada saída do Compose no histórico de execuções para rastrear onde o valor falha.

Mensagens de erro comuns

A tabela seguinte contém referências rápidas para mensagens de erro que possa encontrar.

Mensagem de erro Tradução Correção
"A operação solicitada é proibida porque ultrapassa o limiar de visualização de lista." O SharePoint Get Items está a devolver mais de 5.000 itens. Adicione um filtro OData ou use $top=5000 com paginação. Filtre numa coluna indexada.
"Tipo inválido. Esperava String mas consegui Null." Um campo que estás a referenciar está vazio (nulo) e a ação espera texto. Envolva a referência em coalesce(field, '') ou adicione primeiro uma condição para verificar a nulidade.
Ação Falhada. Uma ação falhou. Nenhuma ação dependente teve sucesso." Um bloco Scope falhou, o que cancelou todas as ações subsequentes dentro dele. Encontre a ação específica dentro do Scope que falhou primeiro. Corrige essa ação.
"Corrida de fluxo com tempo esgotado." O caudal ultrapassou a duração máxima de 30 dias. Fluxos de longa duração precisam de ser redesenhados. Utilize um subfluxo para a parte de longa duração, ou divida em múltiplos fluxos com um sinalizador de estado.
AvaliaçãoDeExpressãoFalhou. Uma expressão tem um erro de sintaxe ou faz referência a um valor que não existe em tempo de execução. Abre a ação, verifica cada expressão. Procure nomes de funções com erros ortográficos, contagens de parâmetros erradas ou referências a passos que possam não ter sido executados.
"A ligação não é válida." A ligação foi apagada ou as credenciais expiraram. Selecione Ligações, encontre a ligação e volte a autenticar ou criar uma nova.
Fluxos aninhados não são suportados neste contexto. Estás a chamar um sub-fluxo de dentro de um Apply to Each ou de um contexto que não o suporta. Mova a chamada do fluxo filho para fora do loop, ou reestruture para passar o array completo para o fluxo filho e faça o loop dentro dele.

Important

Quando encontrar um erro não listado aqui, copie exatamente o texto da mensagem de erro. Procurar pela mensagem exata nos Fóruns da Comunidade Power Automate ou na referência de código de erro do Cloud flow é a forma mais rápida de encontrar uma solução.

Nota: O autor criou este artigo com a ajuda da IA. Mais informações