Todos os produtos
Search
Central de documentação

Function Compute:Tratamento de erros

Última atualização: Jun 29, 2026

Se ocorrer um erro durante a execução de uma função PHP, o Function Compute captura esse erro e retorna uma resposta estruturada. Use o corpo da resposta e o cabeçalho HTTP juntos para identificar a causa da falha e definir os próximos passos.

Como funciona

O exemplo a seguir lança uma exceção padrão do PHP:

<?php
function handler($event, $context) {
  throw new Exception("oops");
}

Ao invocar essa função, o Function Compute retorna uma resposta JSON semelhante a:

{
    "errorMessage": "oops",
    "errorType": "Exception",
    "stackTrace": {
        "file": "/code/index.php",
        "line": 3,
        "traceString": ""
    }
}

Os campos da resposta são:

Campo

Descrição

errorMessage

Mensagem da exceção passada ao construtor

errorType

Nome da classe da exceção PHP

stackTrace.file

Caminho do arquivo onde a exceção foi lançada

stackTrace.line

Número da linha onde a exceção foi lançada

stackTrace.traceString

Representação em string do stack trace

Além do corpo da resposta, a resposta HTTP inclui o cabeçalho X-Fc-Error-Type: UnhandledInvocationError, que indica falha na invocação devido a uma exceção não tratada no código da função.

O que fazer quando ocorre um erro

Ao receber X-Fc-Error-Type: UnhandledInvocationError:

  1. Verifique os campos errorMessage e errorType no corpo da resposta para identificar a exceção.

  2. Analise os logs da função para obter o stack trace completo e o contexto de tempo de execução.

Próximos passos

  • Para ver a lista completa de tipos de erro retornados pelo Function Compute, consulte a seção Tratamento de erros no tópico Conceitos básicos.