.NET MAUI Android端WebView加载空白问题求助

针对Android端WebView加载HTTP协议的aspx跳转PDF页面空白，而Windows和浏览器正常的问题，以下是针对性的排查和解决步骤：

• 解除Android明文HTTP限制
  Android 9及以上版本默认禁止明文HTTP请求，这是此类空白问题的常见诱因。可通过两种方式处理：

  1. 直接在Platforms/Android/AndroidManifest.xml的<application>标签中添加：

     android:usesCleartextTraffic="true"
     

  2. 更安全的域名白名单方式：创建Platforms/Android/res/xml/network_security_config.xml文件，内容如下：

     <?xml version="1.0" encoding="utf-8"?>
     <network-security-config>
         <domain-config cleartextTrafficPermitted="true">
             <domain includeSubdomains="true">你的aspx域名</domain>
             <domain includeSubdomains="true">重定向后的PDF域名</domain>
         </domain-config>
     </network-security-config>
     

     然后在AndroidManifest.xml的<application>标签引用该配置：

     android:networkSecurityConfig="@xml/network_security_config"
     

• 启用WebView的PDF渲染及核心设置
  Android系统WebView默认可能未开启PDF渲染支持，需手动配置原生WebView参数：

  #if ANDROID
  var nativeWebView = webView.Handler.PlatformView as Android.Webkit.WebView;
  var settings = nativeWebView.Settings;
  settings.JavaScriptEnabled = true;
  settings.AllowFileAccess = true;
  settings.SetSupportZoom(true);
  settings.BuiltInZoomControls = true;
  settings.DisplayZoomControls = false;
  // 启用插件支持（适配旧版WebView的PDF渲染逻辑）
  settings.SetPluginState(Android.Webkit.WebSettings.PluginState.On);
  // 允许跨域文件访问
  settings.SetAllowFileAccessFromFileURLs(true);
  settings.SetAllowUniversalAccessFromFileURLs(true);
  #endif
  

• 自定义WebViewClient处理重定向逻辑
  手动接管重定向流程，确保跳转后的PDF URL被正确加载：

  #if ANDROID
  var nativeWebView = webView.Handler.PlatformView as Android.Webkit.WebView;
  nativeWebView.SetWebViewClient(new CustomWebViewClient());
  #endif
  
  public class CustomWebViewClient : Android.Webkit.WebViewClient
  {
      public override bool ShouldOverrideUrlLoading(Android.Webkit.WebView view, Android.Webkit.IWebResourceRequest request)
      {
          view.LoadUrl(request.Url.ToString());
          return true;
      }
  
      // 捕获加载错误，便于排查问题根源
      public override void OnReceivedError(Android.Webkit.WebView view, Android.Webkit.IWebResourceRequest request, Android.Webkit.WebResourceError error)
      {
          base.OnReceivedError(view, request, error);
          Console.WriteLine($"WebView加载错误: {error.Description}");
      }
  }
  

• 排查PDF直接加载有效性
  跳过aspx重定向，直接将WebView的Source设置为最终的PDF URL：

  • 如果仍然空白，说明是Android WebView的PDF渲染问题，可先尝试更新设备的「Android System WebView」到最新版本；
  • 若系统WebView确实不支持内嵌PDF渲染，可通过Intent调用系统PDF阅读器打开链接：

    #if ANDROID
    var pdfUrl = "你的PDF地址";
    var intent = new Android.Content.Intent(Android.Content.Intent.ActionView);
    intent.SetDataAndType(Android.Net.Uri.Parse(pdfUrl), "application/pdf");
    intent.SetFlags(Android.Content.ActivityFlags.ClearWhenTaskReset | Android.Content.ActivityFlags.NewTask);
    Android.App.Application.Context.StartActivity(intent);
    #endif
    

• 添加导航日志定位问题
  给WebView绑定导航事件日志，明确失败环节：

  webView.Navigating += (s, e) => Console.WriteLine($"导航中: {e.Url}");
  webView.Navigated += (s, e) => Console.WriteLine($"导航完成: {e.Url}");
  webView.NavigationFailed += (s, e) => Console.WriteLine($"导航失败: {e.Exception.Message}");
  

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