MailKit 2.2.0版本UNC路径空格编码问题及解决方案咨询

问题梳理 #

当前使用MailKit/MimeKit 2.2.0版本，遇到两个相关问题：

• Outlook Web (OWA) 解析UNC路径异常：原始UNC路径\\filesrv\Areas Public\Test\Test.txt作为超链接时，悬停显示file:///Areas Public/Test/Test.txt（缺失服务器名filesrv），右键复制链接为file:///Areas%20Public/Test/Test.txt（既缺失服务器名，空格又被URL编码）。
• MailKit返回的TextBody中URL空格被编码：调用IMailFolder.GetMessage(id)后，返回的TextBody包含file://filesrv/Areas%20Public/Test/Test.txt，路径中的空格被自动编码为%20。

解决方案 #

1. Outlook Web的服务器名缺失问题 #

这是OWA自身的UNC路径解析逻辑导致的，与MailKit无关，无法通过MailKit配置修正。可以尝试以下优化：

• 发送邮件时，将UNC路径转换为标准的file:////格式（注意四个斜杠）：file:////filesrv/Areas Public/Test/Test.txt，部分版本的OWA能正确识别这种格式并保留服务器名。
• 若上述方法无效，只能告知用户手动补充服务器名，或通过客户端工具直接打开原始UNC路径。

2. MailKit的URL空格编码问题 #

在2.2.0版本中，MailKit对URL中的空格进行%20编码是符合URL规范（RFC标准）的默认行为，没有内置配置项可以关闭该编码。如果业务需要保留原始空格，只能在获取TextBody后做字符串替换处理：

var message = folder.GetMessage(id);
var processedTextBody = message.TextBody.Replace("%20", " ");

3. 版本升级建议 #

2.2.0是较旧的版本，后续MailKit/MimeKit版本可能对URL处理逻辑有优化，但目前没有明确的官方记录表明针对该场景做了修复。如果条件允许，可以升级到最新稳定版后测试，但升级前需评估现有代码的兼容性风险。

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