ДокументацияРуководство РазработчикаЧасто Задаваемые Вопросы и Решение Проблем

Руководство по устранению неполадок (Troubleshooting)

Прямые ответы и практические решения частых вопросов, возникающих при разработке и развертывании на сервере.

1. Изменения в Strapi не отображаются на витрине

Проверьте вебхуки в Strapi и убедитесь, что заголовок x-strapi-secret совпадает со значением REVALIDATE_SECRET в вашем файле .env.

.env

env

STORE_CORS=http://localhost:8000,https://store.yourdomain.com
ADMIN_CORS=http://localhost:9000,https://api.yourdomain.com
AUTH_CORS=http://localhost:8000,http://localhost:9000,https://store.yourdomain.com

2. Ошибка соединения с Medusa или товары не отображаются

Проверка Publishable API Key

Убедитесь, что публичный ключ задан в .env и товары привязаны к соответствующему каналу продаж (Sales Channel) в Medusa Admin.

3. Проблемы с автоматическими SSL-сертификатами в Caddy

Убедитесь, что DNS-запись типа A вашего домена указывает на IP вашего VPS, а порты 80 и 443 открыты в брандмауэре.

4. Ошибка Connection Refused в PostgreSQL или Redis

Убедитесь, что все контейнеры подключены к одной сети Docker и на сервере достаточно свободного места на диске.

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

bash

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

5. Просмотр централизованных логов и диагностика

Откройте панель OpenObserve или используйте команду docker compose logs -f для диагностики ошибок в реальном времени.

Мониторинг логов в реальном времени

bash

docker compose logs -f storefront
docker compose logs -f medusa
docker compose logs -f strapi

6. Пересборка одного контейнера без остановки остальных

При обновлении кода фронтенда или бэкенда можно пересобрать только нужный сервис:

Команда пересборки одного контейнера

bash

docker compose up -d --build storefront

7. Сброс базы данных и загрузка демонстрационных данных

Для восстановления тестового каталога в среде разработки:

Команда начального заполнения демо-данными

env

docker compose exec medusa yarn seed