ASP.NET在IIS 10上自定义错误配置失效问题求助

针对你线上IIS 10部署ASP.NET 4.5.2项目后，自定义错误配置未生效的问题，结合本地正常、线上失效的场景，可按以下步骤排查修复：

1. 调整web.config的httpErrors配置（核心修复） #

IIS的httpErrors优先级高于ASP.NET的customErrors，需确保覆盖所有需要捕获的错误状态码，并添加关键属性：

<system.webServer>
    <httpErrors errorMode="Custom" existingResponse="Replace">
        <!-- 移除默认错误配置 -->
        <remove statusCode="400" subStatusCode="-1" />
        <remove statusCode="404" subStatusCode="-1" />
        <remove statusCode="500" subStatusCode="-1" />
        <!-- 配置各状态码的自定义错误页 -->
        <error statusCode="400" prefixLanguageFilePath="" path="/Errors/Error.aspx?type=400&amp;Language=FA" responseMode="ExecuteURL" />
        <error statusCode="404" prefixLanguageFilePath="" path="/Errors/Error.aspx?type=404&amp;Language=FA" responseMode="ExecuteURL" />
        <error statusCode="500" prefixLanguageFilePath="" path="/Errors/Error.aspx?type=500&amp;Language=FA" responseMode="ExecuteURL" />
        <!-- 按需添加其他状态码，如403、401等 -->
    </httpErrors>
    <staticContent>
        <mimeMap fileExtension=".webp" mimeType="image/webp" />
    </staticContent>
</system.webServer>

• 添加existingResponse="Replace"：强制IIS用自定义错误页替换原始错误响应，避免默认错误页覆盖配置。
• 补全所有需要处理的状态码：你当前只配置了400，需添加404、500等核心错误码。

2. 修正线上环境的调试模式 #

线上必须关闭调试模式，否则ASP.NET会忽略customErrors设置，优先显示详细错误：

<system.web>
    <compilation debug="false" targetFramework="4.5.2" />
    <!-- 其余配置保持不变 -->
</system.web>

3. 检查IIS站点的错误页全局设置 #

1. 打开IIS管理器，找到目标站点，点击「错误页」。
2. 右侧点击「编辑功能设置」，选择「自定义错误页」（不要选「本地请求显示详细错误，远程请求显示自定义错误」），确保线上所有请求都触发自定义页。
3. 检查是否存在站点级别的错误页配置覆盖了web.config的设置，如有则删除或统一配置。

4. 验证自定义错误页的可用性 #

直接访问线上地址/Errors/Error.aspx?type=404&Language=FA，确认页面能正常加载：

• 若页面无法打开，排查是否存在权限问题（应用程序池身份需对Errors目录有读取权限）。
• 检查页面本身是否有编译错误或依赖缺失，避免错误页自身出错导致IIS fallback到默认页。

5. 排查URL重写规则（如有） #

如果站点配置了URL重写，需确保规则未拦截错误页的请求：

• 在重写规则中添加排除条件，忽略/Errors/路径的请求，例如：

<rule name="你的重写规则" stopProcessing="true">
    <match url="^(?!Errors/).*$" />
    <!-- 其余规则配置 -->
</rule>

6. 测试不同类型的错误 #

分别测试以下场景，验证自定义错误是否生效：

• 访问不存在的静态文件（如/test.html），触发静态资源404。
• 访问不存在的ASP.NET页面（如/Test.aspx），触发ASP.NET处理的404。
• 在代码中故意抛出异常（如throw new Exception("Test 500")），触发500错误。

内容的提问来源于stack exchange，提问作者Mohadeseh