WCF RESTful API大文件下载远程中断问题排查求助

问题描述 #

基于WCF Service开发的RESTful API，采用流方式实现文件下载功能。本地环境可正常下载600MB的完整文件，但通过远程浏览器访问URL下载时，会在10MB、20MB、50MB或126MB左右中途停止，一段时间后抛出网络错误，异常信息为：信号量超时时间已过期。

代码问题与修复建议 #

1. 超时配置不足 #

当前代码中ReceiveTimeout仅设置为1分钟，远程下载大文件时，请求接收过程很容易超过这个阈值触发超时；同时默认的OperationTimeout（控制单个操作的执行时长）也是1分钟，同样会限制大文件的下载流程。

修改服务初始化代码中的绑定配置：

Dim _Binding As New WebHttpBinding With {
    .Name = "IService",
    .MaxBufferSize = 2147483647,
    .MaxBufferPoolSize = 2147483647,
    .MaxReceivedMessageSize = 2147483647,
    .TransferMode = TransferMode.Streamed,
    .ReceiveTimeout = New TimeSpan(0, 30, 0), ' 延长至30分钟
    .SendTimeout = New TimeSpan(0, 30, 0), ' 延长至30分钟
    .OpenTimeout = New TimeSpan(0, 5, 0), ' 新增服务打开超时配置
    .CloseTimeout = New TimeSpan(0, 5, 0), ' 新增服务关闭超时配置
    .OperationTimeout = New TimeSpan(0, 30, 0) ' 新增操作超时，控制单请求执行时长
}

2. OPTIONS请求处理逻辑冗余 #

当前代码在处理OPTIONS请求时，添加CORS头后仍会继续执行后续文件检查逻辑，既浪费资源也可能引发不必要的错误。应在检测到OPTIONS请求时直接返回响应，终止后续流程。

修改请求处理类中的FileDownloadRequest方法：

Private Function FileDownloadRequest(Param As String) As Stream Implements IService.FileDownloadRequest
    Dim _FileName As String = RootFolder & "\" & Param
    Try
        ReqLogs.Add("<<-- Download request recieved for " & _FileName)
        ' Header Set For CORS
        WebOperationContext.Current.OutgoingResponse.Headers.Add("Access-Control-Allow-Origin", "*")
        If (WebOperationContext.Current.IncomingRequest.Method = "OPTIONS") Then
            WebOperationContext.Current.OutgoingResponse.Headers.Add("Access-Control-Allow-Methods", "*")
            WebOperationContext.Current.OutgoingResponse.Headers.Add("Access-Control-Allow-Headers", "*, Content-Type, Accept")
            WebOperationContext.Current.OutgoingResponse.Headers.Add("Access-Control-Max-Age", "1728000")
            WebOperationContext.Current.OutgoingResponse.StatusCode = Net.HttpStatusCode.OK
            Return Nothing ' 直接返回，终止后续逻辑
        End If
        ' 后续文件下载逻辑保持不变
        ...

3. 缺少服务节流配置 #

当存在多个并发下载请求时，默认的WCF节流设置可能导致资源耗尽，间接引发超时。需显式添加服务节流行为，调整并发限制。

在服务初始化代码中添加节流配置：

' 在添加ServiceMetadataBehavior之后添加
Dim throttlingBehavior As New ServiceThrottlingBehavior With {
    .MaxConcurrentCalls = 100, ' 根据服务器硬件资源调整
    .MaxConcurrentInstances = 100,
    .MaxConcurrentSessions = 100
}
_WcfServer.Description.Behaviors.Add(throttlingBehavior)

4. 确认Content-Length设置正确性 #

当前代码中已设置ContentLength为文件流长度，这是正确的配置，能确保客户端预知文件大小，避免因未知长度导致的连接中断。

额外排查点 #

• 检查远程网络环境：防火墙、代理服务器是否存在下载时长或流量限制，这类设备的超时设置也可能导致下载中途停止。
• 验证服务器磁盘性能：如果服务器磁盘读取速度过慢，也可能引发流传输超时。

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