Solução de problemas de erros comuns para o Serviço de Aplicativo do Azure e o IIS com ASP.NET Core

Este tópico descreve os erros mais comuns e fornece conselhos de solução de problemas ao hospedar aplicativos ASP.NET Core no Serviço de Aplicativos do Azure e no IIS.

Consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e informações do IIS sobre erros comuns de inicialização do aplicativo e instruções sobre como diagnosticar erros.

Colete as seguintes informações:

• Comportamento do navegador, como código de status e mensagem de erro.
• Entradas do log de eventos do aplicativo
  • Serviço de Aplicativo do Azure: consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.
  • IIS
    1. Selecione Iniciar no menu Windows , digite Visualizador de Eventos e pressione Enter.
    2. Depois que o Visualizador de Eventos abrir, expanda Logs do Windows>Aplicação na barra lateral.
• ASP.NET Módulo principal stdout e entradas de log de depuração
  • Serviço de Aplicativo do Azure: consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.
  • IIS: Siga as instruções nas seções Criação e redirecionamento de logs e Logs de diagnóstico aprimorados do tópico Módulo principal do ASP.NET.

Compare as informações de erro com os seguintes erros comuns. Se for encontrada uma correspondência, siga as instruções para resolução de problemas.

A lista de erros neste tópico não é exaustiva. Se você encontrar um erro não listado aqui, abra um novo problema usando o botão Comentários de conteúdo na parte inferior deste tópico com instruções detalhadas sobre como reproduzir o erro.

Important

Versões de visualização do ASP.NET Core com o Serviço de Aplicações do Azure

ASP.NET versões de visualização principais não são implantadas no Serviço de Aplicativo do Azure por padrão. Para hospedar uma aplicação que usa uma versão de visualização do ASP.NET Core, consulte Implantar a versão de visualização do ASP.NET Core no Serviço de Aplicações do Azure.

A atualização do SO removeu o módulo ASP.NET Core de 32 bits

Registo da aplicação: Falha ao carregar a DLL do móduloC:\WINDOWS\system32\inetsrv\aspnetcore.dll . Os dados são o erro.

Troubleshooting:

Os arquivos que não são do sistema operacional no diretório C:\Windows\SysWOW64\inetsrv não são preservados durante uma atualização do sistema operacional. Se o ASP.NET Core Module for instalado antes de uma atualização do sistema operacional e, em seguida, qualquer pool de aplicativos for executado no modo de 32 bits após uma atualização do sistema operacional, esse problema será encontrado. Após uma atualização do sistema operacional, repare o ASP.NET Core Module. Consulte Instalar o pacote de hospedagem .NET. Selecione Reparar quando o instalador for executado.

Extensão de site ausente, extensões de site de 32 bits (x86) e 64 bits (x64) instaladas ou conjunto de bits de processo errado

Aplica-se a aplicativos hospedados pelos Serviços de Aplicativo do Azure.

• Navegador: Erro HTTP 500.0 - Falha de carga do manipulador de In-Process ANCM

• Registo da aplicação: Invocar hostfxr para localizar o manipulador de solicitação em processo falhou sem encontrar nenhuma dependência nativa. Não foi possível encontrar o manipulador de solicitações em processamento. Saída capturada invocando hostfxr: Não foi possível encontrar nenhuma versão de framework compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}-preview-*' não foi encontrada. Falha ao iniciar o aplicativo '/LM/W3SVC/1416782824/ROOT', ErrorCode '0x8000ffff'.

• Log stdout do Módulo Core do ASP.NET: Não foi possível encontrar nenhuma versão de framework compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}-preview-*' não foi encontrada.

• ASP.NET Debug Log do Módulo Core: Invocar o hostfxr para encontrar o gestor de pedidos em processo falhou por não encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões de Microsoft.NetCore.App e Microsoft.AspNetCore.App que são alvo do aplicativo e estão instaladas na máquina. HRESULT falhou com código de retorno: 0x8000ffff. Não foi possível encontrar o manipulador de solicitações em processamento. Não foi possível encontrar nenhuma versão de framework compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}-preview-*' não foi encontrada.

Troubleshooting:

• Se está a executar a aplicação num runtime de pré-visualização, instale a extensão de site de 32 bits (x86) ou de 64 bits (x64) que corresponde à arquitetura da aplicação e à versão do runtime da aplicação. Não instale ambas as extensões ou várias versões de tempo de execução da extensão.

  • ASP.NET Core {RUNTIME VERSION} (x86) Ambiente de Execução
  • ASP.NET Core {RUNTIME VERSION} (x64) Tempo de execução

  Reinicie o aplicativo. Aguarde alguns segundos até que o aplicativo seja reiniciado.

• Se estiver a executar a aplicação num runtime de pré-visualização e as extensões de site de 32 bits (x86) e 64 bits (x64) estiverem instaladas, desinstale a extensão de site que não corresponde ao número de bits da aplicação. Depois de remover a extensão do site, reinicie o aplicativo. Aguarde alguns segundos até que o aplicativo seja reiniciado.

• Se a execução do aplicativo em um tempo de execução de visualização e o número de bits da extensão do site corresponder ao do aplicativo, confirme se a versão de tempo de execução da extensão de site de visualização corresponde à versão de tempo de execução do aplicativo.

• Confirme se a plataforma do aplicativo em Configurações do aplicativo corresponde ao número de bits do aplicativo.

Para obter mais informações, consulte Implantar aplicativos ASP.NET Core no Serviço de Aplicativo do Azure.

Um aplicativo x86 é implantado, mas o pool de aplicativos não está habilitado para aplicativos de 32 bits

• Navegador: Erro HTTP 500.30 - Falha de inicialização do In-Process ANCM

• Registo da aplicação: A aplicação '/LM/W3SVC/5/ROOT' com raiz física '{PATH}' encontrou uma exceção gerenciada inesperada, código de exceção = '0xe0434352'. Por favor, verifique os logs stderr para obter mais informações. A aplicação '/LM/W3SVC/5/ROOT' com raiz física '{PATH}' falhou em carregar a CLR e a aplicação gerida. O thread de trabalho CLR saiu prematuramente

• Log stdout do Módulo ASP.NET Core: O ficheiro de log é criado, mas vazio.

• Registo de depuração do módulo ASP.NET Core: Falha no HRESULT retornado: 0x8007023e

Esse cenário é capturado pelo SDK ao publicar um aplicativo independente. O SDK produz um erro se o RID não corresponder ao destino da plataforma (por exemplo, win10-x64 RID com <PlatformTarget>x86</PlatformTarget> no arquivo de projeto).

Troubleshooting:

Para uma implantação dependente da estrutura x86 (<PlatformTarget>x86</PlatformTarget>), habilite o pool de aplicativos do IIS para aplicativos de 32 bits. No Gerenciador do IIS, abra as Configurações Avançadas do pool de aplicativos e defina Habilitar Aplicativos de 32 Bits como True.

Conflitos de plataforma com RID

• Navegador: Erro HTTP 502.5 - Falha de processo

• Registo da aplicação: O aplicativo 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' com raiz física 'C:{PATH}' falhou ao iniciar o processo com a linha de comando '"C:{PATH}{ASSEMBLY}. {exe|dll}" ', ErrorCode = '0x80004005 : ff.

• Registo stdout do Módulo ASP.NET Core: Exceção não tratada: System.BadImageFormatException: Não foi possível carregar o ficheiro ou assembly '{ASSEMBLY}.dll'. Foi feita uma tentativa de carregar um programa com um formato incorreto.

Troubleshooting:

• Confirme se o aplicativo é executado localmente no Kestrel. Uma falha de processo pode ser o resultado de um problema dentro do aplicativo. Para obter mais informações, consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.

• Se essa exceção ocorrer para uma implantação de Aplicativos do Azure ao atualizar um aplicativo e implantar assemblies mais recentes, exclua manualmente todos os arquivos da implantação anterior. Assemblies incompatíveis persistentes podem resultar numa System.BadImageFormatException exceção ao implantar uma aplicação atualizada.

Ponto final de URI incorreto ou site inativo

• Navegador: ERR_CONNECTION_REFUSED --OR-- Não é possível conectar

