Успешный PutObject не доказывает, что S3-совместимый сервис реализует все операции Amazon S3 и все их параметры. Сопоставьте точный запрос с документацией вашего поставщика: метод, заголовки, параметры и ожидаемый результат. Начинайте с минимального воспроизводимого запроса в тестовом бакете, а не с отключения подписей или проверки сертификата.

Например, Cloudflare R2 публикует отдельную матрицу S3 API с поддерживаемыми и неподдерживаемыми возможностями. Проверено 21 октября 2026 года. Статус операции и статус отдельных параметров различаются. Ниже приведена методика проверки адаптера, а не обещание одинакового поведения R2, Amazon S3 и других поставщиков.

Сохраните запрос, который действительно отправляет SDK

Условный диагностический паспорт:
поставщик и тип бакета
версия SDK и настройки endpoint
операция + имена параметров и заголовков
HTTP status + код ошибки + request ID
минимальный запрос -> результат
тот же запрос с одной дополнительной возможностью -> результат
секреты, подписи и содержимое объектов исключены

Обновление SDK может изменить состав запроса даже при прежнем прикладном коде. Поэтому сравнивайте реальные имена заголовков и настройки сериализации до и после обновления. Диагностический вывод обязан скрывать авторизацию и временные токены. Если инструмент не умеет маскирование, не отправляйте его сырой вывод в общий журнал.

Возможности делят на обязательные и заменяемые

Возможность приложенияРешение при отсутствии
Простая запись и чтениеПоставщик не подходит основному сценарию
Дополнительный параметр операцииПроверить документированный вариант запроса
Нужная защита от конкурентной записиНе убирать без эквивалентного протокола
Версионированное восстановлениеНе обещать функцию поверх несовместимого контракта
Необязательная оптимизацияОтключать только явно и с тестом результата

Ошибка 403 может означать отсутствие права, а ошибка поддержки — другую проблему; ориентируйтесь на документированный код и минимальный тест. Не выдавайте широкие права, чтобы «проверить совместимость» несуществующей операции. И наоборот, отсутствие записи в документации не доказывается одним сетевым таймаутом: сначала подтвердите достижимость endpoint и корректный тип запроса.

Для R2 матрица указывает регион auto и описывает допустимые совместимые значения для инструментов. Это настройка конкретного продукта, не универсальный регион для любого S3 endpoint. В адаптере храните конфигурацию поставщика отдельно от бизнес-логики. Случайная подстановка настройки AWS в другой сервис затрудняет диагностику подписи и адресации.

Тестируйте поведение, а не только HTTP 200

  1. Записать синтетический объект и сверить скачанные байты.
  2. Проверить требуемые метаданные и условные операции, если они нужны приложению.
  3. Проверить список с несколькими страницами и собственный контракт обхода.
  4. Повторить запрос после временного сбоя и сверить отсутствие лишнего эффекта.
  5. Прогнать набор при обновлении SDK и перед сменой поставщика.

Каждый тест должен проверять только заявленную вашим адаптером возможность. Нельзя считать необязательный параметр безопасным для удаления, если он обеспечивал целостность, шифрование или контроль версии. При отсутствии эквивалентной гарантии адаптер возвращает явный отказ, а продукт ограничивает сценарий вместо тихого ухудшения защиты.

Возврат предыдущей версии SDK имеет смысл лишь пока она поддерживается и не несёт известных неприемлемых рисков. Сохраните конфигурацию и тестовый набор, затем меняйте один слой: библиотеку, параметр или реализацию адаптера. Для совместного разбора подготовьте паспорт запроса и строки матрицы поставщика. Это помогает исправить конкретный контракт, не превращая слово «совместимый» в неподтверждённое обещание всей функциональности S3.

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