Błąd ORA-06512 w Oracle i jak znaleźć jego prawdziwą przyczynę

Oracle
16/11/2026
Tomasz Chwasewicz
Błąd ORA-06512 w Oracle i jak znaleźć jego prawdziwą przyczynę

ORA-06512 to komunikat Oracle, który wskazuje numer linii w kodzie PL/SQL, w której wystąpił wyjątek. Nie mówi jednak, co go spowodowało. Właściwa przyczyna to zwykle błąd zgłoszony wcześniej w stosie błędów, na przykład nieobsłużony wyjątek albo niezgodność danych. Dlatego ORA-06512 często bierze się błędnie za źródło problemu.

W odróżnieniu od ORA-12154 czy ORA-00600, które zwykle oznaczają problem z połączeniem albo wewnętrzny błąd bazy, ORA-06512 to tylko odwołanie do numeru linii. Mówi, gdzie wystąpił błąd, a nie dlaczego.

Co oznacza ORA-06512?

ORA-06512 to błąd Oracle, który wskazuje numer linii w bloku PL/SQL lub procedurze składowanej, w której wystąpił wyjątek. Sam w sobie nie podaje przyczyny błędu, tylko miejsce w stosie wywołań, w którym wystąpił wyjątek. Żeby poznać prawdziwą przyczynę, trzeba spojrzeć na wcześniejsze błędy w stosie, na przykład ORA-06502 przy błędach liczbowych lub błędach wartości.

Ten błąd zwykle pojawia się w stosie błędów w dwóch postaciach:

  • at "SCHEMA.PROCEDURE_NAME", line X wskazuje dokładną linię w jednostce PL/SQL.
  • at line Y wskazuje linię w kodzie wywołującym albo w anonimowym bloku PL/SQL.

Najczęstsze przyczyny ORA-06512

ORA-06512 może wynikać z wielu problemów w środowisku PL/SQL, ale szczególnie częste są trzy rodzaje.

Nieobsłużone wyjątki

Gdy kod PL/SQL natrafi na sytuację spoza normalnego przetwarzania, na przykład dzielenie przez zero, przepełnienie liczby albo warunek zdefiniowany przez użytkownika, zgłasza wyjątek. Jeśli żaden blok EXCEPTION go nie przechwyci, Oracle rozwija stos wywołań i wyświetla ORA-06512, żeby pokazać, gdzie to się stało. Tak samo kończą się wyjątki zdefiniowane przez użytkownika (zgłaszane przez RAISE) i wyjątki systemowe, takie jak ORA-06502, jeśli nikt ich nie obsłuży.

Problemy z typami danych

Częstą przyczyną jest niezgodność typów danych, na przykład:

  • Przypisanie liczby trzycyfrowej do zmiennej zadeklarowanej jako NUMBER(2).
  • Zapisanie tekstu dłuższego niż limit kolumny VARCHAR2.

Takie problemy wywołują wyjątki w czasie wykonania, a te z kolei komunikaty ORA-06512 wskazujące linię z niezgodnym przypisaniem.

Błędy w kodzie i logice

Wyjątki mogą też wynikać z innych pomyłek w kodzie:

  • Odwołanie do zmiennej, która nie została poprawnie zainicjowana.
  • Warunki pętli, które próbują operować na nieistniejących danych.
  • Wywołanie procedury z innymi parametrami, niż oczekuje.

W każdej z tych sytuacji Oracle zgłasza wyjątek, wyświetla ORA-06512 i przerywa działanie, chyba że kod ma odpowiedni blok obsługi wyjątków.

Jak zdiagnozować ORA-06512

Żeby ustalić, skąd bierze się ORA-06512, trzeba zwykle spojrzeć dalej niż na sam numer w komunikacie.

Czytanie całego stosu błędów

ORA-06512 pokazuje tylko linię w jednostce PL/SQL, w której wystąpił wyjątek, więc właściwa przyczyna zwykle jest w błędach zgłoszonych wcześniej. Stos może wyglądać na przykład tak:

ORA-06502: PL/SQL: numeric or value error

ORA-06512: at "SCHEMA.PROCEDURE_NAME", line 5

ORA-06512: at line 1

