Обработка ошибок

Если обработчик сигнализирует об ошибке исполнения или загрузки, среда выполнения автоматически перехватывает ошибку и возвращает в ответ JSON-документ, содержащий информацию о типе ошибки. Формат этого JSON-документа описан в разделе Вызов функции.

Также информация об ошибке записывается в журнал выполнения, который можно просмотреть с помощью YC CLI или консоли управления.

Примеры обработки ошибки

Ситуация 1: пользовательский код выходит за пределы массива, что приводит к выбрасыванию ArrayIndexOutOfBoundsException. Среда выполнения перехватывает исключение и формирует из него JSON-документ, содержащий сообщение об ошибке (поле errorMessage), тип ошибки (поле errorType) и трассировку стека (поле stackTrace).

Код функции:

import java.util.function.Function;

public class Handler implements Function<byte[], Integer> {
  @Override
  public Integer apply(byte[] input) {
    final var array = new int[]{1, 2, 3, 4, 5};
    // в этом месте функция выбросит исключение ArrayIndexOutOfBoundsException
    return array[15];
  }
}

Возвращаемый JSON-документ:

{
  "errorMessage": "Index 15 out of bounds for length 5",
  "errorType": "ArrayIndexOutOfBoundsException",
  "stackTrace": [
    ...
  ]
}

Ситуация 2: пользовательский код сигнализирует об ошибке путем механизма выбрасывания ее из функции.

Код функции:

import java.util.function.Function;

public class Handler implements Function<byte[], Integer> {
  @Override
  public Integer apply(byte[] input) {
    throw new RuntimeException("Some error message");
  }
}

Возвращаемый JSON-документ:

{
  "errorMessage": "Some error message",
  "errorType": "RuntimeException",
  "stackTrace": [
    ...
  ]
}