Rozwiązywanie problemów
Rozwiąż typowe problemy Magento z instalacją, połączeniem, cronem i synchronizacją.
Zacznij od niedestrukcyjnych kontroli. Nie odłączaj ani nie instaluj ponownie modułu, zanim nie zapiszesz błędu i nie sprawdzisz bieżącego stanu.
Szybkie kontrole stanu
W katalogu projektu uruchom:
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusPierwsze polecenie powinno zgłosić Fullmetrix_Connector jako włączony. Drugie pokazuje wersję, rejestrację, kolejkę webhooków i liczby encji.
Ukryj kod połączenia
fullmetrix:status pokazuje bieżący kod. Usuń linię Connection code przed wklejeniem wyniku do zgłoszenia, czatu lub zrzutu.
Brak menu Fullmetrix
- Sprawdź moduł poleceniem
bin/magento module:status Fullmetrix_Connector. - Uruchom
bin/magento setup:upgrade. - W skompilowanej produkcji uruchom
bin/magento setup:di:compilestandardowym procesem. - Uruchom
bin/magento cache:flush, wyloguj się i zaloguj ponownie. - Sprawdź dostęp ACL roli administratora.
Błędy połączenia
| Błąd | Rozwiązanie |
|---|---|
invalid_code_format | Skopiuj kod ponownie. Wymagany format to FMTX-XXXX-XXXX-XXXX bez spacji. |
invalid_store | Wybierz aktywny widok. Sprawdź ID, jeśli używasz CLI. |
| Kod nie istnieje lub był użyty | Wróć do aktywnego wdrożenia właściwej organizacji i użyj bieżącego kodu. |
invalid_response | Sprawdź wychodzące HTTPS, DNS, TLS, proxy i logi Magento. Ponów po naprawie sieci. |
| Błąd HTTP lub transportu | Zezwól na HTTPS do fullmetrix.com i sprawdź zaporę, proxy, DNS oraz certyfikaty. |
Połączono, ale dane się nie aktualizują
-
Otwórz Marketing > Fullmetrix i potwierdź Connected.
-
Sprawdź
bin/magento fullmetrix:status. Rosnąca kolejka wskazuje blokadę cronu lub wysyłki. -
Potwierdź, że główny cron Magento jest zainstalowany i aktywny.
-
Uruchom raz grupę konektora w celu diagnostyki:
bin/magento cron:run --group=fullmetrix -
Sprawdź
var/log/system.log,var/log/exception.logoraz logi supervisora lub cronu systemowego w czasie błędu. -
Potwierdź dostęp Fullmetrix do publicznego URL bez konserwacji, uwierzytelniania HTTP i ochrony antybotowej.
Nie łącz ponownie jako pierwszego kroku
Odłączenie usuwa lokalne połączenie i stan synchronizacji. Zachowaj błąd, stan kolejki i czas przed zmianami.
Informacje dla wsparcia
Wyślij poniższe bez haseł, sekretów, danych klientów i kodu połączenia:
- Wersje Magento lub Adobe Commerce i PHP
- Wersja konektora Fullmetrix
- ID widoku sklepu i publiczny URL
- Dokładny błąd i przybliżony czas ze strefą
- Stan cronu i zmiany kolejki Fullmetrix
- Odpowiednie zanonimizowane linie logów Magento
- Informacje o zaporze, proxy, konserwacji lub ochronie antybotowej
Aby usunąć integrację, wykonaj Odłączenie, wyłączenie lub odinstalowanie.