Referencia do código de erro do fluxo de nubes

Usa este artigo para solucionar os erros máis comúns nos fluxos na nube de Power Automate. Cada entrada explica que significa o erro, por que ocorre e como arranxalo.

Nota

Esta referencia aplícase a todos os niveis de licenza de fluxo en nube de Power Automate. Aprende sobre erros específicos dos fluxos do escritorio en Solucionar erros no fluxo do escritorio.

Erros en tempo de deseño

Estes erros ocorren cando gardas, validas ou publicas un fluxo.

InvalidTemplate

O que significa: A definición de fluxo contén un erro de sintaxe nunha configuración de expresión ou acción.

Causas comúns:

  • Parénteses ou comiñas non coincidentes nunha expresión
  • Referenciando unha saída de acción que non existe (erro tipográfico no nome da acción)
  • Usar unha función co número incorrecto de argumentos (por exemplo, createArray() sen argumentos)
  • Desaxuste de tipo nunha expresión constante (por exemplo, int('abc') ou div(100, 0))—o motor valida estas en tempo de aforro
  • Copiar e pegar expresións de documentación que inclúe caracteres Unicode invisibles

Como arranxalo:

  1. Abre a acción resaltada en vermello no deseñador.
  2. Comproba a expresión na barra de fórmulas. Busca unmatched () ou ' personaxes.
  3. Verificar que os nomes das accións nas expresións coincidan exactamente (distinción de maiúsculas): outputs('Get_item') non outputs('Get Item').
  4. Se a expresión parece correcta, elimínaa e escríbea manualmente para eliminar os caracteres ocultos.

Suxestión

Os nomes das accións nas expresións usan subliñados en lugar de espazos. Se a túa acción se chama "Obter obxecto", a referencia de expresión é outputs('Get_item').

Información relacionada: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

O que significa: O verificador de fluxo atopou un ou máis problemas de validación que impiden gardar.

Causas comúns:

  • Un campo obrigatorio queda baleiro nunha ou máis accións
  • Non se selecciona unha conexión para unha acción do conector
  • Unha expresión fai referencia a un valor dinámico de contido dunha rama paralela (non está garantido que exista)
  • As entradas do disparador están incompletas

Como arranxalo:

  1. Seleccione o banner de erro na parte superior do deseñador para mostrar a lista completa de problemas.
  2. Selecciona cada erro para navegar ata a acción afectada.
  3. Enche os campos obrigatorios, corrixe expresións rotas e selecciona conexións.
  4. Garda de novo. A ficha funciona automaticamente ao gardar.

Información relacionada: InválidaPlantilla, Falta unha Propiedade Requirida

DuplicateActionName

O que significa: Dúas ou máis accións no fluxo teñen o mesmo nome interno.

Causas comúns:

  • Copiar e pegar unha acción sen renomeala
  • Importación dunha definición de fluxo que foi editada manualmente con claves duplicadas
  • Renomear unha acción a un nome xa usado por outra acción no mesmo ámbito

Como arranxalo:

  1. Busca no fluxo accións con nomes idénticos (comproba tamén dentro Apply to Each e Scope contedores).
  2. Renomea un dos duplicados. Selecciona o menú ... na acción, logo selecciona Renomear.
  3. Actualizar calquera expresión que faga referencia á acción renomeada: outputs('Old_Name') a outputs('New_Name').

Información relacionada: InvalidTemplate

Propiedade requirida desaparecida

O que significa: Un campo de entrada obrigatorio nunha acción ou disparador está baleiro.

Causas comúns:

  • Engadir unha acción de conector pero non completar a configuración
  • O token de contido dinámico que se resolvía a baleiro usábase nun campo obrigatorio
  • Fluxo importado dunha solución onde as variables de ambiente non están establecidas

Como arranxalo:

  1. Abre a acción sinalada co erro.
  2. Busca campos marcados cun asterisco vermello (*) que estean en branco.
  3. Enche o valor requirido, xa sexa con texto estático ou cun token de contido dinámico.
  4. Para os fluxos de solución, comproba que todas as variables do ambiente teñan valores no entorno obxectivo.

