Referência de código de erro do fluxo de nuvem

Use este artigo para solucionar os erros mais comuns em Power Automate fluxos de nuvem. Cada entrada explica o que significa o erro, por que ele acontece e como corrigi-lo.

Erros de tempo de design

Esses erros ocorrem quando você salva, valida ou publica um fluxo.

Modelo inválido

O que significa: a definição de fluxo contém um erro de sintaxe em uma configuração de expressão ou ação.

Causas comuns:

• Parênteses incompatíveis ou aspas em uma expressão
• Referenciando uma saída de ação que não existe (erro de digitação no nome da ação)
• Usando uma função com o número errado de argumentos (por exemplo, createArray() sem argumentos)
• Incompatibilidade de tipo em uma expressão constante (por exemplo, int('abc') ou div(100, 0))— o mecanismo valida-os em tempo de salvamento
• Copiar expressões de colagem da documentação que inclui caracteres Unicode invisíveis

Como corrigir:

1. Abra a ação realçada em vermelho no designer.
2. Verifique a expressão na barra de fórmulas. Procure caracteres ou ( caracteres incompatíveis.)'
3. Verifique se os nomes de ação nas expressões correspondem exatamente (diferencia maiúsculas de minúsculas): outputs('Get_item') não outputs('Get Item').
4. Se a expressão estiver correta, exclua-a e digite-a manualmente para remover caracteres ocultos.

Informações relacionadas: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

O que significa: o verificador de fluxo encontrou um ou mais problemas de validação que impedem o salvamento.

Causas comuns:

• Um campo necessário está vazio em uma ou mais ações
• Uma conexão não está selecionada para uma ação de conector
• Uma expressão faz referência a um valor de conteúdo dinâmico de um branch paralelo (não é garantido que exista)
• As entradas de gatilho estão incompletas

Como corrigir:

1. Selecione a faixa de erro na parte superior do designer para exibir a lista completa de problemas.
2. Selecione cada erro para navegar até a ação afetada.
3. Preencha os campos necessários, corrija expressões quebradas e selecione conexões.
4. Salve novamente. O verificador é executado automaticamente ao salvar.

Informações relacionadas: InvalidTemplate, MissingRequiredProperty

DuplicateActionName

O que significa: duas ou mais ações no fluxo têm o mesmo nome interno.

Causas comuns:

• Copiar uma ação sem renomeá-la
• Importando uma definição de fluxo que foi editada manualmente com chaves duplicadas
• Renomeando uma ação para um nome já usado por outra ação no mesmo escopo

Como corrigir:

1. Pesquise no fluxo ações com nomes idênticos (verifique dentro Apply to Each e Scope contêineres também).
2. Renomeie uma das duplicatas. Selecione o menu ... na ação e, em seguida, selecione Renomear.
3. Atualize as expressões que fazem referência à ação renomeada: outputs('Old_Name') para outputs('New_Name').

Informações relacionadas: InvalidTemplate

MissingRequiredProperty

O que significa: um campo de entrada necessário em uma ação ou gatilho está vazio.

Causas comuns:

• Adicionando uma ação de conector, mas não concluindo a configuração
• O token de conteúdo dinâmico que foi resolvido como vazio foi usado em um campo necessário
• Fluxo importado de uma solução em que as variáveis de ambiente não são definidas

Como corrigir:

1. Abra a ação sinalizada com o erro.
2. Procure campos marcados com um asterisco vermelho (*) que estejam em branco.
3. Preencha o valor necessário, com texto estático ou um token de conteúdo dinâmico.
4. Para fluxos de solução, verifique se todas as variáveis de ambiente têm valores no ambiente de destino.

Informações relacionadas: FlowCheckerError

Erros de expressão de runtime

Esses erros ocorrem quando um fluxo é executado e uma expressão não pode ser avaliada.

ExpressionEvaluationFailed

O que significa:

Falha na avaliação de uma expressão no runtime porque os dados reais não corresponderam ao esperado pela expressão. Esse erro só ocorre quando a expressão usa valores dinâmicos (variáveis, corpo do gatilho, saídas de ação) que não podem ser verificados no tempo de salvamento.

