WinSCP .NET组件目录列表超时问题及超时设置差异咨询

问题背景 #

当远程目录存在大量文件时，调用代码var allFiles = session.EnumerateRemoteFiles(folderIn, null, EnumerationOptions.None);频繁出现会话超时，错误日志如下：

Timeout waiting for WinSCP to respond
    at WinSCP.Session.CheckForTimeout(String additional)
    at WinSCP.PatientFileStream.Wait(Int32& interval)
    at WinSCP.PatientFileStream.Read(Byte[] array, Int32 offset, Int32 count)
    at System.Xml.XmlTextReaderImpl.ReadData()
    at System.Xml.XmlTextReaderImpl.ParseText(Int32& startPos, Int32& endPos, Int32& outOrChars)
    at System.Xml.XmlTextReaderImpl.ParseText()
    at System.Xml.XmlTextReaderImpl.ParseElementContent()
    at System.Xml.XmlTextReaderImpl.Read()
    at WinSCP.SessionLogReader.DoRead()
    at WinSCP.SessionLogReader.Read(LogReadFlags flags)
    at WinSCP.ElementLogReader.Read(LogReadFlags flags)
    at WinSCP.SessionElementLogReader.Read(LogReadFlags flags)
    at WinSCP.ElementLogReader.Read(LogReadFlags flags)
    at WinSCP.CustomLogReader.TryWaitForNonEmptyElement(String localName, LogReadFlags flags)
    at WinSCP.CustomLogReader.WaitForNonEmptyElement(String localName, LogReadFlags flags)
    at WinSCP.Session.ListDirectory(String path)
    at WinSCP.Session.<DoEnumerateRemoteFiles>d__86.MoveNext()

使用版本：WinSCP .NET assembly 6.1.2

问题解答 #

1. 默认会话超时时间及延长超时的副作用 #

• 默认超时时间：WinSCP .NET Assembly 6.1.2的默认会话超时为15秒。
• 延长超时的副作用：
  • 若远程服务端出现真实连接故障，程序需等待更长时间才会触发错误，降低故障响应效率。
  • 当远程服务无响应时，客户端线程会被长时间阻塞，影响程序整体并发能力与响应速度。
  • 在网络不稳定的批量操作场景中，无效等待时间被拉长，会增加整体流程耗时。

2. 两种超时设置方式的区别 #

方式1：在SessionOptions中设置Timeout后打开会话

var sessionOptions = new SessionOptions
{ Timeout = new TimeSpan(0, 2, 0) };

• 属于会话的初始全局配置，作用于整个会话生命周期，包括连接建立、身份认证、后续所有文件操作（枚举、传输等）。
• 打开会话后，若未手动修改session.Timeout，此值会一直作为会话默认超时生效。

方式2：打开会话后设置session.Timeout

session.Timeout = new TimeSpan(0, 2, 0);

• 仅对设置完成之后执行的操作生效，不会影响已完成的连接、认证等步骤。
• 支持会话过程中动态调整超时，比如针对枚举大量文件这类高耗时操作临时调大超时，操作完成后再恢复原有值，灵活性更高。

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