Información relacionada: FlowCheckerError

Erros de expresión en tempo de execución

Estes erros prodúcense cando un fluxo se executa e unha expresión non pode ser avaliada.

ExpresiónAvaliaciónFallida

O que significa:

Unha expresión non se avaliou en tempo de execución porque os datos reais non coincidían co que a expresión esperaba. Este erro só ocorre cando a expresión usa valores dinámicos (variables, corpo de disparo, saídas de acción) que non se poden comprobar en tempo de gardado.

Nota

Se unha expresión usa só valores constantes (como int('abc') ou div(100, 0)), o motor de fluxo detecta o erro en tempo de gardado como InvalidTemplate en vez diso.

Causas comúns:

  • Chamar int() a unha variable que contén unha cadea non numérica en tempo de execución
  • Acceder a unha propiedade nun obxecto nulo (outputs('Get_item')?['body/title'] cando Get_item non devolveu nada)
  • Desaxuste no formato de data en formatDateTime() ou parseDateTime() cando o formato provén dunha variable
  • División por cero cando o divisor é un valor dinámico que resulta ser 0

Como arranxalo:

  1. Abre a execución fallida e selecciona a acción fallida para mostrar os valores de expresión e entrada.
  2. Envolve expresións arriscadas con comprobacións nulas: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
  3. Úsase coalesce() para proporcionar valores de respaldo: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
  4. Validar os tipos de datos antes da conversión: if(isInt(variables('input')), int(variables('input')), 0).

Suxestión

Descubre unha biblioteca de patróns de expresión listos para usar con manexo seguro contra nulos no libro de receitas de Expression para fluxos na nube.

Información relacionada: InvalidTemplate, ContentConversionFailed

Conversión de contido fallida

O que significa: O fluxo non podía converter datos dun tipo a outro entre accións.

Causas comúns:

  • Pasando unha cadea onde se espera un enteiro ou booleano
  • Enviar un array a unha acción que espera un único obxecto
  • Cadea de datas nun formato inesperado (por exemplo, DD/MM/YYYY cando MM/DD/YYYY se espera)
  • Contido binario (ficheiro) pasado a unha entrada de texto

Como arranxalo:

  1. Comproba as entradas da acción fallida no historial de execución. Compara o tipo de valor real co que espera a acción.
  2. Usa funcións de conversión explícitas: int(), float(), string(), bool(), json().
  3. Para as datas, usa parseDateTime() cunha localización explícita ou formatDateTime() para normalizar antes de pasar.
  4. Para arrays, usa first() para extraer un único elemento se a acción posterior espera un valor.

Información relacionada: ExpresiónAvaliaciónFallida

Erros de conexión e autenticación

Estes erros ocorren cando o fluxo non pode autenticarse a un servizo conectado.

InvalidConnection

O que significa: Unha referencia de conexión no fluxo apunta a unha conexión que está rota, eliminada ou expirada.

Causas comúns:

  • O usuario que creou a conexión cambiou o seu contrasinal ou tivo restablecemento por MFA
  • A conexión foi eliminada da páxina de Conexións
  • Un administrador eliminou a conexión a través do centro de administración de Power Platform
  • O fluxo foi importado a un ambiente onde a conexión non existe

Como arranxalo:

  1. Abre o fluxo en modo edición. As accións con conexións rotas mostran un icono de aviso.
  2. Selecciona a acción e selecciona Cambiar conexión ou Engadir nova conexión.
  3. Inicia sesión coas credenciais adecuadas para crear unha conexión nova.
  4. Garda e proba o fluxo.

Importante

Para fluxos de produción, considera usar conexións principais de servizo en lugar de conexións persoais de usuario. As conexións do principal servizo non caducan cando un usuario cambia o seu contrasinal ou abandona a organización.

Información relacionada: ConexiónNonConfigurada, ConexiónAutorizaciónFallida

