ASPX页面自定义404页面无法正常显示问题求助

我之前帮不少开发者解决过这个IIS + ASP.NET的404自定义页面冲突问题，你的情况其实是因为ASPX页面同时受IIS原生错误处理和.NET框架的错误处理双重管控导致的，下面给你一套完整的解决方法：

1. 调整web.config中的错误处理配置 #

需要同时配置IIS层面的httpErrors和.NET框架层面的customErrors，确保两者协同工作，避免冲突：

<!-- IIS 服务器级别的错误配置 -->
<system.webServer>
  <httpErrors errorMode="Custom" existingResponse="Replace">
    <!-- 先移除默认的404错误配置 -->
    <remove statusCode="404" subStatusCode="-1" />
    <!-- 指定自定义404页面，使用ExecuteURL模式让.NET处理ASPX页面 -->
    <error statusCode="404" path="/custom404.aspx" responseMode="ExecuteURL" />
  </httpErrors>
</system.webServer>

<!-- .NET 框架级别的错误配置 -->
<system.web>
  <customErrors mode="On" defaultRedirect="/custom404.aspx">
    <!-- 针对404错误单独指定跳转页面 -->
    <error statusCode="404" redirect="/custom404.aspx" />
  </customErrors>
</system.web>

重点说明：existingResponse="Replace"是告诉IIS完全替换原生错误响应；responseMode="ExecuteURL"是让IIS执行你的自定义ASPX页面（而非直接返回静态文件），这是ASPX页面能正常加载的关键。

2. 在自定义404.aspx页面中清除服务器错误 #

这一步是解决“默认内容显示在自定义页面上方”的核心！当ASPX页面触发404时，.NET框架已经在后台生成了默认错误内容并写入输出流，所以需要在自定义页面的代码中主动清除这些内容：

protected void Page_Load(object sender, EventArgs e)
{
    // 清除服务器端已生成的错误信息，避免默认内容输出
    Server.ClearError();
    // 保持响应状态码为404（对SEO友好，可选但推荐）
    Response.StatusCode = 404;
    Response.StatusDescription = "Not Found";
}

3. 验证IIS站点的错误页设置（可选） #

如果上述配置仍未生效，检查IIS管理器中你的站点的“错误页”设置：

• 找到404错误条目，右键选择「编辑」
• 确保选择的是「执行URL」，并且路径填写自定义404.aspx的绝对路径（如/custom404.aspx）
• 不要选择「文件」或「重定向」模式，这两种模式会导致ASPX页面无法被.NET正确处理

完成以上配置后，ASPX页面触发404错误时，就只会显示你的自定义404页面，不会再出现服务器默认的错误内容了。

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