"Os Erros HTTP Ocultos" (Por trás do IIS)

Você envia uma requisição HTTP e recebe de volta um erro HTTP, mas com uma página de erro HTML que você não esperava... o que está acontecendo? 🤔

Especificamente, por exemplo: talvez você tenha tentado ler um recurso FHIR (ex: /Patient/123) e recebeu uma página de erro 404, embora com outros IDs de pacientes você receba o payload do recurso normalmente — então "a página" definitivamente existe... por que você estaria recebendo uma página de erro 404? 🙄

A resposta para essas perguntas está relacionada ao comportamento do servidor web IIS na forma como ele lida com erros.

O IIS possui 3 opções para exibir erros:

• Sempre mostrar apenas páginas de erro personalizadas
• Sempre mostrar erros detalhados do servido
• Para requisições locais, mostrar erros detalhados; mas para requisições remotas, mostrar páginas de erro personalizadas.

Esta última opção é mais segura (do que sempre mostrar erros detalhados) porque, às vezes, os detalhes do erro podem expor informações internas que você não deseja que usuários externos visualizem. Por isso, este é o padrão do IIS.

No entanto, isso significa que, se você estiver testando contra um servidor remoto, os erros reais estarão ocultos para você. Portanto, você precisaria alterar essa configuração para "Erros detalhados" (pelo menos durante as fases de depuração e assumindo que você está considerando o acesso externo e, talvez, limitando-o).

Veja mais detalhes sobre essa configuração em um artigo IIS relacionado (e você pode consultar esta seção relacionada em nossa documentação que discute o assunto).

O exemplo específico de FHIR que mencionei é um caso interessante, pois um erro 404 poderia significar simplesmente que um recurso FHIR específico não foi encontrado (o ID que você tentou ler não está no repositório), e não que você tem algum problema no servidor ("página não encontrada").

Por exemplo, se você conseguir visualizar o erro detalhado, verá algo assim:

Mas, sem o erro detalhado, você receberia apenas uma página de erro personalizada, como esta:

E isso pode ser enganoso, portanto, mantenha essa configuração do IIS em mente.