Na czym polega problem
Kod 1603 (ERROR_INSTALL_FAILURE, szesnastkowo 0x643) to najogólniejszy błąd Instalatora Windows. Dokumentacja Microsoftu opisuje go jednym zdaniem: podczas instalacji wystąpił błąd krytyczny. Nie mówi, który plik, usługa albo uprawnienie zawiodły, więc samo „1603” nie wystarcza do naprawy.
Kod widać w oknie programu instalacyjnego, jako wynik msiexec, jako kod wyjścia w narzędziach wdrożeniowych oraz w dzienniku zdarzeń. Mechanizm jest wspólny dla Windows 11 i Windows Server, więc diagnostyka wygląda tak samo. Poniżej pokazujemy, jak z dziennika wyciągnąć prawdziwy powód.
Objawy
- Instalator kończy pracę komunikatem o błędzie krytycznym i wycofuje zmiany, a program nie pojawia się w systemie.
- msiexec albo narzędzie wdrożeniowe zwraca kod wyjścia 1603.
- W pełnym dzienniku instalacji widnieją wiersze „Return value 3” i „MainEngineThread is returning 1603”.
- W dzienniku Application, w źródle MsiInstaller, jest zdarzenie 11708 lub 1033 ze statusem niepowodzenia.
Najczęstsze przyczyny
- Zawiodła akcja niestandardowa pakietu. W dzienniku kończy się wierszem „Return value 3”, a tuż nad nim stoi jej własny komunikat. Przykład z dokumentacji Microsoft Entra Connect: konto usługi wpisane jako UPN zamiast Domena\NazwaSAM.
- Brak uprawnień albo blokada przez oprogramowanie zabezpieczające. Microsoft w poradniku do instalatora Visual C++ wiąże takie awarie z niewystarczającymi uprawnieniami i z antywirusem.
- Niedziałająca usługa lub zablokowany folder, od którego zależy pakiet. W przykładzie Office akcja rejestrująca manifest zdarzeń zwróciła 1603, bo usługa Dziennik zdarzeń systemu Windows nie działała albo folder winevt\Logs miał złe uprawnienia.
- Tryb zgodności programów. Dla instalatora .NET Framework 4.5 Microsoft opisuje błąd 1603 wywołany uruchomieniem Setup w trybie zgodności.
Rozwiązanie krok po kroku
Zbierz pełny dziennik instalacji
Uruchom pakiet z logowaniem szczegółowym. Folder na dziennik musi już istnieć, bo instalator sam go nie utworzy. Gdy program ma własny setup.exe, który wewnątrz wywołuje MSI, poszukaj w dokumentacji producenta opcji logowania albo włącz logowanie przez zasady (opisujemy to w artykule o msiexec /l*v).
msiexec /i "C:\Instalatory\program.msi" /l*v "C:\Logi\program-instalacja.log"Znajdź pierwszy wiersz „Return value 3”
Według dokumentacji w dzienniku wartość 1 oznacza sukces akcji, 2 anulowanie, a 3 błąd krytyczny, czyli właśnie 1603. W dobrej instalacji takich wierszy nie ma. Interesuje Cię pierwsze wystąpienie; kolejne to zwykle skutek wycofywania zmian.
Select-String -Path "C:\Logi\program-instalacja.log" -Pattern "Return value 3" -Context 12,2Czytaj dziennik w górę od tego miejsca
Szukaj nazwy akcji, wierszy z „Error”, „CustomAction … returned actual error code” oraz linii „Note: 1: NNNN”, gdzie NNNN to numer komunikatu z tabeli błędów Instalatora (np. 1708 oznacza niepowodzenie instalacji). Zapisz nazwę akcji i ewentualny kod systemowy.
Dopasuj wskazówkę z dokumentacji
Jeżeli przed błędem widać odwołanie do konta usługi, sprawdź format konta (Domena\Użytkownik). Jeżeli widać wevtutil albo rejestrację zdarzeń, uruchom usługę Dziennik zdarzeń systemu Windows i sprawdź uprawnienia folderu C:\Windows\System32\winevt\Logs. Jeżeli to .NET Framework, usuń wpisy trybu zgodności z kluczy AppCompatFlags (wpisy opisane w dokumentacji .NET).
Wykluczaj czynniki zewnętrzne po kolei
Uruchom instalację z konta administratora. Na krótko wyłącz ochronę w czasie rzeczywistym lub dodaj wyjątek, a po teście włącz ją z powrotem. Zrestartuj komputer, bo nierozwiązany wcześniejszy restart też blokuje instalacje. Gdy nic się nie zmienia, wykonaj czysty rozruch i sprawdź system według artykułów w sekcji „Powiązane”.
Zgłoś producentowi dziennik, a nie sam kod
Prośba z samym „błąd 1603” nie daje dostawcy nic do analizy. Dołącz plik .log, wersję Windows i wersję pakietu. Przed wysyłką przejrzyj dziennik pod kątem haseł podanych jako właściwości w wierszu polecenia.
Jak zapobiegać
- Włączaj logowanie /l*v w każdym skrypcie instalacyjnym i trzymaj logi minimum przez kilka dni.
- Przed wdrożeniem na wszystkie stacje przetestuj pakiet na maszynie wirtualnej z tym samym obrazem Windows.
- Podawaj konta usług w formacie Domena\Użytkownik zgodnym z dokumentacją producenta.
- Nie uruchamiaj instalatorów w trybie zgodności i nie ustawiaj go globalnie.
W firmie
W firmie kod 1603 zwykle trafia do Ciebie jako sam kod wyjścia z narzędzia wdrożeniowego, bez okna z opisem, więc dziennik jest jedynym tropem. Dopisz logowanie do skryptu wdrożenia na stałe i zbieraj pliki .log do jednego udziału. Jeśli seria stacji kończy się tym samym kodem, szukaj wspólnej cechy: konta usługi, polityki bezpieczeństwa albo wersji systemu. Gdy analiza dziennika zjada Ci czas, nasz serwis IT w Warszawie przeanalizuje go zdalnie albo na miejscu.
Pytania i odpowiedzi
Czy kod 1603 oznacza uszkodzony system?
Nie. To kod ogólny: Microsoft opisuje go tylko jako błąd krytyczny podczas instalacji. Przyczyną bywa jedna akcja pakietu, uprawnienie albo konfiguracja, a nie uszkodzenie systemu.
Dlaczego w dzienniku jest kilka wierszy „Return value 3”?
Pierwsze wskazuje akcję, która zawiodła. Kolejne pojawiają się podczas wycofywania zmian, dlatego analizę zaczynaj od pierwszego wystąpienia.
Czy ponowna instalacja tego samego pliku coś zmieni?
Zwykle nie, jeśli nie zmieniła się przyczyna. Najpierw wykonaj kroki z dziennika, a dopiero potem ponów próbę.
Źródła
Opracowanie: zespół REDBAX – serwis komputerowy i obsługa informatyczna firm, Warszawa-Wawer. Stan na 02.11.2026. Kroki wykonujesz na własną odpowiedzialność – przed zmianami w systemie zrób kopię ważnych danych.