Referència al codi d'error del flux de núvols

Utilitza aquest article per resoldre els errors més comuns en els fluxos al núvol de Power Automate. Cada entrada explica què significa l'error, per què passa i com arreglar-lo.

Errors en temps de disseny

Aquests errors es produeixen quan deses, valides o publiques un flux.

InvalidTemplate

Què significa: La definició de flux conté un error de sintaxi en una configuració d'expressió o acció.

Causes comunes:

• Parèntesis o cites no coincidides en una expressió
• Referenciar una sortida d'acció que no existeix (error tipogràfic al nom de l'acció)
• Utilitzar una funció amb el nombre incorrecte d'arguments (per exemple, createArray() sense arguments)
• Desajust de tipus en una expressió constant (per exemple, int('abc') o div(100, 0))—el motor valida aquests en temps d'estalvi
• Copiar i enganxar expressions de documentació que inclou caràcters Unicode invisibles

Com solucionar-ho:

1. Obre l'acció ressaltada en vermell al dissenyador.
2. Comprova l'expressió a la barra de fórmules. Busca personatges sense parella () o ' personatges.
3. Verificar que els noms d'accions a les expressions coincideixin exactament (distingeix majúscules): outputs('Get_item') no outputs('Get Item').
4. Si l'expressió sembla correcta, esborra-la i escriu-la manualment per eliminar caràcters ocults.

Informació relacionada: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

Què significa: El verificador de flux ha trobat un o més problemes de validació que impedeixen desar.

Causes comunes:

• Un camp requerit queda buit en una o més accions
• No es selecciona una connexió per a una acció de connector
• Una expressió fa referència a un valor dinàmic de contingut d'una branca paral·lela (no garantit que existeixi)
• Les entrades del disparador són incompletes

Com solucionar-ho:

1. Selecciona el bàner d'error a la part superior del dissenyador per mostrar la llista completa de problemes.
2. Selecciona cada error per navegar fins a l'acció afectada.
3. Omple els camps requerits, corregeix expressions trencades i selecciona connexions.
4. Desa de nou. La dama s'executa automàticament en la guardada.

Informació relacionada: PlantillaInvàlida, PropietatRequeridaQue Falta

DuplicateActionName

Què significa: Dues o més accions en el flux tenen el mateix nom intern.

Causes comunes:

• Copiar i enganxar una acció sense canviar-li el nom
• Importació d'una definició de flux que s'ha editat manualment amb claus duplicades
• Renombrar una acció a un nom ja utilitzat per una altra acció en el mateix àmbit

Com solucionar-ho:

1. Cerca al flux accions amb noms idèntics (comprova també dins Apply to Each i Scope contenidors).
2. Rebateja un dels duplicats. Selecciona el menú ... a l'acció, després selecciona Renomena.
3. Actualitza qualsevol expressió que faci referència a l'acció reanomenada: outputs('Old_Name') a outputs('New_Name').

Informació relacionada: InvalidTemplate

Propietat Requerida Perduda

Què significa: Un camp d'entrada requerit per a una acció o disparador està buit.

Causes comunes:

• Afegir una acció de connector però no completar la configuració
• El token de contingut dinàmic que es resolvia es va utilitzar en un camp obligatori
• Flux importat d'una solució on les variables d'entorn no estan establertes

Com solucionar-ho:

1. Obre l'acció marcada amb l'error.
2. Busca camps marcats amb un asterisc vermell (*) que estiguin en blanc.
3. Omple el valor requerit, ja sigui amb text estàtic o amb un token de contingut dinàmic.
4. Per als fluxos de solució, comprova que totes les variables de l'entorn tinguin valors en l'entorn objectiu.

Informació relacionada: FlowCheckerError

Errors d'expressió en temps d'execució

Aquests errors es produeixen quan s'executa un flux i no es pot avaluar una expressió.

ExpressióAvaluacióFallida

Què significa:

