如何在IIS中拦截SharePoint错误消息并配置自定义错误页面？

由于SharePoint在返回错误内容时仍返回200 OK状态码，常规IIS基于状态码的错误页配置无法生效。以下是几种可行的解决方案，均能满足URL保持不变、替换为自定义错误页面的要求：

方案一：使用IIS URL Rewrite模块（推荐） #

这是最简便的方案，无需编写代码，仅需通过配置实现：

1. 确保已安装IIS URL Rewrite模块（可通过IIS管理器的“模块”功能确认，未安装则需从微软官方下载安装）
2. 打开站点的web.config文件，在<system.webServer>节点下添加以下出站重写规则：

<rewrite>
  <outboundRules>
    <rule name="Intercept SharePoint 200 Errors" stopProcessing="true">
      <!-- 匹配SharePoint错误页的特征文本或HTML标记，可根据实际情况调整 -->
      <match filterByTags="None" pattern="抱歉，出错了|ms-error-page" />
      <!-- 替换为你的自定义错误页面路径 -->
      <action type="Rewrite" value="/custom-error-page.html" />
    </rule>
  </outboundRules>
</rewrite>

3. 保存配置后，IIS会自动加载规则。当SharePoint返回包含指定特征的200响应时，会被重写为自定义错误页面，URL保持不变。

提示：如果SharePoint错误页有更独特的标识（比如特定的HTML类名或ID），可以把pattern改成更精准的匹配，避免误拦截正常页面。

方案二：自定义HttpModule（适合复杂场景） #

如果需要更灵活的检测逻辑（比如根据错误类型返回不同的自定义页面），可以编写自定义HttpModule：

1. 创建一个C#类库项目，实现IHttpModule接口：

using System;
using System.IO;
using System.Web;

namespace SharePointErrorHandling
{
    public class ErrorInterceptorModule : IHttpModule
    {
        public void Init(HttpApplication context)
        {
            context.EndRequest += Context_EndRequest;
        }

        private void Context_EndRequest(object sender, EventArgs e)
        {
            var app = (HttpApplication)sender;
            var response = app.Response;

            // 仅处理200状态的响应
            if (response.StatusCode != 200) return;

            // 读取响应内容
            response.Filter = new ResponseFilterStream(response.Filter, app.Server);
        }

        public void Dispose() { }
    }

    public class ResponseFilterStream : Stream
    {
        private readonly Stream _originalStream;
        private readonly HttpServerUtility _server;
        private readonly MemoryStream _cacheStream = new MemoryStream();

        public ResponseFilterStream(Stream originalStream, HttpServerUtility server)
        {
            _originalStream = originalStream;
            _server = server;
        }

        public override void Write(byte[] buffer, int offset, int count)
        {
            _cacheStream.Write(buffer, offset, count);
        }

        public override void Close()
        {
            // 读取缓存的响应内容
            _cacheStream.Position = 0;
            var responseContent = new StreamReader(_cacheStream).ReadToEnd();

            // 检测是否为SharePoint错误页
            if (responseContent.Contains("抱歉，出错了") || responseContent.Contains("ms-error-page"))
            {
                // 清空原有响应，输出自定义错误页面
                var customPagePath = _server.MapPath("/custom-error-page.html");
                var customContent = File.ReadAllText(customPagePath);
                var customBuffer = System.Text.Encoding.UTF8.GetBytes(customContent);
                _originalStream.Write(customBuffer, 0, customBuffer.Length);
            }
            else
            {
                // 正常响应，输出原内容
                _cacheStream.Position = 0;
                _cacheStream.CopyTo(_originalStream);
            }

            _cacheStream.Close();
            _originalStream.Close();
        }

        // 实现Stream的其他抽象方法
        public override bool CanRead => _originalStream.CanRead;
        public override bool CanSeek => _originalStream.CanSeek;
        public override bool CanWrite => _originalStream.CanWrite;
        public override long Length => _originalStream.Length;
        public override long Position { get => _originalStream.Position; set => _originalStream.Position = value; }
        public override void Flush() => _originalStream.Flush();
        public override int Read(byte[] buffer, int offset, int count) => _originalStream.Read(buffer, offset, count);
        public override long Seek(long offset, SeekOrigin origin) => _originalStream.Seek(offset, origin);
        public override void SetLength(long value) => _originalStream.SetLength(value);
    }
}

2. 将编译后的DLL部署到站点的bin目录
3. 在站点的web.config中注册模块：

<system.webServer>
  <modules>
    <add name="ErrorInterceptorModule" type="SharePointErrorHandling.ErrorInterceptorModule" />
  </modules>
</system.webServer>

4. 重启IIS站点，模块会自动拦截符合条件的响应并替换为自定义页面。

方案三：结合SharePoint自身错误设置（补充） #

对于部分SharePoint原生错误，可以通过管理中心配置自定义错误页：

1. 打开SharePoint管理中心，进入应用程序管理 -> 管理Web应用程序
2. 选中目标Web应用程序，点击功能区的常规设置
3. 在“错误消息”区域，选择“自定义错误消息”，并指定自定义错误页面的URL
4. 保存设置后，部分SharePoint错误会直接跳转到指定页面，但此方法无法覆盖所有200状态的错误（如你遇到的文件名非法场景），建议结合方案一使用。

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