Solucionar problemas com erros comuns no Serviço de Aplicativo do Azure e no IIS com o ASP.NET Core

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

Consulte informações sobre Solução de problemas do ASP.NET Core em Serviço de Aplicativos do Azure e no 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 Solução de 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. Após o Visualizador de Eventos ser aberto, expanda Logs do Windows>Aplicativo na barra lateral.
• Entradas do log de depuração e stdout do Módulo do ASP.NET Core
  • Serviço de Aplicativo do Azure: consulte Solução de 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 de log e redirecionamento e Logs de diagnóstico avançados do tópico Módulo do ASP.NET Core.

Compare as informações do erro para os erros comuns a seguir. Se uma correspondência for encontrada, siga o aviso de soluçã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 sobre o Conteúdo na parte inferior deste tópico com instruções detalhadas sobre como reproduzir o erro.

Important

Versões prévias do ASP.NET Core com o Serviço de Aplicativo do Azure

Versões prévias do ASP.NET Core não são implantadas para o Serviço de Aplicativo do Azure por padrão. Para hospedar um aplicativo que usa uma versão prévia do ASP.NET Core, veja Implantar versão prévia do ASP.NET Core para o Serviço de Aplicativo do Azure.

O upgrade do sistema operacional removeu o Módulo do ASP.NET Core de 32 bits

Log do Aplicativo: a DLL do Módulo C:\WINDOWS\system32\inetsrv\aspnetcore.dll falhou ao ser carregada. Os dados são o erro.

Troubleshooting:

Arquivos que não são do sistema operacional no diretório C:\Windows\SysWOW64\inetsrv não são preservados durante um upgrade do sistema operacional. Se o Módulo do ASP.NET Core estiver 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 um upgrade do sistema operacional, repare o Módulo do ASP.NET Core. Consulte Instalar o pacote de hospedagem do .NET. Selecione Reparar ao executar o instalador.

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

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

• Navegador: Erro HTTP 500.0 - Falha de carregamento do manipulador em processo ANCM

• Log do aplicativo: a invocação do hostfxr para encontrar o manipulador de solicitação em processo falha sem encontrar nenhuma dependência nativa. Não foi possível localizar o manipulador de solicitação inprocess. Saída capturada da invocação de hostfxr: não foi possível encontrar nenhuma versão de estrutura 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 ASP.NET Core: não foi possível encontrar nenhuma versão de estrutura compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}-preview-*' não foi encontrada.

• Log de depuração do Módulo ASP.NET Core: a invocação do hostfxr para encontrar o manipulador de solicitação em processo falha sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões do Microsoft.NetCore.App e Microsoft.AspNetCore.App que são afetadas pelo aplicativo e estão instaladas no computador. Falha em HRESULT retornou: 0x8000ffff. Não foi possível localizar o manipulador de solicitação inprocess. Não foi possível encontrar nenhuma versão de estrutura compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}-preview-*' não foi encontrada.

Troubleshooting:

• Se estiver executando o aplicativo em um runtime de visualização, instale a extensão de site de 32 bits (x86) ou de 64 bits (x64) que corresponda ao número de bit do aplicativo e à versão de runtime do aplicativo. Não instale extensões ou várias versões de runtime da extensão.

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

  Reinicie o aplicativo. Aguarde vários segundos até que o aplicativo seja reiniciado.

• Se a execução do aplicativo em um runtime de 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 bit do aplicativo. Depois de remover a extensão de site, reinicie o aplicativo. Aguarde vários segundos até que o aplicativo seja reiniciado.

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

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

Para obter mais informações, consulte Implantar aplicativos do ASP.NET Core para 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 início em processo do ANCM

• Log do aplicativo: aplicativo '/LM/W3SVC/5/ROOT' com raiz física '{PATH}' atingiu uma exceção gerenciada inesperada, código da exceção = '0xe0434352'. Verifique os logs de stderr para obter mais informações. Aplicativo '/LM/W3SVC/5/ROOT' com raiz física '{PATH}' falhou ao carregar o clr e o aplicativo gerenciado. O thread de trabalho do CLR foi encerrado prematuramente

• Log stdout do Módulo ASP.NET Core: o arquivo de log é criado, mas está vazio.

• Log de depuração do Módulo ASP.NET Core: Falha em HRESULT retornou: 0x8007023e

Esse cenário é interceptado pelo SDK ao publicar um aplicativo autocontido. O SDK produzirá um erro se o RID não coincidir com o destino da plataforma (por exemplo, RID win10-x64 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 de 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 Verdadeiro.

Conflitos de plataforma com o RID

• Navegador: 502.5 Erro HTTP – falha do processo

• Log do aplicativo: o aplicativo 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' com a raiz física 'C:PATH} falhou ao iniciar o processo com a linha de comando '"C:{PATH}{ASSEMBLY}.{exe|dll}" ', código de erro = '0x80004005 : ff.

