Комментарий пользователя
Здравствуйте! Отправляю валидный 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.
Если клиент отправляет валидный JSON с полем "is_active": false или "count": 0, валидатор Gin видит дефолтное нулевое значение Go и трактует его так, будто поле вообще не было передано в запросе, возвращая ошибку валидации.
Чтобы валидатор мог отличить реально переданное значение false (или 0) от отсутствия поля в JSON, объявляйте такие поля в структуре запроса как указатели (*bool, *int):
- Если поле передано как
"is_active": false, в структуре оно станет указателем на булево значениеfalse(неnil), и валидация пройдет успешно. - Если поле вообще отсутствовало в 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, рассказали в статье.