Почему c.ShouldBindJSON в Gin отклоняет валидный JSON

Вопрос: почему c.ShouldBindJSON в Gin возвращает ошибку на валидный JSON

Линия поддержки
Линия поддержки Ответы на вопросы пользователей
17 ноября 2026

Встроенный валидатор Gin воспринимает нулевые значения Go как отсутствие поля в запросе. Рассказываем, как обойти это ограничение при использовании тега binding:"required".

Изображение записи

Комментарий пользователя

Здравствуйте! Отправляю валидный JSON-пакет в бэкенд на Go-фреймворке Gin, но метод .ShouldBindJSON(&req) стабильно возвращает ошибку. В теле запроса все поля на месте, типы данных совпадают. В чем может быть проблема?

Илья Копотев Разработчик

Ответ специалиста

Фреймворк Gin берет на себя рутину по парсингу и автоматической валидации входящих данных. Метод c.ShouldBindJSON не только анмаршаллит JSON-тело запроса в Go-структуру, но и проверяет ограничения, описанные в тегах binding.

Описанное вами поведение — далеко не редкая проблема, возникающая при работе со встроенным валидатором (go-playground/validator). Тег binding:"required" сообщает валидатору, что поле является обязательным. Однако под капотом валидатор проверяет, отличается ли значение поля от «нулевого» значения (zero value) для данного типа в языке Go. Для чисел (int, float) нулевое значение — 0, для строк (string) — пустая строка "", а для булевых флагов (bool) — false.

  • Владимир Оханцев

    Владимир Оханцев

    Бэкенд-разработчик Go

Если клиент отправляет валидный JSON с полем "is_active": false или "count": 0, валидатор Gin видит дефолтное нулевое значение Go и трактует его так, будто поле вообще не было передано в запросе, возвращая ошибку валидации.

Чтобы валидатор мог отличить реально переданное значение false (или 0) от отсутствия поля в JSON, объявляйте такие поля в структуре запроса как указатели (*bool, *int):

  1. Если поле передано как "is_active": false, в структуре оно станет указателем на булево значение false (не nil), и валидация пройдет успешно.
  2. Если поле вообще отсутствовало в JSON, указатель останется равным nil, и валидация завершится с ошибкой.

      package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

// CreateUserRequest описывает входящий JSON
type CreateUserRequest struct {
    Name     string `json:"name"      binding:"required,min=2"`
    Email    string `json:"email"     binding:"required,email"`
    // Используем указатель *bool, чтобы false не вызывал ошибку валидации
    IsActive *bool  `json:"is_active" binding:"required"`
}

func createUser(c *gin.Context) {
    var req CreateUserRequest

    // ShouldBindJSON автоматически проверяет теги binding
    if err := c.ShouldBindJSON(&req); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{
            "error": err.Error(),
        })
        return
    }

    c.JSON(http.StatusCreated, gin.H{
        "status":    "created",
        "name":      req.Name,
        "is_active": *req.IsActive,
    })
}

А больше о том, как работать с Gin, рассказали в статье.