.NET 7 中 Linux 平台 Ping 自定义负载的变更解析

.NET 7 中 Linux 平台 Ping 自定义负载的变更解析

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

背景介绍

在 Linux 系统中，网络诊断工具 ping 是一个常用的网络连通性测试工具。在 .NET 中，System.Net.NetworkInformation.Ping 类提供了发送 ICMP 回显请求（即 ping 请求）的功能。然而，在 Linux 平台上，这个类的实现与 Windows 平台有着本质区别。

技术细节

Linux 平台的限制

在 Linux 系统中，非特权进程（non-privileged processes）无法直接发送原始 IP 数据包。.NET 的 Ping 类在 Linux 上的实现实际上是调用系统自带的 ping 命令行工具。但这里存在一个关键限制：Linux 的 ping 工具不支持为 ICMP 数据包指定自定义负载（payload）。

.NET 7 的变更

在 .NET 7 之前，当开发者在 Linux 平台上使用 Ping 类并指定自定义负载时，系统会静默忽略这个负载，而不会发送任何错误或警告。这种静默失败的行为可能导致开发者难以发现程序实际运行与预期不符。

从 .NET 7 开始，当非特权 Linux 进程尝试发送带有自定义负载的 ping 请求时，系统会抛出 PlatformNotSupportedException 异常，明确告知开发者该操作不被支持。

变更影响

受影响版本

• 仅影响 .NET 7 及以上版本
• 不影响 Windows 平台
• 不影响特权 Linux 进程

兼容性类型

此变更属于二进制兼容性变更，可能影响已编译程序的行为。

解决方案

方案一：提升权限

如果需要发送自定义负载的 ping 请求，可以选择：

1. 以 root 用户身份运行应用程序
2. 使用 setcap 工具授予 cap_net_raw 能力：

   sudo setcap cap_net_raw+ep /path/to/your/application
   

方案二：调整代码

如果不需要自定义负载，可以：

1. 使用不接受自定义负载的 SendPingAsync 重载方法
2. 传入空字节数组作为负载

最佳实践

1. 跨平台开发：如果代码需要在多个平台上运行，应当添加平台检测逻辑：

   if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux) && !IsPrivileged())
   {
       // 使用无负载的 ping 方法
   }
   else
   {
       // 使用带负载的 ping 方法
   }
   

2. 错误处理：在调用可能抛出异常的 ping 方法时，应当捕获 PlatformNotSupportedException：

   try
   {
       var reply = await ping.SendPingAsync(target, timeout, buffer);
   }
   catch (PlatformNotSupportedException ex)
   {
       // 处理不支持的情况
   }
   

3. 功能检测：在应用程序启动时检测 ping 功能是否可用，避免运行时才发现问题。

总结

.NET 7 对 Linux 平台上 Ping 类的自定义负载处理进行了改进，从静默忽略变为明确抛出异常。这种变更虽然可能影响现有代码，但能帮助开发者更快地发现问题。开发者应当根据实际需求选择适当的解决方案，并在跨平台应用中做好兼容性处理。

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