Проверка if (!body.field) не определяет обязательность: она одинаково отвергает false и 0, но иногда пропускает пробелы, null после coercion или default из framework. Сначала перечислите допустимые состояния каждого поля. Для create отсутствие обычно ошибка; для PATCH отсутствие часто означает «не менять», а явный null — отдельную операцию только если контракт её разрешает.

Валидация на HTTP-границе должна остановить заведомо неверную форму запроса до business logic. Но база и domain model всё равно обязаны защищать критичные инварианты: другой entry point, background job или старая версия сервиса не должны создать объект без владельца, валюты или ключевого статуса.

Четыре payload выглядят похоже, но значат разное

ВходСмыслОбычная политика
{}Property отсутствуетCreate: error; PATCH: оставить
{"enabled": null}Явный nullРазрешить только nullable field
{"name": ""}Пустая строкаПроверить minLength после trim policy
{"enabled": false}Валидный boolean falseНе считать отсутствием
{"count": 0}Валидный нольПроверить minimum, не truthiness

Контракт делает отсутствие проверяемым

{
  "type": "object",
  "required": ["name", "enabled", "count"],
  "properties": {
    "name": { "type": "string", "minLength": 1 },
    "enabled": { "type": "boolean" },
    "count": { "type": "integer", "minimum": 0 }
  },
  "additionalProperties": false
}

JSON Schema считает properties описанием известных свойств, но само по себе не делает их обязательными: для этого нужен массив required. Type string не запрещает пустую строку, поэтому добавлен minLength. Нужно отдельно решить, обрезает ли API пробелы: скрытая нормализация может менять подпись запроса, audit и данные клиента.

Request body и его properties имеют разные required

В OpenAPI флаг required у requestBody означает, что тело должно присутствовать. Обязательность name внутри JSON задаёт required в Schema Object. Если включить только первое, пустой объект останется допустимым; если включить только второе, поведение отсутствующего body зависит от operation и tooling. Проверяйте сгенерированную схему и реальный runtime validator вместе.

Не полагайтесь только на сгенерированный client: злоумышленник, старая версия приложения или обычный curl обходят UI и типы SDK. OWASP рекомендует валидировать как можно раньше и применять allowlist ожидаемых значений и форматов, а не пытаться вычёркивать известные плохие строки.

PATCH требует отдельной схемы намерения

  • Отсутствующее поле означает «не изменять» и не подменяется default.
  • Явный null разрешён только для операции очистки nullable значения.
  • Immutable поля либо запрещены, либо игнорирование документировано — лучше вернуть ошибку.
  • Хотя бы одно изменяемое поле должно присутствовать, если пустой PATCH не поддерживается.
  • Условные требования описываются бизнес-правилом или if/then schema, а не truthy-проверкой.
  • Версия ресурса или If-Match защищает от потери параллельного изменения.

Не переиспользуйте create DTO для PATCH, делая все поля optional и затем записывая null/default в отсутствующие колонки. Модель обновления должна хранить сам факт присутствия property. Иначе запрос, меняющий только title, может неожиданно сбросить enabled=false, owner или настройки доставки.

Ошибка указывает правило и путь без эха секретов

{
  "type": "https://api.example.test/problems/validation",
  "title": "Request validation failed",
  "status": 422,
  "errors": [
    { "pointer": "/name", "code": "required" }
  ]
}

Адрес условный. Клиенту достаточно стабильного code и JSON Pointer; не возвращайте весь payload, regex внутреннего валидатора, stack trace или значение password/token. Выберите 400 или 422 согласно существующему контракту и применяйте его последовательно — смена статуса может сломать retry и UI клиентов.

Негативные тесты важнее одного валидного примера

  1. Отправить отсутствующее поле, null, пустую строку, false и 0 отдельно.
  2. Проверить лишнее неизвестное property и неверный тип.
  3. Повторить JSON с duplicate keys через используемый parser policy.
  4. Сравнить create, full replace и PATCH semantics.
  5. Убедиться, что отказ не оставил частичную запись или side effect.
  6. Вызвать тот же domain use case из background job.
  7. Сверить runtime response с OpenAPI contract test.

Приёмка без тихих defaults

Исправление готово, когда каждый недопустимый input получает предсказуемую ошибку до записи, false и 0 сохраняются без искажения, PATCH не стирает отсутствующие поля, а database constraint ловит обход application validation. Для ревью нужны OpenAPI/JSON Schema, четыре обезличенных payload, response status/body, mapping DTO → domain и список side effects; production-токены и реальные персональные данные не нужны.

Проверенные источники