• Log stdout do Módulo do ASP.NET Core: exceção sem tratamento: System.BadImageFormatException: não foi possível carregar o arquivo ou o 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 do processo pode ser o resultado de um problema no aplicativo. Para obter mais informações, consulte Solução de problemas do ASP.NET Core no Serviço de Aplicativo do Azure e no IIS.

• Se essa exceção ocorrer para uma implantação dos Aplicativos do Azure ao fazer upgrade de um aplicativo e implantar assemblies mais recentes, exclua manualmente todos os arquivos da implantação anterior. Assemblies incompatíveis remanescentes podem resultar em uma exceção System.BadImageFormatException durante a implantação de um aplicativo atualizado.

Ponto de extremidade de URI incorreto ou site interrompido

• Navegador: ERR_CONNECTION_REFUSED --OU-- Não é possível estabelecer conexão

• Log do Aplicativo: nenhuma entrada

• Log stdout do Módulo ASP.NET Core: o arquivo de log não é criado.

• Log de depuração do Módulo ASP.NET Core: o arquivo de log não é criado.

Troubleshooting:

• Confirme se o ponto de extremidade do URI correto para o aplicativo está sendo usado. Verifique as associações.

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

Recursos do servidor CoreWebEngine ou W3SVC desabilitados

Exceção do Sistema Operacional: os recursos CoreWebEngine e W3SVC do IIS 7.0 devem ser instalados para usar o Módulo do ASP.NET Core.

Troubleshooting:

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

Caminho físico do site incorreto ou aplicativo ausente

• Navegador: 403 Proibido – acesso negado OU 403.14 Proibido – o servidor Web está configurado para não listar o conteúdo deste diretório.

• Log do Aplicativo: nenhuma entrada

• Log stdout do Módulo ASP.NET Core: o arquivo de log não é criado.

• Log de depuração do Módulo ASP.NET Core: o arquivo de log não é criado.

Troubleshooting:

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

Função incorreta, Módulo do ASP.NET Core 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 da página são inválidos. –OU– Esta página não pode ser exibida

• Log do Aplicativo: nenhuma entrada

• Log stdout do Módulo ASP.NET Core: o arquivo de log não é criado.

• Log de depuração do Módulo ASP.NET Core: o arquivo de log não é criado.

Troubleshooting:

• Confirme que você habilitou a função apropriada. Consulte Configuração do IIS.

• Abra Programas e Recursos ou Aplicativos e Recursos e confirme se a Hospedagem do Windows Server está instalada. Se a Hospedagem do Windows Server não estiver presente na lista de programas instalados, baixe e instale o Pacote de Hospedagem do .NET.

  Instalador atual do Pacote de Hospedagem do .NET (download direto)

  Para obter mais informações, consulte Instalar o pacote de hospedagem do .NET.

• Verifique se o Modelo de Processo> do >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 Pacote de Hospedagem do ASP.NET Core e instalou uma versão anterior do pacote de hospedagem, o arquivo applicationHost.config não inclui uma seção para o Módulo do ASP.NET Core. Abra applicationHost.config em %windir%/System32/inetsrv/config e encontre o grupo de seção <configuration><configSections><sectionGroup name="system.webServer">. Se estiver faltando a seção do Módulo do ASP.NET Core no grupo de seções, adicione o elemento da seção:

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

  Como alternativa, instale a versão mais recente do Pacote de Hospedagem do ASP.NET Core. A versão mais recente é compatível com versões anteriores dos aplicativos do ASP.NET Core com suporte.

processPath incorreto, variável de PATH ausente, pacote de hospedagem não instalado, sistema/IIS não reiniciado, Pacotes Redistribuíveis do VC++ não instalados ou violação de acesso de dotnet.exe

• Navegador: Erro HTTP 500.0 - Falha de carregamento do manipulador em processo ANCM

• Log do aplicativo: o aplicativo 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' com a raiz física 'C:{PATH}' falhou ao iniciar o processo com a linha de comando '"{...}" ', ErrorCode = '0x80070002 : 0. Não foi possível iniciar o aplicativo '{PATH}'. 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 ASP.NET Core: o arquivo de log não é criado.

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

Troubleshooting:

• Confirme se o aplicativo é executado localmente no Kestrel. Uma falha do processo pode ser o resultado de um problema no aplicativo. Para obter mais informações, consulte Solução de 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 ele é dotnet para uma FDD (implantação dependente de estrutura) ou .\{ASSEMBLY}.exe para uma SCD (implantação autossuficiente).

• Para uma FDD, o dotnet.exe pode não estar acessível por meio das configurações de PATH. Confirme se C:\Program Files\dotnet existe nas configurações de PATH do Sistema.

• Para um FDD, dotnet.exe pode não estar acessível para a identidade de 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 o IIS executando net stop was /y seguido por net start w3svc em um prompt de comando.

• Um FDD pode ter sido implantado sem instalar o runtime do .NET no sistema de hospedagem. Se o runtime do .NET não tiver sido instalado, execute o instalador do Pacote de Hospedagem do .NET no sistema.

  Instalador atual do Pacote de Hospedagem do .NET (download direto)

  Para obter mais informações, consulte Instalar o pacote de hospedagem do .NET.

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

