升级Chilkat至11.1.0后IMAP FetchHeaders调用失败求助

问题场景 #

原Chilkat 10.1.3版本下可正常运行的代码：

const bool fetchUids = true;
MessageSet mset = _imap.Search("ALL", fetchUids);
bundle = _imap.FetchHeaders(mset);

升级至Chilkat 11.1.0版本后，调用FetchHeaders返回失败，错误日志如下：

ChilkatLog:  
  FetchHeaders:  
    DllDate: Jul 27 2025  
    ChilkatVersion: 11.1.0
    UnlockPrefix: VVANTC
    UnlockStatus: 2
    Architecture: Little Endian; 32-bit
    Language: .NET 4.7 / x86
    VerboseLogging: 0
    fetchHeaders:
      messageCount: 0
      fetchMethod: Fetching headers by UID
      numFetchSets: 0
      processHeaders:
        numHeadersFetched: 0
      --processHeaders
      Failed.
    --fetchHeaders
    Failed.
  --FetchHeaders
--ChilkatLog

排查步骤 #

• 校验Search方法的返回结果
  在调用FetchHeaders前，检查mset的消息数量，比如输出mset.Count或mset.GetNumSets()的值。如果结果为0，说明Search("ALL")未从服务器获取到任何消息，问题根源在搜索环节而非FetchHeaders。

• 确认IMAP会话状态
  确保调用Search和FetchHeaders前，IMAP连接已完成登录，且通过SelectMailbox方法选中了目标邮箱。Chilkat 11.x对会话状态的校验更严格，若未选中邮箱或连接已断开，会导致后续操作失败。

• 测试非UID模式的兼容性
  将fetchUids改为false，使用消息序列号而非UID进行搜索和Fetch操作，验证是否能正常获取Headers。部分IMAP服务器对UID搜索的支持存在版本兼容性问题，此操作可排查是否为UID模式导致的异常。

• 开启详细日志定位问题
  将_imap.VerboseLogging设置为1，重新执行代码后查看完整交互日志，重点关注Search请求的服务器响应、FetchHeaders请求的发送内容及服务器返回结果，以此定位具体的通信异常点。

• 确认授权有效性
  虽然日志显示UnlockStatus: 2（授权有效），但仍需核对UnlockPrefix是否与当前Chilkat 11.1.0版本的授权信息匹配，避免因授权限制导致功能异常。

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