.NET 8 中 URI 比较行为的重大变更：mailto: 协议现在会比对用户信息

.NET 8 中 URI 比较行为的重大变更：mailto: 协议现在会比对用户信息

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

在 .NET 8 中，URI 比较的行为发生了一个重要变化，特别是针对 mailto: 协议的 URI。这个变更影响了 Uri.Equals 方法和 == 操作符的行为，使得它们在比较 mailto: URI 时会考虑用户信息部分。本文将详细解释这个变更的背景、影响以及开发者应该如何应对。

变更背景

什么是 URI 用户信息

在 URI 结构中，用户信息（User Info）通常出现在授权部分，格式为 username:password@host。例如：

• https://admin:123456@example.com
• mailto:user@example.com

历史行为问题

在 .NET 7 及更早版本中，Uri 类在比较两个 URI 是否相等时，会忽略用户信息部分。这种设计对于大多数 URI 协议（如 HTTP）可能是合理的，但对于 mailto: 协议则显得不合逻辑。

考虑以下示例：

Uri uri1 = new Uri("mailto:alice@example.com");
Uri uri2 = new Uri("mailto:bob@example.com");
Console.WriteLine(uri1 == uri2); // 在.NET 7中输出True

显然，发送给 alice 和 bob 的邮件是不同的，但旧版本的比较结果却认为它们是相同的 URI，这与开发者的直觉相违背。

变更内容

新行为

从 .NET 8 开始，mailto: URI 的比较会考虑用户信息部分：

Uri uri1 = new Uri("mailto:alice@example.com");
Uri uri2 = new Uri("mailto:bob@example.com");
Console.WriteLine(uri1 == uri2); // 在.NET 8中输出False

其他协议不受影响

需要注意的是，这个变更仅影响 mailto: 协议。对于其他协议（如 HTTP/HTTPS），比较行为保持不变：

Uri uri1 = new Uri("https://user1@example.com");
Uri uri2 = new Uri("https://user2@example.com");
Console.WriteLine(uri1 == uri2); // 仍然输出True

影响范围

受影响的 API

这个变更影响了以下 API 的行为：

• Uri.Equals(Uri)
• Uri.Equals(Object)
• Uri.== 操作符

版本信息

此变更首次出现在 .NET 8 中，属于行为变更（Behavioral Change）类别。

迁移建议

需要保留旧行为的场景

如果你的代码依赖于旧的比较行为（即忽略用户信息），可以改为显式比较 URI 的主机部分：

Uri uri1 = new Uri("mailto:alice@example.com");
Uri uri2 = new Uri("mailto:bob@example.com");
bool areEqual = uri1.Host == uri2.Host; // 只比较主机部分

代码审查建议

建议检查代码中所有涉及 mailto: URI 比较的地方，确认新的比较行为是否符合预期。特别注意以下场景：

• 邮件地址白名单/黑名单检查
• 邮件发送逻辑中的条件判断
• URI 缓存或字典中的键比较

技术原理

为什么只修改 mailto: 协议

mailto: URI 的特殊性在于：

1. 用户信息部分（即邮件地址）是 URI 的核心标识
2. 不同收件人意味着完全不同的通信目标
3. 在邮件系统中，alice@ 和 bob@ 显然是不同的实体

相比之下，HTTP URI 的用户信息通常只是认证凭据，不影响资源标识。

一致性考虑

这一变更使 .NET 的行为更符合 RFC 6068（mailto URI 规范）的精神，其中明确指出 mailto URI 的主要目的是标识电子邮件收件人。

总结

.NET 8 对 mailto: URI 比较行为的修改是一个合理的改进，使框架行为更符合开发者直觉。虽然这是一个破坏性变更，但它修复了一个长期存在的不一致问题。开发者应检查受影响代码，必要时调整比较逻辑，以确保应用程序在升级后仍能按预期工作。

对于需要同时支持新旧版本的代码，可以考虑使用条件编译或运行时版本检查来实现兼容性处理。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs