ASP.NET Core 5 WebAPI 发布后的 Swagger 不显示问题

介绍

使用 netcore 作为纯后端提供 API 已经变得越来越频繁, swagger 也成为很多人的选择. 通常会在代码中限制 ASPNETCORE_ENVIRONMENT 为 Production 时关闭 swagger. 但是往往我们需要将 API 发布到本地 iis 调试或供他人使用时, swagger 将会被禁止. 发布后项目往往默认为 Production 环境, 将其修改为 Development 即可解决.

解决方法

打开发布到 iis 的文件夹下的 web.config 文件, 添加以下代码:

<environmentVariables>
<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
</environmentVariables>

修改后的 Web.config 结构大致如下:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
<location path="." inheritInChildApplications="false">
<system.webServer>
<handlers>
<add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
</handlers>
<aspNetCore processPath="dotnet" arguments="*.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="InProcess">
<environmentVariables>
<environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
</environmentVariables>
</aspNetCore>
</system.webServer>
</location>
</configuration>
<!--ProjectGuid: 15af0485-b65a-422a-bf12-5877b85abb6c-->