MAUI.NET iOS端WebView遇无效SSL证书黑屏问题求助

你的问题根源是iOS的WKWebView不会遵循ServicePointManager.ServerCertificateValidationCallback的设置，需要针对WKWebView单独配置证书信任逻辑。以下是具体解决步骤：

1. 实现自定义WKNavigationDelegate #

在iOS项目中创建一个自定义导航委托类，处理证书验证：

using Foundation;
using WebKit;

namespace YourAppNamespace.iOS;

public class UnsafeWebViewNavigationDelegate : WKNavigationDelegate
{
    // 信任所有SSL证书（仅测试环境使用）
    public override void DidReceiveAuthenticationChallenge(WKWebView webView, NSUrlAuthenticationChallenge challenge, Action<NSUrlAuthChallengeDisposition, NSUrlCredential> completionHandler)
    {
        if (challenge.ProtectionSpace.AuthenticationMethod == NSUrlProtectionSpace.AuthenticationMethodServerTrust)
        {
            var credential = NSUrlCredential.FromTrust(challenge.ProtectionSpace.ServerTrust);
            completionHandler(NSUrlAuthChallengeDisposition.UseCredential, credential);
            return;
        }

        // 其他认证场景按默认逻辑处理
        completionHandler(NSUrlAuthChallengeDisposition.PerformDefaultHandling, null);
    }

    // 可选：捕获加载错误，排查黑屏原因
    public override void DidFailProvisionalNavigation(WKWebView webView, WKNavigation navigation, NSError error)
    {
        Console.WriteLine($"WebView加载错误: {error.LocalizedDescription}");
    }
}

2. 配置WebView Handler替换导航委托 #

在iOS项目的AppDelegate中，为WebView注册自定义Handler，替换默认的导航委托：

using Microsoft.Maui.Handlers;
using WebKit;

public class AppDelegate : MauiUIApplicationDelegate
{
    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    public override bool FinishedLaunching(UIApplication app, NSDictionary options)
    {
        // 注册WebView自定义Handler
        WebViewHandler.Mapper.AppendToMapping("UnsafeSSL", (handler, view) =>
        {
            if (handler.PlatformView is WKWebView wkWebView)
            {
                wkWebView.NavigationDelegate = new UnsafeWebViewNavigationDelegate();
            }
        });

        return base.FinishedLaunching(app, options);
    }
}

3. 验证ATS配置（你已完成，可忽略） #

你已在Info.plist中添加NSAllowsArbitraryLoads，确保配置正确即可：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

重要注意事项 #

• 切勿在生产环境使用此方案：信任所有证书会带来严重安全风险，生产环境必须使用受信任的SSL证书，或针对特定域名配置NSExceptionDomains来信任指定证书。
• 若仍黑屏，通过DidFailProvisionalNavigation输出的错误日志排查问题，比如域名解析失败、网络连接问题等。

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