• Registo da aplicação: Sem entrada

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de Depuração do Módulo ASP.NET Core: O ficheiro de log não foi criado.

Troubleshooting:

• Confirme se o ponto de extremidade URI correto para a aplicação está a ser utilizado. Verifique as associações.

• Confirme se o site do IIS não está no estado Parado .

Recursos do servidor CoreWebEngine ou W3SVC desativados

Exceção do SO: Os recursos CoreWebEngine e W3SVC do IIS 7.0 devem ser instalados para usar o módulo principal do ASP.NET.

Troubleshooting:

Confirme se a função e os recursos apropriados estão habilitados. Consulte Configuração do IIS.

Caminho físico da página web incorreto ou aplicação ausente

• Navegador: 403 Proibido - Acesso negado --OR-- 403.14 Proibido - O servidor Web está configurado para não listar o conteúdo deste diretório.

• Registo da aplicação: Sem entrada

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de Depuração do Módulo ASP.NET Core: O ficheiro de log não foi criado.

Troubleshooting:

Verifique as Configurações Básicas do site do IIS e a pasta física do aplicativo. Confirme se o aplicativo está na pasta no site do IIS Caminho físico.

Função incorreta, ASP.NET módulo principal não instalado ou permissões incorretas

• Navegador: 500.19 Erro interno do servidor - A página solicitada não pode ser acessada porque os dados de configuração relacionados para a página são inválidos. --OU-- Esta página não pode ser exibida

• Registo da aplicação: Sem entrada

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de Depuração do Módulo ASP.NET Core: O ficheiro de log não foi criado.

Troubleshooting:

• Confirme se a função adequada está ativada. Consulte Configuração do IIS.

• Abra Programas & Recursos ou Aplicativos & recursos e confirme se o Windows Server Hosting está instalado. Se o Windows Server Hosting não estiver presente na lista de programas instalados, baixe e instale o .NET Hosting Bundle.

  Instalador atual do .NET Hosting Bundle (download direto)

  Para obter mais informações, consulte Instalar o .NET Hosting Bundle.

• Verifique se o Pool de Aplicativos>Modelo de Processo>Identity está definido como ApplicationPoolIdentity ou se a identidade personalizada tem as permissões corretas para acessar a pasta de implantação do aplicativo.

• Se você desinstalou o ASP.NET Core Hosting Bundle e instalou uma versão anterior do pacote de hospedagem, o arquivo applicationHost.config não inclui uma seção para o ASP.NET Core Module. Abra applicationHost.config em %windir%/System32/inetsrv/config e encontre o grupo de <configuration><configSections><sectionGroup name="system.webServer"> seções. Se a seção do módulo principal do ASP.NET estiver ausente do grupo de seções, adicione o elemento seção:

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  Como alternativa, instale a versão mais recente do ASP.NET Core Hosting Bundle. A versão mais recente é retrocompatível com as aplicações ASP.NET Core suportadas.

ProcessPath incorreto, variável PATH ausente, Hosting Bundle não instalado, sistema/IIS não reiniciado, VC++ Redistributable não instalado ou violação de acesso dotnet.exe

• Navegador: Erro HTTP 500.0 - Falha de carga do manipulador de In-Process ANCM

• Registo da aplicação: O aplicativo 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' com raiz física 'C:{PATH}' falhou ao iniciar o processo com a linha de comando '"{...}" ', ErrorCode = '0x80070002 : 0. O aplicativo '{PATH}' não pôde ser iniciado. O executável não foi encontrado em '{PATH}'. Falha ao iniciar o aplicativo '/LM/W3SVC/2/ROOT', ErrorCode '0x8007023e'.

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de depuração do Módulo ASP.NET Core: Log de eventos: 'O aplicativo '{PATH}' não pôde ser iniciado. O executável não foi encontrado em '{PATH}'. Falha no HRESULT retornado: 0x8007023e

Troubleshooting:

• Confirme se o aplicativo é executado localmente no Kestrel. Uma falha de processo pode ser o resultado de um problema dentro do aplicativo. Para obter mais informações, consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.