Una expressió no s'avaluava en temps d'execució perquè les dades reals no coincidien amb el que l'expressió esperava. Aquest error només es produeix quan l'expressió utilitza valors dinàmics (variables, cos de disparador, sortides d'acció) que no es poden comprovar en temps d'estalvi.

Causes comunes:

• Cridar int() una variable que conté una cadena no numèrica en temps d'execució
• Accedir a una propietat sobre un objecte nul (outputs('Get_item')?['body/title'] quan no Get_item retornat res)
• Desajust de format de data en formatDateTime() o parseDateTime() quan el format prové d'una variable
• Divisió per zero quan el divisor és un valor dinàmic que resulta ser 0

Com solucionar-ho:

1. Obre l'execució fallida i selecciona l'acció fallida per mostrar els valors d'expressió i d'entrada.
2. Embolica expressions arriscades amb comprovacions nul·les: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
3. S'utilitza coalesce() per proporcionar valors de recanvi: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
4. Validar els tipus de dades abans de la conversió: if(isInt(variables('input')), int(variables('input')), 0).

Informació relacionada: PlantillaInvàlida, ConversióDe Contingut Fallida

Conversió de contingut fallida

Què vol dir: El flux no podia convertir dades d'un tipus a un altre entre accions.

Causes comunes:

• Passar una cadena on s'espera un enter o booleà
• Enviar un array a una acció que espera un sol objecte
• Cadena de dates en un format inesperat (per exemple, DD/MM/YYYY quan MM/DD/YYYY s'espera)
• Contingut binari (fitxer) passat a una entrada de text

Com solucionar-ho:

1. Comprova les entrades de l'acció fallida a l'historial d'execució. Compara el tipus de valor real amb el que espera l'acció.
2. Utilitza funcions de conversió explícites: int(), float(), string(), bool(), json().
3. Per a les dates, utilitza parseDateTime() una localització explícita o formatDateTime() per normalitzar abans de passar.
4. Per als arrays, utilitza first() per extreure un sol element si l'acció posterior espera un valor.

Informació relacionada: ExpressionEvaluationFailed

Errors de connexió i autenticació

Aquests errors es produeixen quan el flux no pot autenticar-se a un servei connectat.

InvalidConnection

Què significa: Una referència de connexió en el flux apunta a una connexió que està trencada, eliminada o expirada.

Causes comunes:

• L'usuari que va crear la connexió va canviar la seva contrasenya o va tenir un restabliment de MFA
• La connexió va ser eliminada de la pàgina de Connexions
• Un administrador va eliminar la connexió a través del centre d'administració de Power Platform
• El flux es va importar a un entorn on la connexió no existeix

Com solucionar-ho:

1. Obre el flux en mode d'edició. Les accions amb connexions trencades mostren una icona d'avís.
2. Selecciona l'acció i selecciona Canvia connexió o Afegeix una nova connexió.
3. Inicia sessió amb les credencials adequades per crear una nova connexió.
4. Deseu i proveu el flux.

Informació relacionada: ConnectionNotConfigured, ConnectionAuthorizationFailed

ConnexióNotConfigurat

Què significa: Una acció requereix una connexió però no s'ha seleccionat cap.

Causes comunes:

• El flux es va importar d'una solució i les referències de connexió no es van mapar
• Es va afegir una nova acció, però es va saltar el pas de connexió
• La referència de connexió apunta a una variable d'entorn sense valor

Com solucionar-ho:

1. Obre el flux en mode d'edició i troba l'acció amb l'avís de connexió.
2. Selecciona una connexió existent des del menú desplegable, o crea'n una de nova.
3. Per a fluxos de solució, ves aReferències de Connexió de> per >.
4. Configura la connexió per a cada referència.

Informació relacionada: InvalidConnection

No autoritzat (401)

Què significa: L'API ha rebutjat la sol·licitud perquè el token d'autenticació és invàlid o ha caducat.

Causes comunes:

• El token OAuth va caducar i la connexió no es va poder refrescar automàticament
• El compte de l'usuari va ser desactivat o es va canviar la contrasenya
• Secret o certificat del principal de servei expirat
• La política d'Accés Condicional bloquejava l'inici de sessió (geo, compliment del dispositiu)

Com solucionar-ho:

1. Ves a Power Automate>Connections i troba la connexió utilitzada per l'acció fallida.
2. Si la connexió mostra un avís, selecciona Arreglar connexió i torna a autenticar.
3. Per a connexions de principal de servei, rota el secret a Microsoft Entra ID i actualitza la connexió.
4. Comprova els registres d'inici de sessió Microsoft Entra ID blocs d'accés condicional: Azure portal>Microsoft Entra ID>Logs d'inici de sessió, filtra pel nom de l'aplicació.

Informació relacionada: Prohibit (403),ConnexióAutorització Fallida

Prohibit (403)

Què significa: L'usuari o l'aplicació autenticat no té permís per realitzar l'operació sol·licitada.

Causes comunes:

• Una política DLP (Prevenció de Pèrdua de Dades) bloqueja el connector o l'acció del connector en aquest entorn
• L'usuari no té permisos sobre el recurs objectiu (per exemple, no tenir accés d'escriptura a una llista de SharePoint list)
• Un administrador va restringir el connector mitjançant la configuració a nivell de llogatari
• El connector requereix una llicència premium i l'usuari està en un pla seeded

Com solucionar-ho:

1. Comprova les polítiques DLP:polítiques> d'administració de Power Platform. Busca polítiques que bloquegin el connector al grup del teu entorn.
2. Verifica que l'usuari de connexió tingui els permisos correctes sobre el servei objectiu (permisos de llocs de SharePoint, rols de seguretat de Dataverse, i similars).
3. Si és un problema de connector premium, comprova que el propietari del flux o la persona que truca tingui una llicència Power Automate Premium.
4. Contacta amb el teu administrador si cal modificar una política DLP.

Informació relacionada: No autoritzat (401), DirectApiAuthorizationRequired

ConnexióAutoritzacióFallida

Què significa: La connexió existeix però les credencials emmagatzemades ja no són vàlides.

Causes comunes:

• La contrasenya de l'usuari es va canviar o es va restablir el mètode MFA
• El token de refresc OAuth ha expirat (comú amb connexions no utilitzades durant 90+ dies)
• L'administrador ha revocat el consentiment per a l'aplicació a l'Microsoft Entra ID
• La connexió compartida no era compartida pel propietari

Com solucionar-ho:

1. Obre Power Automate>Connections.
2. Troba la connexió afectada.
3. Selecciona la connexió i després selecciona Arreglar connexió per tornar a autenticar.
4. Si utilitzes una connexió compartida, demana al propietari de la connexió que la torni a compartir.
5. Per als comptes de servei, configura un recordatori al calendari per rotar les credencials abans que caduquin.

Informació relacionada: InvalidConnection, No autoritzat (401)

Errors de connectors i API

Aquests errors provenen del servei aigües avall que el flux està cridant.

AccióFallida

Què significa: Una acció retorna l'estat de fracàs. Això és un embolcall genèric. Els detalls reals de l'error es troben al cos de sortida de l'acció.

Causes comunes:

• L'API downstream va retornar un error 4xx o 5xx
• Un flux fill (anomenat via "Run a Child Flow") va fallar
• Un connector personalitzat retornava un format de resposta inesperat
• La configuració configure-run-after de l'acció feia que s'executés després d'una fallada prèvia

Com solucionar-ho:

1. Obre l'execució fallida i selecciona l'acció fallida.
2. Expandeix les sortides per mostrar el missatge d'error real i el codi d'estat de l'API.
3. Soluciona el problema subjacent basant-te en l'error específic de l'API (revisa les entrades 400, 401, 403 i 404 d'aquesta referència).
4. Si l'acció s'ha d'executar fins i tot quan les accions anteriors fallen, comprova la configuració de configurar execució després .

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

Mala Sol·licitud (400)

Què significa: L'API del connector va rebutjar la sol·licitud perquè les dades d'entrada són malformades o invàlides.

Causes comunes:

• Enviar un camp amb el tipus de dades incorrecte (cadena en lloc de nombre, o viceversa)
• Fields obligatoris que falten al cos de la sol·licitud
• Caràcters invàlids en noms d'arxius o títols d'elements de llista
• Superar un límit de longitud de camp (per exemple, text d'una sola línia de SharePoint = 255 caràcters)

Com solucionar-ho:

1. Obre l'acció fallida a l'historial d'execució i mira la secció d'Entrades per mostrar exactament què s'ha enviat.
2. Compara les entrades amb l'esquema esperat de l'API (consulta la documentació del connector).
3. Neteja l'entrada de l'usuari per replace() eliminar els caràcters invàlids abans de passar a l'acció.
4. Utilitza substring() o take() trunca valors llargs fins a la longitud màxima del camp.

Informació relacionada: AccióFallida, ConversióContingut Fallida

NoTrobat (404)

Què significa: El recurs al qual l'acció intenta accedir no existeix.

Causes comunes:

• Una llista, biblioteca o lloc de SharePoint list va ser rebatejat o eliminat
• Es va eliminar una carpeta d'Outlook o un canal de Teams
• El flux fa referència a un ID codificat fixament per a un recurs que ja no existeix
• La taula o fila Dataverse va ser eliminada per un altre procés

Com solucionar-ho:

1. Comprova que el recurs encara existeixi al servei objectiu.
2. Si s'ha canviat el nom, actualitza l'acció per utilitzar el nou nom o ID.
3. Substitueix els IDs codificats fixament per cerques dinàmiques sempre que sigui possible (per exemple, "Obtenir elements" amb un filtre en lloc de "Obtenir objecte" amb un ID estàtic).
4. Afegeix gestió d'errors: configura la següent acció per executar després>que hagi fallat i gestiona el 404 amb gràcia.

Informació relacionada: AccióFallida

Errors de desencadenant

Aquests errors estan relacionats amb el fet que els triggers de flux no s'activen o fallen.

CondicióDesencadenantNotComplert

Què significa: El desencadenant va avaluar la seva condició i va determinar que l'esdeveniment no hauria d'iniciar una execució de flux.

Causes comunes:

• Una expressió de condició de desencadenant sempre s'avalua com a falsa (error lògic)
• La condició de dispar fa referència a un camp que no existeix a la càrrega útil de disparador
• L'esdeveniment va ocórrer però les dades no coincidien amb el filtre (per exemple, "Quan es crea un element" amb una condició a Status, però Status estava en blanc)

Com solucionar-ho:

1. Ves a la configuració del trigger i revisa l'expressió de la condició del trigger.
2. Prova la condició contra una càrrega útil d'esdeveniment coneguda. Utilitza el codi Peek al trigger per mostrar l'esquema en brut.
3. Elimina temporalment la condició, activa el flux manualment i inspecciona la sortida del disparador per verificar els noms i valors dels camps.
4. Fixa l'expressió i torna a activar la condició.

Informació relacionada: ExpressionEvaluationFailed

Errors de temps mort i limitació

Aquests errors es produeixen quan el flux o una acció supera els límits de temps o de velocitat.

ActionTimedOut

Què significa: Una sola acció va superar el seu temps d'espera configurat i es va cancel·lar.

Causes comunes:

• Acció HTTP que crida una API externa lenta amb un temps d'espera per defecte de 100 segons
• "Esperar una aprovació" amb una caducitat que va passar
• Pujada o descàrrega de fitxers grans a través d'una connexió lenta
• Consulta Dataverse retornant massa files sense paginació

Com solucionar-ho:

1. Obre la configuració de l'acció i augmenta el valor de temps d'espera (durada ISO 8601, per exemple, PT5M durant 5 minuts).
2. Per a les accions HTTP, comprova si l'API externa té un patró d'operacions de llarga durada (poll amb retry-after).
3. Per a Dataverse, afegeix $filter i $top per reduir el conjunt de resultats.
4. Per a les aprovacions, fixa una expiració raonable i afegeix una branca de temps d'espera per gestionar les no respostes.

Informació relacionada: OperationTimedOut

OperationTimedOut

Què significa: Una operació de llarga durada (espera webhook, aprovació, sondeig HTTP) superava el temps màxim d'espera.

Causes comunes:

• Acció de webhook HTTP esperant una devolució de trucada que mai va arribar
• Acció d'aprovació sense caducitat, assolint el límit de flux de 30 dies
• "Retarda fins a" acció establerta a una data més enllà del límit de durada de 30 dies
• El servei extern va caure i mai va enviar la resposta esperada

Com solucionar-ho:

1. Sempre estableix temps d'espera explícits per a les accions de webhook i d'aprovació.
2. Per a les accions de webhook HTTP, implementa una branca de temps d'expiració amb Configure executant-se després>que hagi expirat.
3. Divideix les esperes llargues en segments més curts utilitzant un bucle amb comprovacions diàries.
4. Per al límit d'execució de 30 dies, redissenya processos de llarga durada per utilitzar un patró de "relé": acaba l'execució actual i inicia'n una de nova amb l'estat passat via Dataverse o un fitxer.

Informació relacionada: ActionTimedOut

Flux de treballRunActionRepeticióQuotaExceeded

Què significa: Un bucle Aplica a Cada va superar el nombre màxim d'iteracions (per defecte: 100.000 per a premium, 5.000 per perfils de rendiment).

Causes comunes:

• Processar una llista gran de SharePoint list o una taula de Dataverse sense filtrar abans
• Bucles anidats Apply to Each multiplicant el nombre d'iteracions (100 x 100 = 10.000)
• Una acció que Get items retorna totes les files en lloc d'un subconjunt filtrat

Com solucionar-ho:

1. Afegeix filtres a l'acció de la font de dades per reduir el nombre d'elements abans del bucle.
2. Utilitza OData $filter i $top a Get items accions en comptes de filtrar dins del bucle.
3. Per a conjunts de dades grans, agrupa la feina a través de múltiples execucions de flux utilitzant tokens de paginació o intervals de dates.
4. Considera utilitzar Select accions de nou Filter array en comptes de Apply to Each quan només cal transformar o filtrar dades.

Informació relacionada: FlowRunQuotaExceeded

FlowRunQuotaExceeded

Què significa: El flux o llogater ha superat el seu límit diari d'execució d'accions.

Causes comunes:

• Llicència seeded/lliure: 6.000 accions per dia per usuari
• Llicència premium: 40.000 accions per dia per usuari
• Llicència de procés: 250.000 accions per dia per flux
• Un flux carregat de bucles que consumeix milers d'accions per execució

Com solucionar-ho:

1. Comprova l'ús actual al centre d'administració Power Platform>Analytics>Power Automate.
2. Optimitzar els fluxos per utilitzar menys accions: substituir Aplicar a Cada per Select/Filter, operacions per lots, reduir la freqüència de sondeig.
3. Actualitza el nivell de la llicència si la càrrega de treball realment necessita més capacitat.
4. Distribueix les càrregues de treball entre diversos fluxos o programa sessions d'alt volum durant les hores fora de punta.

Informació relacionada: Flux de treballExecutarAccióRepeticióQuotaExcedit, DirectTAPIAutoritzacióRequerida

Errors de llicència

DirectApiAuthorizationRequired

Què significa: El flux utilitza un connector premium però qui truca no té una llicència premium.

Causes comunes:

• Un flux amb connectors premium (HTTP, SQL Server, Dataverse, connectors personalitzats) és executat per un usuari amb una llicència Microsoft 365 inicialitzada
• El propietari del flux té el premium però l'usuari que activa no (la llicència del trucador importa, no la del propietari)
• El propietari d'un flux programat ha perdut la seva llicència premium
• Un flux en context es va dissociar de la seva Power App, fent-lo fora de context

Com solucionar-ho:

1. Identifica quin connector requereix premium. El missatge d'error normalment el nomena.
2. Assigna una llicència Power Automate Premium a l'usuari que activi o executi el flux.
3. Per a fluxos programats o automatitzats, assegura't que el propietari del flux tingui una llicència premium.
4. Considereu si una llicència de procés (per flux) és més rendible per a fluxos compartits d'alt volum.

Informació relacionada: Prohibit (403),FlowRunQuotaExceeded

Taula de referència ràpida

Informació relacionada

• Llibre de receptes d'expressió per a fluxos de núvols
• Arreglar fallades de connexió en fluxos al núvol
• Resolució d'errors de flux al núvol
• Power Automate límits i configuració
• Power Automate guia de llicències

Nota: L'autor va crear aquest article amb l'ajuda de la IA. Més informació