Na czym polega problem
Błędy 500.30, 500.31 i 500.32 mają osobne poradniki. Obok nich ASP.NET Core Module ma jednak kilka rzadszych kodów, które łatwo pomylić, bo każdy z nich mówi o czymś innym: 500.33 dotyczy referencji do frameworka, 500.36 uszkodzonej instalacji samego modułu, a 500.38 sposobu publikacji aplikacji.
Ten artykuł zbiera je razem, żeby oszczędzić czas przy diagnozie. Każdy kod ma swoją przyczynę wskazaną w dokumentacji Microsoftu i jedną, konkretną poprawkę. Najpierw odczytaj numer z komunikatu, potem przejdź do właściwego kroku.
Objawy
- Strona błędu 500.33 – ANCM Request Handler Load Failure, 500.36 – ANCM Out-Of-Process Handler Load Failure albo 500.38 – ANCM Application DLL Not Found.
- Aplikacja nie startuje, choć IIS i Hosting Bundle są zainstalowane.
- Błąd pojawił się po zmianie sposobu publikacji (na przykład włączono pojedynczy plik) albo po aktualizacji IIS lub Visual Studio.
- Dziennik zdarzeń zawiera wpisy modułu z tym samym numerem błędu.
Najczęstsze przyczyny
- 500.33: aplikacja nie odwołuje się do frameworka Microsoft.AspNetCore.App, więc moduł nie może załadować handlera żądań.
- 500.36: obok pliku aspnetcorev2.dll nie ma biblioteki aspnetcorev2_outofprocess.dll – instalacja modułu jest uszkodzona.
- 500.38: opublikowano aplikację jako pojedynczy plik (PublishSingleFile) w modelu in-process, który tego nie obsługuje, więc biblioteki aplikacji nie ma obok pliku wykonywalnego.
Rozwiązanie krok po kroku
Odczytaj dokładny kod błędu
Numer z tytułu strony błędu rozstrzyga, którą ścieżką pójść. Jeżeli nie widać go w przeglądarce, odszukaj ten sam numer w dzienniku zdarzeń Application, w źródle IIS AspNetCore Module V2.
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='IIS AspNetCore Module V2'} -MaxEvents 5 | Format-List TimeCreated, Message500.33 – sprawdź, jakiego frameworka żąda aplikacja
Otwórz plik .runtimeconfig.json i upewnij się, że docelowym frameworkiem jest Microsoft.AspNetCore.App. Jeżeli w sekcji frameworku widnieje wyłącznie Microsoft.NETCore.App, brakuje w niej odwołania do ASP.NET Core, którego wymaga moduł. Projekt webowy powinien w pierwszej linii deklarować zestaw SDK Microsoft.NET.Sdk.Web.
Get-Content .\Aplikacja.runtimeconfig.json500.36 – sprawdź pliki modułu
Wypisz zawartość katalogu modułu i sprawdź, czy obecne są oba pliki: aspnetcorev2.dll oraz aspnetcorev2_outofprocess.dll. Gdy któregoś brakuje, uruchom ponownie instalator Hosting Bundle i wybierz naprawę.
Get-ChildItem "$env:ProgramFiles\IIS\Asp.Net Core Module\V2" | Select-Object Name, Length500.36 – po naprawie zrestartuj IIS
Zatrzymaj WAS z usługami zależnymi i uruchom W3SVC. Dla IIS Express naprawy dokonuje się przez instalator Visual Studio.
net stop was /y net start w3svc500.38 – wyłącz pojedynczy plik albo zmień model hostingu
Masz dwie drogi, obie z dokumentacji. Pierwsza: ustaw w projekcie PublishSingleFile na false i opublikuj ponownie. Druga: przełącz aplikację na model out-of-process, ustawiając w pliku projektu AspNetCoreHostingModel na OutOfProcess.
dotnet publish -c Release -p:PublishSingleFile=false500.38 – sprawdź zawartość katalogu publikacji
Upewnij się, że obok pliku wykonywalnego aplikacji znajduje się jej biblioteka (plik dll o tej samej nazwie) oraz plik web.config. Brak biblioteki to dokładnie ten objaw, który zgłasza 500.38.
Get-ChildItem D:\WWW\Aplikacja -Filter Aplikacja.* | Select-Object Name, LengthZweryfikuj poprawkę
Po zmianach wyślij jedno żądanie do aplikacji i obejrzyj dziennik. Jeśli nadal widzisz ten sam kod, porównaj zawartość katalogu z poprzednim działającym wydaniem.
Jak zapobiegać
- Utrwal polecenie publikacji w repozytorium (skrypt lub definicja potoku), zamiast klikać ustawienia ręcznie.
- Po każdym wdrożeniu porównuj zawartość katalogu z poprzednim wydaniem.
- Nie publikuj do pojedynczego pliku aplikacji hostowanych in-process w IIS.
- Po aktualizacji Hosting Bundle zapisz wersję aspnetcorev2.dll i sprawdź obecność plików handlerów.
W firmie
Wszystkie trzy kody mają źródło w tym, jak aplikację zbudowano i opublikowano albo jak zainstalowano moduł – nie w ruchu użytkowników. Dlatego w dokumentacji wdrożenia zapisz dokładne polecenie publikacji i ustawienia projektu (model hostingu, publikacja do pojedynczego pliku). Jeśli firma w Falenicy lub okolicy ma aplikację dostarczaną przez zewnętrznego wykonawcę, możemy sprawdzić pakiet wdrożeniowy i serwer zdalnie, zanim awaria zatrzyma pracę działu sprzedaży.
Pytania i odpowiedzi
Czy 500.36 oznacza, że aplikacja jest uszkodzona?
Nie, uszkodzony jest moduł, a nie aplikacja. Dokumentacja wiąże ten kod z brakiem pliku aspnetcorev2_outofprocess.dll obok aspnetcorev2.dll i zaleca naprawę pakietu Hosting Bundle.
Czy mogę zostawić publikację do pojedynczego pliku?
Tak, ale nie z modelem in-process w IIS. Przy PublishSingleFile=true przełącz aplikację na model out-of-process; inaczej możesz zobaczyć 500.38.
Ź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.