Xamarin Forms连接WiFi但无实际互联网的状态检测问题如何解决

原生能力的必要性说明 #

Xamarin Essentials的Connectivity API本身仅能检测设备是否接入了网络层（比如WiFi/蜂窝已连接），无法判断上层网络是否有实际互联网访问权限、或者你的自有API是否可达。Android和iOS原生确实提供了连通性校验的相关接口，但无需单独编写原生适配代码，跨平台实现的效果完全一致，改造成本更低。

核心检测逻辑实现 #

你需要的是和自有API的连通性校验，最准确的方案是向你的API服务端部署一个轻量健康检查接口（无业务逻辑，仅返回200状态码即可），通过HTTP请求的响应结果判断连通性。
实现一个全局单例的网络检测服务示例：

public class NetworkCheckService
{
    private static NetworkCheckService _instance;
    public static NetworkCheckService Instance => _instance ??= new NetworkCheckService();
    
    // 缓存检测结果，避免频繁请求
    private bool _lastCheckResult;
    private DateTime _lastCheckTime;
    private const int CacheValidSeconds = 30;
    private const string HealthCheckUrl = "你的API健康检查接口地址";

    private NetworkCheckService()
    {
        // 监听Essentials的网络连接变化事件，连接变化时自动触发校验
        Connectivity.ConnectivityChanged += async (s, e) =>
        {
            await CheckApiConnectivityAsync(true);
        };
    }

    public async Task<bool> CheckApiConnectivityAsync(bool bypassCache = false)
    {
        // 无任何网络连接直接返回false
        if (Connectivity.NetworkAccess != NetworkAccess.Internet)
        {
            NotifyStateChanged(false);
            return false;
        }
        
        // 缓存有效时直接返回上次结果
        if (!bypassCache && (DateTime.Now - _lastCheckTime).TotalSeconds < CacheValidSeconds)
        {
            return _lastCheckResult;
        }

        try
        {
            using var client = new HttpClient();
            client.Timeout = TimeSpan.FromSeconds(3);
            // 用HEAD请求减少流量消耗
            var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Head, HealthCheckUrl));
            _lastCheckResult = response.IsSuccessStatusCode;
        }
        catch
        {
            _lastCheckResult = false;
        }
        finally
        {
            _lastCheckTime = DateTime.Now;
            NotifyStateChanged(_lastCheckResult);
        }

        return _lastCheckResult;
    }

    // 状态变更通知
    private void NotifyStateChanged(bool isAvailable)
    {
        // 用Xamarin Forms自带的MessagingCenter广播状态
        MessagingCenter.Send(this, "ApiConnectivityChanged", isAvailable);
    }
}

应用内状态监听使用示例 #

页面响应状态变更 #

在需要响应网络状态的页面订阅广播即可：

public partial class YourPage : ContentPage
{
    public YourPage()
    {
        InitializeComponent();
        // 订阅网络状态变更
        MessagingCenter.Subscribe<NetworkCheckService, bool>(this, "ApiConnectivityChanged", (sender, isAvailable) =>
        {
            // 比如控制提交按钮的可用状态
            SubmitButton.IsEnabled = isAvailable;
            if (!isAvailable)
            {
                // 显示无网络提示
                NetworkTip.IsVisible = true;
            }
        });
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        // 页面销毁时取消订阅，避免内存泄漏
        MessagingCenter.Unsubscribe<NetworkCheckService, bool>(this, "ApiConnectivityChanged");
    }

    private async void SubmitButton_Clicked(object sender, EventArgs e)
    {
        // 操作触发前二次校验，避免缓存时间内网络状态变化
        var isConnected = await NetworkCheckService.Instance.CheckApiConnectivityAsync();
        if (!isConnected)
        {
            DisplayAlert("提示", "当前网络不可用，请检查网络设置后重试", "确定");
            return;
        }
        // 执行你的API调用逻辑
    }
}

注意事项 #

• 不要使用ICMP Ping实现检测，Android 10+和iOS新版本对ICMP协议有限制，容易出现误判
• 健康检查接口尽量轻量化，不要携带业务逻辑，减少请求耗时
• 超时时间建议设置在3~5秒，避免用户操作时等待过久
• 如果没有单独的健康检查接口，也可以用现有业务接口的HEAD请求替代，只要服务端支持HEAD请求即可

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