HTTP 500.33, 500.36 i 500.38 – Request Handler Load Failure, Out-Of-Process Handler i Application DLL Not Found

Trzy rzadsze błędy ASP.NET Core Module: 500.33, 500.36 i 500.38. Zobacz, co oznaczają, i jak naprawić referencję frameworka, moduł oraz publikację single-file.

  • Windows Server · ASP.NET Core Module
  • Poziom: średni
  • Czas: 20–40 minut
  • 500.33
  • 500.36
  • 500.38
  • PublishSingleFile
  • AspNetCoreHostingModel
  • aspnetcorev2_outofprocess.dll

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

  1. 500.33: aplikacja nie odwołuje się do frameworka Microsoft.AspNetCore.App, więc moduł nie może załadować handlera żądań.
  2. 500.36: obok pliku aspnetcorev2.dll nie ma biblioteki aspnetcorev2_outofprocess.dll – instalacja modułu jest uszkodzona.
  3. 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

  1. 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, Message
  2. 500.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.json
  3. 500.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, Length
  4. 500.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 w3svc
  5. 500.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=false
  6. 500.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, Length
  7. Zweryfikuj 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.

Serwer stoi, a firma czeka?

Administrujemy serwerami Windows w firmach z Warszawy i okolic. Zdiagnozujemy problem zdalnie, a gdy trzeba – przyjedziemy.