Пошаговый разбор и решение ошибки savePhotoError в VK Market API

📌 Проблема

Владелец интернет-магазина столкнулся с критической проблемой: автоматический скрипт синхронизации товаров с VirtueMart в VK Market внезапно перестал работать. Все товары в группе ВКонтакте стали неактивными, а новые товары не создавались с ошибкой:

error_code: 8, error_msg: "Invalid request: savePhotoError"

Скрипт, который стабильно работал более года, теперь падал на первом же товаре без изображения с ошибкой базы данных:

1048 (23000): Column 'vk_market_item_id' cannot be null

🔍 Диагностика проблемы

1. Ложные пути поиска

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

• ❌ Токен не работает — на самом деле токен был рабочий, успешно проходили запросы к utils.getServerTime
• ❌ Категория 20003 не существует — категория существовала и называлась "Смартфоны и гаджеты"
• ❌ Нужны дополнительные поля для категории — ручное создание товара не требовало особых полей
• ❌ Проблема в домене API — и api.vk.ru, и api.vk.com работали одинаково

2. Реальное поведение скрипта

Анализ логов показал следующую цепочку событий:

# 1. Функция mark_all_products_unavailable() помечала ВСЕ товары как удаленные
market.edit({"owner_id": "-group_id", "item_id": item_id, "deleted": 1})

# 2. Первый товар без изображения возвращал vk_market_item_id=None
# 3. Функция update_sync_status пыталась записать NULL в колонку NOT NULL
INSERT ... VALUES (product_id, group_id, NULL, ...)  # ОШИБКА 1048!

# 4. Скрипт полностью прерывался, не дойдя до товаров с изображениями

3. Ключевое открытие

При изолированном тестировании метода market.add с параметрами из лога — всё работало! Это означало, что проблема была не в API VK, а в логике выполнения скрипта.

🎯 Корневая причина

Двойная ошибка, создавшая порочный круг:

1. Устаревшая версия API 5.131 — VK изменил требования к некоторым операциям
2. Неустойчивая архитектура обработки ошибок — падение на первом же товаре блокировало всю синхронизацию

При этом photo_id, полученный до падения скрипта, мог "портиться" в кэше VK, создавая иллюзию проблемы с savePhotoError.

💡 Решение

Исправление 1: Обновление версии API

Во ВСЕХ вызовах VK API заменить "v": "5.131" на "v": "5.199":

# Было
params = {"access_token": token, "v": "5.131"}

# Стало
params = {"access_token": token, "v": "5.199"}

Исправление 2: Устойчивая обработка ошибок в БД

Переписать функцию update_sync_status:

def update_sync_status(cursor, connection, virtuemart_product_id, vk_group_id, product_sku, 
                      status, error_message=None, vk_market_item_id=None):
    # КРИТИЧЕСКО: Не пытаемся записывать NULL при ошибках
    if vk_market_item_id is None and status == 'error':
        logger.warning(f"[ПРОПУСК] Нет vk_market_item_id при ошибке для товара {virtuemart_product_id}")
        return  # Просто выходим, не вызывая исключение
    
    if status == 'success' and vk_market_item_id is None:
        logger.error(f"Пропуск обновления статуса: vk_market_item_id не определен")
        return
    
    # ... остальной код INSERT/UPDATE

Исправление 3: Временное отключение опасной функции

Закомментировать вызов mark_all_products_unavailable() до стабилизации работы:

# В функции main():
# if not mark_all_products_unavailable(vk_token, vk_group_id):
#     logger.error("Не удалось пометить товары как недоступные")
#     return

🛠️ Пошаговый план восстановления

1. Создайте резервную копию текущего скрипта
2. Примените три исправления выше
3. Запустите скрипт в тестовом режиме (обработка 2-3 товаров)
4. Убедитесь, что товары создаются в VK Market
5. Постепенно увеличьте нагрузку, контролируя логи
6. Раскомментируйте mark_all_products_unavailable(), когда основной функционал заработает

📊 Технические детали

Почему работали тестовые запросы, но падал основной скрипт?

Как предотвратить подобные проблемы в будущем?

1. Регулярно обновляйте версию API — следите за изменениями на dev.vk.com
2. Реализуйте отказоустойчивость — ошибка одного товара не должна ломать всю синхронизацию
3. Добавьте мониторинг — отслеживайте успешность/неуспешность операций
4. Создайте механизм повтора для временных ошибок VK API
5. Ведите детальные логи с возможностью воспроизведения запросов

🎯 Итог

Проблема была вызвана комбинацией факторов, а не одной конкретной ошибкой. Ключевым оказался каскадный эффект: устаревшая версия API + неустойчивая обработка ошибок + агрессивная функция очистки товаров.

Решение: Минимальные, но точные правки в трёх местах кода восстановили работу системы, которая теперь устойчива к подобным сбоям.

Статья основана на реальном случае диагностики и восстановления работоспособности системы синхронизации товаров между VirtueMart и VK Market. Все решения проверены на практике и гарантированно работают.