• Verifique o atributo processPath no elemento <aspNetCore> em web.config para confirmar se é para uma implantação dependente de dotnet (FDD) ou .\{ASSEMBLY}.exe para uma implantação autónoma (SCD).

• Para um FDD, dotnet.exe pode não estar acessível através das configurações PATH. Confirme se C:\Program Files\dotnet\ existe nas configurações do System PATH.

• Para um FDD, dotnet.exe pode não estar acessível para a identidade do usuário do pool de aplicativos. Confirme se a identidade do usuário do pool de aplicativos tem acesso ao diretório C:\Program Files\dotnet . Confirme se não há regras de negação configuradas para a identidade do usuário do pool de aplicativos nos diretórios C:\Arquivos de Programas\dotnet e aplicativo.

• Um FDD pode ter sido implantado e o .NET instalado sem reiniciar o IIS. Reinicie o servidor ou reinicie o IIS executando net stop was /y seguido de net start w3svc a partir de um prompt de comando.

• Um FDD pode ter sido implantado sem que o runtime do .NET tenha sido instalado no sistema de hospedagem. Se o runtime do .NET não tiver sido instalado, execute o instalador do .NET Hosting Bundle no sistema.

  Instalador atual do .NET Hosting Bundle (download direto)

  Para obter mais informações, consulte Instalar o .NET Hosting Bundle.

  Se um tempo de execução específico for necessário, baixe o tempo de execução da página Downloads do .NET e instale-o no sistema. Conclua a instalação reiniciando o sistema ou reiniciando o IIS, executando net stop was /y seguido de net start w3svc a partir de um prompt de comando.

Argumentos incorretos do <elemento aspNetCore>

• Navegador: Erro HTTP 500.0 - Falha de carga do manipulador de In-Process ANCM

• Registo da aplicação: Invocar hostfxr para localizar o manipulador de solicitação em processo falhou sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões de Microsoft.NetCore.App e Microsoft.AspNetCore.App que são alvo do aplicativo e estão instaladas na máquina. Não foi possível encontrar o manipulador de solicitações em processamento. Saída capturada ao invocar hostfxr: Você pretendia executar comandos dotnet SDK? Instale o dotnet SDK a partir de: https://go.microsoft.com/fwlink/?LinkID=798306& clcid=0x409 Falha ao iniciar o aplicativo '/LM/W3SVC/3/ROOT', ErrorCode '0x8000ffff'.

• Log stdout do módulo ASP.NET Core: Quis dizer executar comandos do SDK do dotnet? Instale o dotnet SDK a partir de: https://go.microsoft.com/fwlink/?LinkID=798306& clcid=0x409

• ASP.NET Debug Log do Módulo Core: Invocar o hostfxr para encontrar o gestor de pedidos em processo falhou por não encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões de Microsoft.NetCore.App e Microsoft.AspNetCore.App que são alvo do aplicativo e estão instaladas na máquina. Falha no HRESULT retornado: 0x8000ffff Não foi possível encontrar o manipulador de solicitação em processo. Saída capturada ao invocar hostfxr: Você pretendia executar comandos dotnet SDK? Instale o dotnet SDK a partir de: https://go.microsoft.com/fwlink/?LinkID=798306& clcid=0x409 HRESULT com falha retornado: 0x8000ffff

Troubleshooting:

• Confirme se o aplicativo é executado localmente no Kestrel. Uma falha de processo pode ser o resultado de um problema dentro do aplicativo. Para obter mais informações, consulte Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.

• Examine o atributo arguments no elemento <aspNetCore> em web.config para confirmar se está (a) .\{ASSEMBLY}.dll para uma implantação dependente de estrutura (FDD); ou (b) não presente, uma cadeia de caracteres vazia (arguments=""), ou uma lista dos argumentos da aplicação (arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}") para uma implantação autônoma (SCD).

Estrutura compartilhada .NET ausente

• Navegador: Erro HTTP 500.0 - Falha de carga do manipulador de In-Process ANCM