Causas comuns:

• Chamando int() uma variável que contém uma cadeia de caracteres não numérica no runtime
• Acessando uma propriedade em um objeto nulo (outputs('Get_item')?['body/title'] quando Get_item não retornou nada)
• Incompatibilidade de formato de data ou formatDateTime()parseDateTime() quando o formato vem de uma variável
• Divisão por zero quando o divisor é um valor dinâmico que passa a ser 0

Como corrigir:

1. Abra a execução com falha e selecione a ação com falha para exibir a expressão e os valores de entrada.
2. Encapsular expressões arriscadas com verificações nulas: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
3. Use coalesce() para fornecer valores de fallback: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
4. Validar tipos de dados antes da conversão: if(isInt(variables('input')), int(variables('input')), 0).

Informações relacionadas: InvalidTemplate, ContentConversionFailed

ContentConversionFailed

O que significa: o fluxo não pôde converter dados de um tipo para outro entre ações.

Causas comuns:

• Passando uma cadeia de caracteres em que um inteiro ou booliano é esperado
• Enviando uma matriz para uma ação que espera um único objeto
• Cadeia de caracteres de data em um formato inesperado (por exemplo, DD/MM/YYYY quando MM/DD/YYYY é esperado)
• Conteúdo binário (arquivo) passado para uma entrada de texto

Como corrigir:

1. Verifique as entradas da ação com falha no histórico de execuções. Compare o tipo de valor real com o que a ação espera.
2. Use funções de conversão explícitas: int(), , float(), string(), bool(), json().
3. Para datas, use parseDateTime() com uma localidade explícita ou formatDateTime() para normalizar antes de passar.
4. Para matrizes, use first() para extrair um único item se a ação downstream espera um valor.

Informações relacionadas: ExpressionEvaluationFailed

Erros de conexão e autenticação

Esses erros ocorrem quando o fluxo não pode se autenticar em um serviço conectado.

InvalidConnection

O que significa: uma referência de conexão no fluxo aponta para uma conexão que está interrompida, excluída ou expirada.

Causas comuns:

• O usuário que criou a conexão alterou sua senha ou teve a redefinição de MFA
• A conexão foi excluída da página Conexões
• Um administrador removeu a conexão por meio do Centro de administração do Power Platform
• O fluxo foi importado para um ambiente em que a conexão não existe

Como corrigir:

1. Abra o fluxo no modo de edição. Ações com conexões interrompidas mostram um ícone de aviso.
2. Selecione a ação e selecione Alterar conexão ou Adicionar nova conexão.
3. Entre com as credenciais apropriadas para criar uma nova conexão.
4. Salve e teste o fluxo.

Informações relacionadas: ConnectionNotConfigured, ConnectionAuthorizationFailed

ConnectionNotConfigured

O que significa: uma ação requer uma conexão, mas nenhuma foi selecionada.

Causas comuns:

• O fluxo foi importado de uma solução e as referências de conexão não foram mapeadas
• Uma nova ação foi adicionada, mas a etapa de conexão foi ignorada
• A referência de conexão aponta para uma variável de ambiente sem valor

Como corrigir:

1. Abra o fluxo no modo de edição e localize a ação com o aviso de conexão.
2. Selecione uma conexão existente na lista suspensa ou crie uma nova.
3. Para fluxos de solução, vá para referênciasde conexão de>> soluções.
4. Defina a conexão para cada referência.

Informações relacionadas: InvalidConnection

Não autorizado (401)

O que significa: a API rejeitou a solicitação porque o token de autenticação é inválido ou expirou.

Causas comuns:

• O token OAuth expirou e a conexão não pôde ser atualizada automaticamente
• A conta do usuário foi desabilitada ou a senha foi alterada
• Segredo ou certificado da entidade de serviço expirado
• A política de Acesso Condicional bloqueou a entrada (conformidade geográfica e do dispositivo)

Como corrigir:

1. Vá para Power Automate>Connections e localize a conexão usada pela ação com falha.
2. Se a conexão mostrar um aviso, selecione Corrigir conexão e autenticar novamente.
3. Para conexões de entidade de serviço, gire o segredo em Microsoft Entra ID e atualize a conexão.
4. Verifique Microsoft Entra ID logs de entrada para blocos de Acesso Condicional: Azure portal>Microsoft Entra ID>Sign-in logs, filtre pelo nome do aplicativo.

Informações relacionadas: Proibido (403), ConnectionAuthorizationFailed

Proibido (403)

O que significa: o usuário ou aplicativo autenticado não tem permissão para executar a operação solicitada.

Causas comuns:

• Uma política DLP (Prevenção contra Perda de Dados) bloqueia a ação do conector ou do conector nesse ambiente
• O usuário não tem permissões no recurso de destino (por exemplo, nenhum acesso de gravação a um SharePoint list)
• Um administrador restringiu o conector por meio de configurações de nível de locatário
• O conector requer uma licença premium e o usuário está em um plano semeado

Como corrigir:

1. Verifique as políticas de DLP:políticas de dados do > do Power Platform. Procure políticas que bloqueiem o conector no grupo do seu ambiente.
2. Verifique se o usuário de conexão tem as permissões certas no serviço de destino (permissões de site SharePoint, funções de segurança do Dataverse e similares).
3. Se for um problema de conector Premium, verifique se o proprietário do fluxo ou o chamador tem uma licença Power Automate Premium.
4. Entre em contato com o administrador se uma política DLP precisar ser modificada.

Informações relacionadas: Não autorizado (401), DirectApiAuthorizationRequired

ConnectionAuthorizationFailed

O que significa: a conexão existe, mas suas credenciais armazenadas não são mais válidas.

Causas comuns:

• A senha do usuário foi alterada ou o método MFA foi redefinido
• O token de atualização OAuth expirou (comum com conexões não usadas por mais de 90 dias)
• O administrador revogou o consentimento do aplicativo no Microsoft Entra ID
• A conexão compartilhada não foi compartilhada pelo proprietário

Como corrigir:

1. Abra Power Automate>Connections.
2. Localize a conexão afetada.
3. Selecione a conexão e selecione Corrigir conexão para autenticar novamente.
4. Se estiver usando uma conexão compartilhada, peça ao proprietário da conexão para compartilhá-la novamente.
5. Para contas de serviço, defina um lembrete de calendário para girar as credenciais antes que elas expirem.

Informações relacionadas: InvalidConnection, Unauthorized (401)

Erros de conector e API

Esses erros vêm do serviço downstream que o fluxo está chamando.

Falha na ação

O que significa: uma ação retornou um status de falha. Este é um wrapper genérico. Os detalhes reais do erro estão no corpo de saída da ação.

Causas comuns:

• A API downstream retornou um erro 4xx ou 5xxx
• Falha em um fluxo filho (chamado por meio de "Executar um Fluxo Filho")
• Um conector personalizado retornou um formato de resposta inesperado
• As configurações de configure-run-after da ação fizeram com que ela fosse executada após uma falha anterior

Como corrigir:

1. Abra a execução com falha e selecione a ação com falha.
2. Expanda saídas para exibir a mensagem de erro real e o código de status da API.
3. Corrija o problema subjacente com base no erro específico da API (examine as entradas 400, 401, 403 e 404 nesta referência).
4. Se a ação deve ser executada mesmo quando as ações anteriores falharem, verifique sua configuração executar após as configurações.

Informações relacionadas: BadRequest (400), NotFound (404)

BadRequest (400)

O que significa: a API do conector rejeitou a solicitação porque os dados de entrada são malformados ou inválidos.

Causas comuns:

• Enviar um campo com o tipo de dados incorreto (cadeia de caracteres em vez de número ou vice-versa)
• Campos necessários ausentes do corpo da solicitação
• Caracteres inválidos em nomes de arquivo ou títulos de item de lista
• Excedendo um limite de comprimento de campo (por exemplo, SharePoint texto de linha única = 255 caracteres)

