第十一章 配置 IIS 以与 Web 网关配合使用 (Windows) – 配置 IIS 返回 SOAP 故障详细信息

第十一章 配置 IIS 以与 Web 网关配合使用 (Windows) – 配置 IIS 返回 SOAP 故障详细信息

配置 IIS 返回 SOAP 故障详细信息

遇到错误的 IRIS Web 服务可能会返回 HTTP 500 错误，但不包含关联的 SOAP 错误详细信息。默认情况下，IIS 仅向本地客户端返回扩展错误信息。但是，可以在配置文件 web.config 内的 <httpErrors> 元素中修改此行为。为此，请添加以下部分以指示 IIS 向所有客户端分派详细的错误信息。

<configuration>
    <system.webServer>
       <httpErrors errorMode="Detailed" />
    </system.webServer>
</configuration>

请谨慎使用此方法，因为有关托管环境的敏感信息可能会泄露给客户端。避免使用 errorMode="Detailed" 带来的安全问题的另一种方法是使用existingResponse="PassThrough"指令。

<configuration>
    <system.webServer>
       <httpErrors existingResponse="PassThrough" />
    </system.webServer>
</configuration>

更改配置后重新启动 IIS。

可以手动对 IIS web.config 文件进行这些更改。或者，为了获得更好、不易出错的方法，请使用 IIS 管理器中内置的配置编辑器。

1. 在 IIS 管理器中，从左侧的“连接”面板中，选择与 Web 服务对应的路径。例如：默认网站，然后是 csp。
2. 在中间面板底部“管理”标题下方，双击“配置编辑器”。
3. 在顶部标有“部分”的配置编辑器下拉列表中，展开 system.webServer 并单击 httpErrors。
4. 单击“existingResponse”旁边的值并使用下拉列表查看选项。选择直通。
5. 在右侧的操作窗格中，单击应用。
6. 更改配置后重新启动 IIS。

有关 IIS 中错误处理的更多信息，请访问：

https://docs.microsoft.com/en-us/iis/configuration/system.webServer/httpErrors/