• Registo da aplicação: Invocar hostfxr para localizar o manipulador de solicitação em processo falhou sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões de Microsoft.NetCore.App e Microsoft.AspNetCore.App que são alvo do aplicativo e estão instaladas na máquina. Não foi possível encontrar o manipulador de solicitações em processamento. Saída capturada invocando hostfxr: Não foi possível encontrar nenhuma versão de framework compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}' não foi encontrada.

Falha ao iniciar o aplicativo '/LM/W3SVC/5/ROOT', ErrorCode '0x8000ffff'.

• Log stdout do Módulo Core do ASP.NET: Não foi possível encontrar nenhuma versão de framework compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}' não foi encontrada.

• ASP.NET Log de depuração do módulo principal: Falha no HRESULT retornado: 0x8000ffff

Troubleshooting:

Para uma implantação dependente de estrutura (FDD), confirme se o tempo de execução correto está instalado no sistema.

Pool de aplicações interrompido.

• Navegador: Serviço 503 indisponível

• Registo da aplicação: Sem entrada

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de Depuração do Módulo ASP.NET Core: O ficheiro de log não foi criado.

Troubleshooting:

Confirme se o Pool de Aplicativos não está no estado Parado .

O subaplicativo inclui uma <seção de manipuladores>

• Navegador: Erro HTTP 500.19 - Erro interno do servidor

• Registo da aplicação: Sem entrada

• Log stdout do módulo ASP.NET Core: O ficheiro de log da aplicação raiz é criado e mostra a operação normal. O arquivo de log do subaplicativo não é criado.

• ASP.NET Log de depuração do módulo principal: O arquivo de log do aplicativo raiz é criado e mostra a operação normal. O arquivo de log do subaplicativo não é criado.

Troubleshooting:

Confirme que o arquivo web.config do subaplicativo não inclui uma <handlers> seção ou que o subaplicativo não herda os manipuladores do aplicativo pai.

A seção <system.webServer> de web.config do aplicativo pai é colocada dentro do elemento <location>. A InheritInChildApplications propriedade é definida para false para que as <configurações especificadas no elemento location> não sejam herdadas por aplicações que residem num subdiretório da aplicação principal. Para obter mais informações, consulte ASP.NET ANCM (Core Module) para IIS.

caminho de log stdout incorreto

• Navegador: O aplicativo responde normalmente.

• Registo da aplicação: Não foi possível iniciar o redirecionamento stdout em C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Mensagem de exceção: HRESULT 0x80070005 retornado em {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84. Não foi possível parar o redirecionamento stdout em C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Mensagem de exceção: HRESULT 0x80070002 retornado em {PATH}. Não foi possível iniciar o redirecionamento stdout em {PATH}\aspnetcorev2_inprocess.dll.

• Log stdout do Módulo Core do ASP.NET: O ficheiro de log não foi criado.

• Log de depuração do módulo ASP.NET Core: Não foi possível iniciar o redirecionamento do stdout em C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Mensagem de exceção: HRESULT 0x80070005 retornado em {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84. Não foi possível parar o redirecionamento stdout em C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Mensagem de exceção: HRESULT 0x80070002 retornado em {PATH}. Não foi possível iniciar o redirecionamento stdout em {PATH}\aspnetcorev2_inprocess.dll.

Troubleshooting:

• O stdoutLogFile caminho especificado no <aspNetCore> elemento deweb.config não existe. Para obter mais informações, consulte ASP.NET Core Module: Criação e redirecionamento de log.

• O utilizador do pool de aplicações não tem permissão de escrita no caminho do log stdout.

Problema geral de configuração do aplicativo

• Navegador: Erro HTTP 500.0 - Falha de carga do manipulador de In-Process ANCM --OR-- Erro HTTP 500.30 - Falha de inicialização do In-Process ANCM

• Registo da aplicação: Variável

• Log stdout do Módulo ASP.NET Core: O ficheiro de log é criado, mas permanece vazio ou é criado com entradas normais até ao momento em que a aplicação falha.

• Log de depuração do módulo ASP.NET Core: Variável

Troubleshooting:

O processo falhou ao iniciar, provavelmente devido a um problema de configuração ou programação do aplicativo.

Para obter mais informações, consulte os seguintes tópicos:

• Solucionar problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS
• Solucionar problemas e depurar projetos ASP.NET Core