Como corrigir:

1. Abra a ação com falha no histórico de execuções e examine a seção Entradas para exibir exatamente o que foi enviado.
2. Compare as entradas com o esquema esperado da API (verifique a documentação do conector).
3. Sanitize a entrada do usuário para replace() remover caracteres inválidos antes de passar para a ação.
4. Use substring() ou take() trunque valores longos para o comprimento máximo do campo.

Informações relacionadas: ActionFailed, ContentConversionFailed

NotFound (404)

O que significa: o recurso que a ação está tentando acessar não existe.

Causas comuns:

• Um SharePoint list, biblioteca ou site foi renomeado ou excluído
• Uma pasta Outlook ou canal do Teams foi removido
• O fluxo faz referência a uma ID codificada para um recurso que não existe mais
• A tabela ou linha do Dataverse foi excluída por outro processo

Como corrigir:

1. Verifique se o recurso ainda existe no serviço de destino.
2. Se ele foi renomeado, atualize a ação para usar o novo nome ou ID.
3. Substitua IDs codificadas por pesquisas dinâmicas sempre que possível (por exemplo, "Obter itens" por um filtro em vez de "Obter item" por uma ID estática).
4. Adicionar tratamento de erros: configure a próxima ação para Executar após>a falha e manipule o 404 normalmente.

Informações relacionadas: Falha na ação

Erros de gatilho

Esses erros estão relacionados a gatilhos de fluxo que não são disparados ou falham.

TriggerConditionNotMet

O que significa: o gatilho avaliou sua condição e determinou que o evento não deve iniciar uma execução de fluxo.

Causas comuns:

• Uma expressão de condição de gatilho sempre é avaliada como false (erro lógico)
• A condição de gatilho faz referência a um campo que não existe no conteúdo do gatilho
• O evento ocorreu, mas os dados não corresponderam ao filtro (por exemplo, "Quando um item é criado" com uma condição no Status, mas Status estava em branco)

Como corrigir:

1. Vá para as Configurações do gatilho e examine a expressão de condição do gatilho.
2. Teste a condição em relação a uma carga de evento conhecida. Use o código Peek no gatilho para exibir o esquema bruto.
3. Remova temporariamente a condição, dispare o fluxo manualmente e inspecione a saída do gatilho para verificar os nomes e valores dos campos.
4. Corrija a expressão e habilite novamente a condição.

Informações relacionadas: ExpressionEvaluationFailed

Erros de tempo limite e limitação

Esses erros ocorrem quando o fluxo ou uma ação excede os limites de tempo ou taxa.

ActionTimedOut

O que significa: uma única ação excedeu o tempo limite configurado e foi cancelada.

Causas comuns:

• Ação HTTP chamando uma API externa lenta com tempo limite padrão de 100 segundos
• "Aguarde uma aprovação" com uma expiração aprovada
• Carregar ou baixar arquivos grandes em uma conexão lenta
• Consulta dataverse retornando muitas linhas sem paginação

Como corrigir:

1. Abra as Configurações da ação e aumente o valor de tempo limite (duração iso 8601, por exemplo, PT5M por 5 minutos).
2. Para ações HTTP, verifique se a API externa tem um padrão de operação de execução longa (sondagem com repetição após).
3. Para o Dataverse, adicione $filter e $top reduza o conjunto de resultados.
4. Para aprovações, defina uma expiração razoável e adicione um branch de tempo limite para lidar com não respostas.

Informações relacionadas: OperationTimedOut

OperationTimedOut

O que significa: uma operação de longa execução (espera de webhook, aprovação, sondagem HTTP) excedeu o tempo máximo de espera.

Causas comuns:

• Ação de webhook HTTP à espera de um retorno de chamada que nunca veio
• Ação de aprovação sem expiração, atingindo o limite de execução de fluxo de 30 dias
• Ação "Atrasar até" definida como uma data além do limite de duração de execução de 30 dias
• O serviço externo caiu e nunca enviou a resposta esperada

Como corrigir:

1. Sempre defina tempos limite explícitos em ações de webhook e aprovação.
2. Para ações de webhook HTTP, implemente um branch de tempo limite com Configurar a execução após> otempo limite.
3. Divida longas esperas em segmentos mais curtos usando um loop com verificações diárias.
4. Para o limite de execução de 30 dias, reprojete processos de execução longa para usar um padrão de "retransmissão": encerre a execução atual e inicie um novo com o estado passado via Dataverse ou um arquivo.

Informações relacionadas: ActionTimedOut

WorkflowRunActionRepetitionQuotaExceeded

O que significa: um loop Aplicar a Cada excedeu o número máximo de iterações (padrão: 100.000 para premium, 5.000 para perfis de desempenho).

Causas comuns:

• Processando um SharePoint list grande ou uma tabela do Dataverse sem filtrar primeiro
• Loops aninhados Apply to Each multiplicando contagens de iteração (100 x 100 = 10.000)
• Uma Get items ação que retorna todas as linhas em vez de um subconjunto filtrado

Como corrigir:

1. Adicione filtros à ação da fonte de dados para reduzir o número de itens antes do loop.
2. Use o OData $filter e $top em Obter ações de itens em vez de filtrar dentro do loop.
3. Para conjuntos de dados grandes, coloque em lote o trabalho em várias execuções de fluxo usando tokens de paginação ou intervalos de datas.
4. Considere usar Select ou Filter array ações em vez de Apply to Each quando você só precisa transformar ou filtrar dados.

Informações relacionadas: FlowRunQuotaExceeded

FlowRunQuotaExceededed

O que significa: o fluxo ou locatário excedeu seu limite de execução de ação diária.

Causas comuns:

• Licença semeada/gratuita: 6.000 ações por dia por usuário
• Licença Premium: 40.000 ações por dia por usuário
• Licença de processo: 250.000 ações por dia por fluxo
• Um fluxo de loop pesado consumindo milhares de ações por execução

Como corrigir:

1. Verifique o uso atual no centro de administração Power Platform>Analytics>Power Automate.
2. Otimize os fluxos para usar menos ações: substitua Aplicar a Cada por Selecionar/Filtrar, operações em lote, reduzir a frequência de sondagem.
3. Atualize a camada de licença se a carga de trabalho precisar legitimamente de mais capacidade.
4. Espalhe cargas de trabalho em vários fluxos ou agende execuções de alto volume durante o horário de pico.

Informações relacionadas: WorkflowRunActionRepetitionQuotaExceeded, DirectApiAuthorizationRequired

Erros de licenciamento

DirectApiAuthorizationRequired

O que significa: o fluxo usa um conector Premium, mas o chamador não tem uma licença premium.

Causas comuns:

• Um fluxo com conectores premium (HTTP, SQL Server, Dataverse, conectores personalizados) é executado por um usuário em uma licença de Microsoft 365 semeada
• O proprietário do fluxo tem premium, mas o usuário disparador não (a licença do chamador importa, não a do proprietário)
• O proprietário de um fluxo agendado perdeu sua licença premium
• Um fluxo no contexto foi desassociado de seu Power App, tornando-o fora de contexto

Como corrigir:

1. Identifique qual conector requer premium. A mensagem de erro geralmente a nomeia.
2. Atribua uma licença Power Automate Premium ao usuário que dispara ou executa o fluxo.
3. Para fluxos agendados ou automatizados, verifique se o proprietário do fluxo tem uma licença premium.
4. Considere se uma licença de processo (por fluxo) é mais econômica para fluxos compartilhados de alto volume.

Informações relacionadas: Proibido (403), FlowRunQuotaExceeded

Tabela de referência rápida

Informações relacionadas

• Livro de receitas de expressão para fluxos de nuvem
• Corrigir falhas de conexão em fluxos de nuvem
• Solucionar problemas de erros de fluxo de nuvem
• Power Automate limitações e configuração
• guia de licenciamento Power Automate

Observação: o autor criou este artigo com a ajuda da IA. Saiba mais