Pierwszy błąd (ORA-06502) wskazuje błąd liczbowy lub błąd wartości, a ORA-06512 pokazuje, gdzie wystąpił. Zawsze czytaj cały stos błędów, żeby znaleźć główny problem.

Sprawdzenie powiązanego kodu i wyzwalaczy

Jeśli główny kod wygląda poprawnie, sprawdź wyzwalacze (triggery) i zagnieżdżone procedury, które mogą pośrednio wywołać wyjątek. Na przykład wyzwalacz BEFORE UPDATE na tej samej tabeli może próbować zaktualizować wiersz, który właśnie otrzymał. Prowadzi to do wywołania rekurencyjnego albo błędu niezgodności danych. Przejrzyj zależności i wyzwalacze, które obsługują te same tabele i kolumny co Twoja procedura.

Jak naprawić ORA-06512

Gdy już wiesz, co jest przyczyną, czy to niezgodność typów, błąd logiki, czy nieobsłużony wyjątek, możesz zastosować konkretne rozwiązanie.

Napraw błąd źródłowy

Pierwsze i najprostsze rozwiązanie to usunięcie przyczyny wyjątku:

  • Dopasuj typy danych. Zwiększ precyzję liczb, jeśli musisz obsłużyć większe wartości. Upewnij się, że pola VARCHAR2 pomieszczą najdłuższe dane, jakie chcesz w nich zapisać.
  • Popraw błędy logiki. Sprawdź przebieg kodu pod kątem niedozwolonych operacji. Jeśli procedura oczekuje parametru określonego typu lub z określonego zakresu, upewnij się, że przekazujesz poprawne argumenty.
  • Popraw polecenia SQL. Sprawdź, czy definicje tabel zgadzają się z poleceniami INSERT i UPDATE. Jeśli kolumna ma typ NUMBER(10,0), nie przekazuj do niej dłuższych ani niezgodnych wartości.

Używaj bloków obsługi wyjątków

Jeśli samo usunięcie przyczyny nie wystarcza albo potrzebujesz większej kontroli, dodaj bloki EXCEPTION, które obsłużą błędy w przewidywalny sposób. Blok EXCEPTION pozwala przechwycić konkretne błędy (np. NO_DATA_FOUND lub TOO_MANY_ROWS) albo użyć klauzuli WHEN OTHERS THEN dla nieprzewidzianych sytuacji. Obsługa wyjątków w kodzie PL/SQL pozwala posprzątać po błędzie, zapisać jego szczegóły w logu albo przypisać wartości zastępcze, zamiast pozwolić Oracle przerwać proces i wyświetlić ORA-06512.

Prosty przykład:

BEGIN

   -- Operacja, która może się nie udać

   SELECT total INTO v_total FROM sales WHERE ...

EXCEPTION

   WHEN NO_DATA_FOUND THEN

      -- Obsługa sytuacji, gdy zapytanie nie zwraca wierszy

      v_total := 0;

   WHEN OTHERS THEN

      -- Przechwycenie pozostałych wyjątków

      RAISE_APPLICATION_ERROR(-20001, 'Wystąpił nieoczekiwany błąd');

END;

W tym przykładzie nieprzechwycone wyjątki nie przechodzą wyżej i nie kończą się ogólnym komunikatem ORA-06512. To Ty decydujesz, jak proces reaguje na błąd i jaki komunikat lub zachowanie zastępcze widzi użytkownik.

Zgłaszaj własne błędy z jasnym opisem

Własne komunikaty błędów ułatwiają znalezienie przyczyny każdemu, kto analizuje problem w aplikacji. Zamiast polegać na domyślnych komunikatach Oracle, możesz wywołać RAISE_APPLICATION_ERROR z własnym kodem i opisem:

DECLARE

   v_number NUMBER(2);

BEGIN

   v_number := 100; -- Wartość za duża dla NUMBER(2)

EXCEPTION

   WHEN VALUE_ERROR THEN

      RAISE_APPLICATION_ERROR(

         -20002,

         'Próba zapisania liczby trzycyfrowej w polu dwucyfrowym.'

      );

END;

Dzięki temu od razu widać, co poszło nie tak i dlaczego, zamiast stosu błędów, który pokazuje tylko ORA-06512 i ogólny błąd liczbowy.

Powiązane artykuły