ConnectionNotConfigured

O que significa: Unha acción require unha conexión pero non se seleccionou ningunha.

Causas comúns:

  • O fluxo importouse dunha solución e as referencias de conexión non se mapearon
  • Engadiuse unha nova acción, pero o paso de conexión foi omitido
  • A referencia de conexión apunta a unha variable de ambiente sen valor

Como arranxalo:

  1. Abre o fluxo en modo edición e atopa a acción coa advertencia de conexión.
  2. Selecciona unha conexión existente no menú despregable ou crea unha nova.
  3. Para fluxos de solución, vai a> por >
  4. Configura a conexión para cada referencia.

Información relacionada: InvalidConnection

Non autorizado (401)

O que significa: A API rexeitou a solicitude porque o token de autenticación é inválido ou caducou.

Causas comúns:

  • O token OAuth expirou e a conexión non puido actualizarse automaticamente
  • A conta do usuario foi desactivada ou cambiada a contrasinal
  • Secreto ou certificado do principal do servizo expirado
  • A política de Acceso Condicional bloqueaba o inicio de sesión (xeográfica, cumprimento do dispositivo)

Como arranxalo:

  1. Vai a Power Automate>Conexións e atopa a conexión usada pola acción fallida.
  2. Se a conexión mostra un aviso, selecciona Arranxar conexión e volve autenticar.
  3. Para conexións de principal de servizo, rota o segredo no Microsoft Entra ID e actualiza a conexión.
  4. Comproba Microsoft Entra ID rexistros de inicio de sesión para bloques de acceso condicional: Azure portal>Microsoft Entra ID>Log-in, filtra polo nome da aplicación.

Información relacionada: Prohibido (403),ConexiónAutorizaciónFallida

Prohibido (403)

O que significa: O usuario ou a aplicación autenticada non ten permiso para realizar a operación solicitada.

Causas comúns:

  • Unha política DLP (Prevención de Perda de Datos) bloquea a acción do conector ou do conector neste entorno
  • O usuario carece de permisos sobre o recurso obxectivo (por exemplo, non ter acceso de escritura a unha lista de SharePoint list)
  • Un administrador restrinxiu o conector mediante configuracións a nivel de inquilino
  • O conector require unha licenza premium e o usuario está nun plan seeded

Como arranxalo:

  1. Comproba as políticas DLP: políticas de datos do centro> de administración de Power Platform. Busca políticas que bloqueen o conector no grupo do teu entorno.
  2. Verifica que o usuario de conexión teña os permisos correctos sobre o servizo obxectivo (permisos do sitio SharePoint, roles de seguridade Dataverse e similares).
  3. Se é un problema do conector premium, verifica que o propietario do fluxo ou o chamador teña unha licenza Power Automate Premium.
  4. Contacta co teu administrador se é necesario modificar unha política DLP.

Información relacionada: Non autorizado (401), DirectApiAuthorizationRequired

ConexiónAutorizaciónFallida

O que significa: A conexión existe pero as credenciais almacenadas xa non son válidas.

Causas comúns:

  • Cambio de contrasinal do usuario ou restableceuse o método MFA
  • O token de actualización de OAuth expirou (común en conexións non usadas durante 90+ días)
  • O administrador revogou o consentimento para a aplicación no Microsoft Entra ID
  • A conexión compartida non era compartida polo propietario

Como arranxalo:

  1. Abrir Power Automate>Conexións.
  2. Atopa a conexión afectada.
  3. Selecciona a conexión e logo selecciona Arranxar conexión para volver autenticar.
  4. Se usas unha conexión compartida, pide ao propietario da conexión que a volva compartir.
  5. Para contas de servizo, establece un recordatorio no calendario para rotar as credenciais antes de que caduquen.

Suxestión

Atopa un tutorial detallado sobre problemas de conexión por conector (SharePoint, Outlook, SQL Server, Dataverse, HTTP) en Corrixir fallos de conexión en fluxos na nube.