Argumentos incorretos do elemento <aspNetCore>

• Navegador: Erro HTTP 500.0 - Falha de carregamento do manipulador em processo ANCM

• Log do aplicativo: a invocação do hostfxr para encontrar o manipulador de solicitação em processo falha sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões do Microsoft.NetCore.App e Microsoft.AspNetCore.App que são afetadas pelo aplicativo e estão instaladas no computador. Não foi possível localizar o manipulador de solicitação inprocess. Saída capturada da invocação de hostfxr: você queria executar comandos do dotnet SDK? Instale o dotnet SDK de: https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 Falha ao iniciar o aplicativo '/LM/W3SVC/3/ROOT', código de erro '0x8000ffff'.

• Log stdout do Módulo ASP.NET Core: você queria executar comandos do dotnet SDK? Instale o dotnet SDK de: https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409

• Log de depuração do Módulo ASP.NET Core: a invocação do hostfxr para encontrar o manipulador de solicitação em processo falha sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões do Microsoft.NetCore.App e Microsoft.AspNetCore.App que são afetadas pelo aplicativo e estão instaladas no computador. Falha em HRESULT retornou: 0x8000ffff Não foi possível encontrar o manipulador de solicitação em processo. Saída capturada da invocação de hostfxr: você queria executar comandos do dotnet SDK? Instale o dotnet SDK de: https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 Falha em HRESULT retornou: 0x8000ffff

Troubleshooting:

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

• Examine o atributo arguments no elemento <aspNetCore> no web.config para confirmar se ele: (a) é .\{ASSEMBLY}.dll de uma FDD (implantação dependente de estrutura); ou (b) não está presente, é uma cadeia de caracteres vazia (arguments="") ou uma lista de argumentos do aplicativo (arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}") para uma SCD (implantação autossuficiente).

Framework compartilhado do .NET ausente

• Navegador: Erro HTTP 500.0 - Falha de carregamento do manipulador em processo ANCM

• Log do aplicativo: a invocação do hostfxr para encontrar o manipulador de solicitação em processo falha sem encontrar nenhuma dependência nativa. Isso provavelmente significa que o aplicativo está configurado incorretamente, verifique as versões do Microsoft.NetCore.App e Microsoft.AspNetCore.App que são afetadas pelo aplicativo e estão instaladas no computador. Não foi possível localizar o manipulador de solicitação inprocess. Saída capturada da invocação de hostfxr: não foi possível encontrar nenhuma versão de estrutura 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 ASP.NET Core: não foi possível encontrar nenhuma versão de estrutura compatível. A estrutura especificada 'Microsoft.AspNetCore.App', versão '{VERSION}', não foi encontrada.

• Log de depuração do Módulo ASP.NET Core: Falha em HRESULT retornou: 0x8000ffff

Troubleshooting:

Para uma FDD (implantação dependente de estrutura), confirme se você tem o runtime correto instalado no sistema.

Pool de aplicativos interrompido

• Navegador: 503 Serviço não disponível

• Log do Aplicativo: nenhuma entrada

• Log stdout do Módulo ASP.NET Core: o arquivo de log não é criado.

• Log de depuração do Módulo ASP.NET Core: o arquivo de log não é criado.

Troubleshooting:

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

O subaplicativo inclui uma seção <manipuladores>

• Navegador: 500.19 Erro HTTP – erro interno do servidor

• Log do Aplicativo: nenhuma entrada

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

• Log de depuração do Módulo ASP.NET Core: 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 se o arquivo web.config do subaplicativo não inclui uma seção <handlers> ou que o subaplicativo não herda os manipuladores do aplicativo pai.

A seção <system.webServer> do aplicativo pai de web.config é colocada dentro de um elemento <location>. A propriedade InheritInChildApplications é definida como false para indicar que as configurações especificadas no elemento <localização> não são herdadas por aplicativos que residem em um subdiretório do aplicativo pai. Para obter mais informações, confira Módulo do ASP.NET Core (ANCM) para o IIS.

caminho do log de stdout incorreto

• Navegador: o aplicativo responde normalmente.

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

• Log stdout do Módulo ASP.NET Core: o arquivo de log não é criado.

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

Troubleshooting:

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

• O usuário do pool de aplicativos não tem acesso de gravação para o caminho do log de stdout.

Problema geral de configuração do aplicativo

• Navegador: Erro HTTP 500.0 - Falha de carregamento do manipulador em processo do ANCM --OU-- Erro HTTP 500.30 - Falha de início em processo do ANCM

• Log do aplicativo: Variável

• Log stdout do Módulo ASP.NET Core: o arquivo de log é criado, mas está vazio, ou criado com entradas normais até o ponto da falha do aplicativo.

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

Troubleshooting:

O processo não pôde ser iniciado, provavelmente, devido a um problema de programação ou configuração do aplicativo.

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

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