Do zgłoszenia najlepiej wkleić pełny komunikat o błędzie, bez skracania i bez zmiany treści. Jeśli komunikat zawiera dane wrażliwe, ukryj je przed wysłaniem, a do zgłoszenia dodaj zrzut ekranu oraz krótki opis czynności potrzebny do analizy.
Ten artykuł wyjaśnia, jak poprawnie skopiować komunikat o błędzie do zgłoszenia lub własnej analizy. Dotyczy sytuacji takich jak błąd strony, błąd skryptu PHP, problem z wysyłką poczty, komunikat SMTP albo błąd widoczny w panelu, aplikacji lub przeglądarce.
Spis treści
Co powinien zawierać pełny komunikat o błędzie
Pełny komunikat o błędzie to nie tylko jedno zdanie widoczne na ekranie. W wielu przypadkach ważne są także kod błędu, nazwa usługi, ścieżka do pliku, adres URL, data, godzina oraz dodatkowe linie techniczne.
Jeśli komunikat ma kilka linii, skopiuj wszystkie linie w tej samej kolejności. Nie usuwaj fragmentów tylko dlatego, że wyglądają technicznie. Właśnie te fragmenty często wskazują, czy problem dotyczy konfiguracji, wersji PHP, modułu, skryptu, poczty lub domeny.
W zgłoszeniu warto dołączyć:
- pełną treść komunikatu, dokładnie tak jak jest widoczna,
- kod błędu, jeśli występuje, na przykład kod SMTP,
- adres strony lub nazwę usługi, której dotyczy problem,
- czynność wykonaną przed pojawieniem się błędu,
- przybliżoną datę i godzinę wystąpienia błędu,
- informację, czy błąd pojawia się zawsze, czy tylko czasami.
Jak skopiować komunikat bez utraty ważnych informacji
- Zaznacz cały komunikat od pierwszej do ostatniej linii.
- Skopiuj tekst bez zmieniania kolejności linii.
- Wklej komunikat do zgłoszenia jako zwykły tekst.
- Jeśli komunikat pochodzi z wiadomości e-mail, skopiuj także temat wiadomości zwrotnej oraz fragment z kodem błędu.
- Jeśli komunikat jest widoczny w przeglądarce, dołącz adres URL strony, na której się pojawia.
- Jeśli komunikat dotyczy skryptu, podaj nazwę pliku lub ścieżkę, jeśli jest widoczna w treści błędu.
Nie przepisuj komunikatu ręcznie, jeśli możesz go skopiować. Ręczne przepisywanie łatwo prowadzi do pomyłek w kodach, ścieżkach lub nazwach plików.
Jak zabezpieczyć dane wrażliwe przed wysłaniem
Komunikat o błędzie może zawierać dane, których nie należy udostępniać wprost. Przed wysłaniem sprawdź, czy w treści nie ma haseł, tokenów, kluczy API, kodów autoryzacyjnych albo prywatnych danych użytkowników.
Jeśli musisz ukryć taki fragment, zastąp go czytelnym oznaczeniem, na przykład:
- [hasło ukryte],
- [token ukryty],
- [adres e-mail ukryty].
Nie usuwaj jednak całych sekcji komunikatu, jeśli nie jest to konieczne. Lepiej zamaskować tylko wrażliwy fragment i zostawić resztę struktury błędu bez zmian.
Kiedy dodać zrzut ekranu
Zrzut ekranu jest pomocny, gdy komunikatu nie da się skopiować jako tekstu albo gdy ważny jest układ ekranu. Może to dotyczyć błędów widocznych w oknie aplikacji, formularzu, panelu lub przeglądarce.
Jeśli dodajesz zrzut ekranu, nadal wklej treść błędu jako tekst, jeśli jest to możliwe. Tekst można łatwiej wyszukać, porównać i przeanalizować niż obraz.
Jak opisać czynność, po której pojawił się błąd
Sam komunikat nie zawsze wystarcza do odtworzenia sytuacji. Krótki opis wykonanej czynności pomaga ustalić kontekst błędu.
Opis może mieć prostą formę:
- „Błąd pojawia się po wysłaniu formularza kontaktowego”.
- „Komunikat zwrotny przychodzi po próbie wysłania wiadomości e-mail”.
- „Błąd pojawia się po wejściu na adres konkretnej podstrony”.
- „Komunikat występuje po zmianie wersji PHP dla domeny”.
Nie trzeba opisywać całej historii problemu, jeśli nie jest związana z komunikatem. Najważniejsze są czynność, miejsce wystąpienia i pełna treść błędu.
Przykłady błędów, w których pełna treść ma znaczenie
Przy problemach z pocztą serwer może zwrócić kod SMTP. Kod SMTP składa się z trzech cyfr i wskazuje, jak serwer odpowiedział na próbę wykonania polecenia. Więcej informacji o takich kodach znajdziesz w artykule Kody błędów SMTP oraz lista kodów z wyjaśnieniem.
Przy błędzie 550 SPF ważna jest pełna treść odpowiedzi, ponieważ taki komunikat może oznaczać brak poprawnej konfiguracji SPF dla domeny albo niepoprawny wpis SPF. Szczegóły opisuje artykuł Błąd 550 SPF otrzymywany przy próbie wysłania wiadomości.
Przy błędach skryptów PHP istotne mogą być informacje o wersji PHP, aktywnych modułach lub samej konstrukcji skryptu. Jeśli komunikaty PHP nie są widoczne, pomocny może być artykuł Jak wyświetlić komunikaty błędów skryptu PHP.
Co jest normalne po przekazaniu komunikatu
Po przekazaniu pełnego komunikatu osoba analizująca zgłoszenie może odnieść się do konkretnego kodu, usługi lub miejsca wystąpienia błędu. Czasem potrzebne będą dodatkowe dane, na przykład dokładna godzina zdarzenia albo potwierdzenie, czy problem nadal występuje.
To jest spodziewane zachowanie procesu diagnostycznego. Nie każdy komunikat wskazuje od razu jedną przyczynę, ale pełna i niezmieniona treść błędu wyraźnie zawęża zakres sprawdzenia.