Información relacionada: InvalidConnection, Non autorizado (401)

Erros de conector e API

Estes erros veñen do servizo río abaixo ao que chama o fluxo.

AcciónFracasada

O que significa: Unha acción devolveu un estado de fallo. Isto é un envoltorio xenérico. Os detalles reais do erro están no corpo de saída da acción.

Causas comúns:

  • A API downstream devolveu un erro 4xx ou 5xx
  • Un fluxo fillo (chamado vía "Run a Child Flow") fallou
  • Un conector personalizado devolveu un formato de resposta inesperado
  • Os axustes configure-run-after da acción fixeron que se executase tras un fallo previo

Como arranxalo:

  1. Abre a execución fallida e selecciona a acción fallida.
  2. Expande as saídas para mostrar a mensaxe de erro real e o código de estado da API.
  3. Corrixe o problema subxacente baseado no erro específico da API (revisa as entradas 400, 401, 403 e 404 nesta referencia).
  4. Se a acción debe executarse aínda que as accións anteriores fallen, comproba a configuración de Configurar execución despois .

Información relacionada: BigRequest (400),NotFound (404)

Mala Solicitude (400)

O que significa: A API do conector rexeitou a solicitude porque os datos de entrada están mal formados ou non son válidos.

Causas comúns:

  • Enviar un campo co tipo de dato incorrecto (cadea en lugar de número, ou viceversa)
  • Campos obrigatorios que faltan no corpo da solicitude
  • Caracteres inválidos en nomes de ficheiros ou títulos de ítems de lista
  • Superar un límite de lonxitude de campo (por exemplo, texto de liña única de SharePoint = 255 caracteres)

Como arranxalo:

  1. Abre a acción fallida no historial de execución e mira a sección de Entradas para mostrar exactamente o que se enviou.
  2. Compara as entradas co esquema esperado da API (consulta a documentación do conector).
  3. Sanitiza a entrada do usuario para replace() eliminar caracteres inválidos antes de pasar á acción.
  4. Usar substring() ou take() truncar valores longos ata a lonxitude máxima do campo.

Información relacionada: AcciónFallida, ConversiónContidoFallida

NotFound (404)

O que significa: O recurso ao que a acción intenta acceder non existe.

Causas comúns:

  • Unha lista, biblioteca ou sitio de SharePoint list foi renomeado ou eliminado
  • Eliminouse unha carpeta de Outlook ou un canal de Teams
  • O fluxo referencia a un ID codificado fixamente para un recurso que xa non existe
  • A táboa ou fila Dataverse foi eliminada por outro proceso

Como arranxalo:

  1. Comproba que o recurso aínda exista no servizo obxectivo.
  2. Se foi renomeado, actualiza a acción para usar o novo nome ou ID.
  3. Substitúe os IDs codificados fixamente por consultas dinámicas sempre que sexa posible (por exemplo, "Obter elementos" cun filtro en lugar de "Obter elemento" cun ID estático).
  4. Engadir xestión de erros: configurar a seguinte acción para executar despois de>fallar e manexar o 404 con elegancia.

Información relacionada: AcciónFallida

Erros de disparo

Estes erros están relacionados con que os disparadores de fluxo non se activan ou fallan.

CondiciónDesencadeanteNonCumprida

O que significa: O disparador avaliou a súa condición e determinou que o evento non debería iniciar unha execución de fluxo.

Causas comúns:

  • Unha expresión de condición de disparo sempre avalía como falsa (erro lóxico)
  • A condición de disparo refírese a un campo que non existe na carga útil de disparo
  • O evento ocorreu pero os datos non coincidían co filtro (por exemplo, "Cando se crea un elemento" cunha condición en Estado, pero Estado estaba en branco)

Como arranxalo:

  1. Vai á configuración do disparador e revisa a expresión da condición do disparador.
  2. Proba a condición fronte a unha carga útil de evento coñecido. Usa código Peek no disparador para mostrar o esquema en bruto.
  3. Elimina temporalmente a condición, activa o fluxo manualmente e inspecciona a saída do disparador para verificar os nomes e valores dos campos.
  4. Corrixe a expresión e volve activar a condición.

