URI构造函数处理含特殊字符的mailto请求时错误编码问号问题

问题场景 #

当mailto链接的正文包含**弯引号（’）**这类特殊字符时，使用.NET的Uri类解析会出现参数错乱的问题，以下是具体测试案例：

测试1：含弯引号的无收件人mailto链接 #

string mailUrl1 = "mailto:?subject=Testing escape characters&body=It’s a good test\n\nFor Sure";

var shareUri1 = new Uri(
                mailUrl1,
                UriKind.Absolute);

解析结果：

mailto:%3Fsubject=Testing escape characters&body=It’s a good test%0A%0AFor Sure?subject=Testing escape characters&body=It’s a good test

For Sure

参数完全错乱：?被编码为%3F，参数部分被重复拼接。

测试2：含直引号的无收件人mailto链接 #

string mailUrl2 = "mailto:?subject=Testing escape characters&body=It's a good test\n\nFor Sure";

var shareUri2 = new Uri(
                mailUrl2,
                UriKind.Absolute);

解析结果：

mailto:?subject=Testing escape characters&body=It's a good test

For Sure

解析正常，参数未出现异常。

特殊现象 #

若mailto链接填写了收件人邮箱，即使包含弯引号，Uri类也能正确解析，例如：

mailto:stackoverflow@gmail.com?subject=Testing escape characters&body=It’s a good test

For Sure

问题解答 #

1. 现象原因 #

这是.NET的Uri类解析逻辑的一个特殊bug：

• 当处理无收件人的mailto链接（即mailto:?xxx格式）时，若参数中包含非ASCII的Unicode字符（如弯引号’），Uri会错误地将?之前的空收件人部分判定为完整的"scheme-specific part"，进而把?及后续内容当成查询参数之外的额外数据，最终导致编码混乱和参数重复。
• 当存在收件人邮箱时，Uri能正确识别?是查询参数的起始标记，因此解析正常；而直引号（'）属于ASCII字符，不会触发这个结构判断错误。

2. 正确生成Uri对象的方案 #

可以通过拆分mailto结构、单独编码参数后再组合的方式规避该问题，或者使用UriBuilder类构建：

方案1：手动编码参数后组合

string subject = "Testing escape characters";
string body = "It’s a good test\n\nFor Sure";

// 单独编码主题和正文（处理特殊字符）
string encodedSubject = Uri.EscapeDataString(subject);
string encodedBody = Uri.EscapeDataString(body);

// 组合为合法的mailto链接
string mailUrl = $"mailto:?subject={encodedSubject}&body={encodedBody}";

var shareUri = new Uri(mailUrl, UriKind.Absolute);

方案2：使用UriBuilder类

UriBuilder的参数处理逻辑更稳定，能自动处理结构和编码：

var builder = new UriBuilder("mailto:");
// 编码后拼接查询参数
builder.Query = $"subject={Uri.EscapeDataString(subject)}&body={Uri.EscapeDataString(body)}";

Uri shareUri = builder.Uri;

两种方案都能正确生成包含特殊字符的mailto URI，避免解析错乱问题。

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