errors

Overview ¶

Package errors предоставляет расширенную обработку ошибок для HTTP API и микросервисов, совместимую со стандартным пакетом errors Go 1.13+.

Пакет расширяет стандартную модель ошибок Go, добавляя структурированные данные для HTTP статус-кодов, JSON-представления и системы сообщений.

Полная совместимость со стандартным пакетом errors:

• Поддержка errors.Is и errors.As для проверки и преобразования ошибок
• Поддержка errors.Unwrap для разворачивания вложенных ошибок
• Проксирование стандартных функций errors для плавной интеграции

Дополнительные возможности:

• Стандартизированные HTTP-коды состояния и связанные с ними ошибки
• Структурированные JSON-ответы для API
• Предопределенные типовые ошибки, готовые к использованию
• Вспомогательные функции для обработки HTTP-ошибок в веб-обработчиках
• Интеграция с фреймворком Fiber через middleware
• Поддержка структурированного логирования с Fiber Logger

Примеры использования:

// 1. Создание новой ошибки с HTTP-кодом
err := errors.NewError(errors.StatusBadRequest, "Неверный формат JSON", nil)

// 2. Использование предопределенной ошибки
err := errors.ErrNotFound

// 3. Кастомизация сообщения
err := errors.ErrNotFound.WithMessage("Пользователь с ID 123 не найден")

// 4. Оборачивание ошибки из другой библиотеки
dbErr := db.Query("SELECT * FROM users")
if dbErr != nil {
	return errors.Wrap(dbErr, errors.StatusInternalServerError, "Ошибка базы данных")
}

// 5. Использование стандартного errors.Is для проверки наших ошибок
if errors.Is(err, errors.ErrNotFound) {
	// Обработка ошибки "не найдено"
}

// 6. Использование стандартного errors.As для приведения типа
var myErr errors.Error
if errors.As(err, &myErr) {
	fmt.Printf("HTTP код: %d\n", myErr.Code)
}

// 7. Обработка ошибки в HTTP-хендлере
func HandleRequest(w http.ResponseWriter, r *http.Request) {
	err := processRequest(r)
	if err != nil {
		errors.HandleHTTPResponse(w, err)
		return
	}

	// Успешный ответ
	errors.WriteSuccessResponse(w, result)
}

// 8. Использование с Fiber через middleware
app := fiber.New()
app.Use(func(c *fiber.Ctx) error {
	err := c.Next()
	if err != nil {
		var customErr errors.Error
		if errors.As(err, &customErr) {
			return c.Status(customErr.Code).JSON(fiber.Map{
				"status":  customErr.Status,
				"message": customErr.Message,
			})
		}
		return c.Status(500).JSON(fiber.Map{
			"status":  "ERROR",
			"message": err.Error(),
		})
	}
	return nil
})

// 9. Интеграция с Fiber Logger для структурированного логирования
import "github.com/gofiber/fiber/v2/log"

// Логирование ошибки с использованием Fiber Logger
var customErr errors.Error
if errors.As(err, &customErr) {
	log.Errorw(customErr.Message,
		"statusCode", customErr.Code,
		"service", "UserService",
		"errorChain", formatErrorChain(customErr.Unwrap()))
}

// 10. Работа с цепочками ошибок для отладки
baseErr := stderrors.New("connection timeout")
dbErr := errors.Wrap(baseErr, errors.StatusServiceUnavailable, "Ошибка БД")
serviceErr := errors.Wrap(dbErr, errors.StatusInternalServerError, "Ошибка сервиса")

cause := serviceErr
for cause != nil {
	fmt.Printf("-> %v\n", cause)
	cause = errors.Unwrap(cause)
}