Información relacionada: ExpresiónAvaliaciónFallida

Erros de tempo morto e de limitación

Estes erros prodúcense cando o fluxo ou unha acción supera os límites de tempo ou taxa.

ActionTimedOut

O que significa: Unha única acción superou o seu tempo de espera configurado e foi cancelada.

Causas comúns:

  • Acción HTTP que chama a unha API externa lenta con tempo de espera predeterminado de 100 segundos
  • "Agarda unha aprobación" cunha caducidade que pasou
  • Carga ou descarga de ficheiros grandes a través dunha conexión lenta
  • Consulta Dataverse que devolve demasiadas filas sen paginación

Como arranxalo:

  1. Abre a Configuración da acción e aumenta o valor de Tempo Límite (duración ISO 8601, por exemplo, PT5M durante 5 minutos).
  2. Para as accións HTTP, comproba se a API externa ten un patrón de operación de longa duración (consulta con reintento despois).
  3. Para Dataverse, engade $filter e $top para reducir o conxunto de resultados.
  4. Para as aprobacións, establece unha expiración razoable e engade unha rama de tempo de espera para xestionar as non respostas.

Información relacionada: OperationTimedOut

OperationTimedOut

O que significa: Unha operación de longa duración (espera webhook, aprobación, sondeo HTTP) superou o tempo máximo de espera.

Causas comúns:

  • Acción HTTP webhook agardando unha chamada que nunca chegou
  • Acción de aprobación sen expiración, alcanzando o límite de fluxo de 30 días
  • Acción de "Atrasar ata" establecida ata unha data máis alá do límite de duración de 30 días
  • O servizo externo caeu e nunca enviou a resposta esperada

Como arranxalo:

  1. Establece sempre tempos explícitos para as accións de webhook e aprobación.
  2. Para as accións do webhook HTTP, implementa unha rama de tempo límite con Configurar executándose despois de>que o tempo expirase.
  3. Divide as longas esperas en segmentos máis curtos usando un bucle con comprobacións diarias.
  4. Para o límite de execución de 30 días, redeseña procesos de longa duración para usar un patrón de "relé": remata a execución actual e comeza unha nova co estado pasado a través de Dataverse ou un ficheiro.

Importante

Os fluxos de nubes teñen unha duración máxima de 30 días. Para procesos que tardan máis, divídeos en múltiples execucións de fluxo con estado compartido.

Información relacionada: ActionTimedOut

Fluxo de traballoCorrerAcciónRepeticiónCotaExcedidoExceso

O que significa: Un bucle Aplicar a Cada superou o número máximo de iteracións (por defecto: 100.000 para premium, 5.000 para perfís de rendemento).

Causas comúns:

  • Procesar unha lista grande de SharePoint list ou táboa Dataverse sen filtrar antes
  • Bucles anidados Apply to Each multiplicando as contas de iteracións (100 x 100 = 10.000)
  • Unha acción que Get items devolve todas as filas en lugar dun subconxunto filtrado

Como arranxalo:

  1. Engade filtros á acción da fonte de datos para reducir o número de elementos antes do bucle.
  2. Usa OData $filter e $top as accións Get items en lugar de filtrar dentro do bucle.
  3. Para conxuntos de datos grandes, agrupa o traballo a través de múltiples execucións de fluxo usando tokens de paginación ou rangos de datas.
  4. Considera usar Select accións de ou Filter array en lugar de Apply to Each cando só necesitas transformar ou filtrar datos.

Información relacionada: FlowRunQuotaExceeded

FluxoRunQuotaExceeded

O que significa: O fluxo ou inquilino excedeu o seu límite diario de execución de accións.

Causas comúns:

  • Licenza seeded/libre: 6.000 accións por día por usuario
  • Licenza premium: 40.000 accións por día por usuario
  • Licenza de proceso: 250.000 accións por día por fluxo
  • Un fluxo cargado de bucles que consume miles de accións por execución

Como arranxalo:

  1. Consulta o uso actual en Power Platform admin center>Analytics>Power Automate.
  2. Optimizar os fluxos para usar menos accións: substituír Aplicar a Cada por Select/Filter, operacións por lotes, reducir a frecuencia de sondeo.
  3. Actualiza o nivel da licenza se a carga de traballo realmente necesita máis capacidade.
  4. Distribuír as cargas de traballo en múltiples fluxos ou programar operacións de alto volume durante as horas fóra de punta.

Nota

Aprende máis sobre os límites diarios de acción por nivel de licenza en Power Automate límites e configuración.

Información relacionada: Fluxo de traballoExecutarAcciónRepeticiónQuotaExceeded, DirectTAPIAuthorizationRequiredRequired

Erros de licenzas

DirectApiAuthorizationRequired

O que significa: O fluxo usa un conector premium pero o chamador non ten unha licenza premium.

Causas comúns:

  • Un fluxo con conectores premium (HTTP, SQL Server, Dataverse, conectores personalizados) é executado por un usuario cunha licenza Microsoft 365 seeded
  • O propietario do fluxo ten premium pero o usuario que activa non (importa a licenza do chamador, non a do propietario).
  • O propietario dun fluxo programado perdeu a súa licenza premium
  • Un fluxo en contexto estaba disociado da súa Power App, facéndoo fóra de contexto

Como arranxalo:

  1. Identifica que conector require premium. A mensaxe de erro normalmente nomea.
  2. Asigna unha licenza Power Automate Premium ao usuario que active ou execute o fluxo.
  3. Para fluxos programados ou automatizados, asegúrate de que o propietario do fluxo teña unha licenza premium.
  4. Considera se unha licenza de proceso (por fluxo) é máis rendible para fluxos compartidos de alto volume. Tamén podes compartir unha única licenza de Proceso entre ata 25 fluxos cun grupo de fluxo.

Información relacionada: Prohibido (403),FlowRunQuotaExceeded

Táboa de referencia rápida

Erro Categoría A solución máis probable
InvalidTemplate Tempo de deseño Fixar a sintaxe da expresión
ExpresiónAvaliaciónFallida Duración Engadir comprobacións nulas, validar tipos
AcciónFracasada Duración Comproba as saídas das accións para detectar erros de API
FlowCheckerError Tempo de deseño Enche os campos requiridos, arranxa conexións
InvalidConnection Connection Volver autenticar a conexión
ConnectionNotConfigured Connection Seleccionar ou crear unha conexión
Non autorizado (401) Auth Arranxar conexión, rotar credenciais
Prohibido (403) Auth Comproba as políticas e permisos DLP
Mala Solicitude (400) API Validar o formato dos datos de entrada
NotFound (404) API Verificar que existe un recurso e actualizar referencias
CondiciónDesencadeanteNonCumprida Desencadeador Revisar a expresión da condición desencadeante
ActionTimedOut Tempo de espera Aumentar o tempo de espera nas configuracións de acción
DuplicateActionName Tempo de deseño Renomear unha das accións duplicadas
Propiedade requirida desaparecida Tempo de deseño Cubrir os campos obrigatorios
Conversión de contido fallida Duración Usa conversións explícitas de tipos
Fluxo de traballoCorrerAcciónRepeticiónCotaExcedidoExceso Limitación Filtrar os datos antes do bucle
DirectApiAuthorizationRequired Licenzas Asignar licenza premium ao chamador
FluxoRunQuotaExceeded Limitación Optimizar o número de accións, actualizar a licenza
ConexiónAutorizaciónFallida Connection Arranxar a conexión, volver autenticar
OperationTimedOut Tempo de espera Establece tempos de espera explícitos, usa patrón de relevo

Nota: O autor creou este artigo coa axuda da IA. Máis información

  • Última actualización o