MAUI应用iOS物理机WebView中iframe加载失败求助

以下是针对你遇到的问题的具体排查和解决步骤：

1. 检查并配置WKWebView核心参数 #

MAUI在iOS上基于WKWebView封装，物理机的安全限制比模拟器更严格，需要手动配置允许iframe加载的相关属性。在Platforms/iOS项目中实现自定义WebViewHandler：

using Microsoft.Maui.Handlers;
using WebKit;
using Foundation;

namespace YourAppName.Platforms.iOS;

public class CustomWebViewHandler : WebViewHandler
{
    protected override void ConnectHandler(WKWebView platformView)
    {
        base.ConnectHandler(platformView);
        var config = platformView.Configuration;
        
        // 允许从本地文件URL加载资源
        config.SetValueForKey(NSNumber.FromBoolean(true), new NSString("allowFileAccessFromFileURLs"));
        config.SetValueForKey(NSNumber.FromBoolean(true), new NSString("allowUniversalAccessFromFileURLs"));
        
        // 启用JavaScript及窗口自动打开权限
        config.Preferences.JavaScriptEnabled = true;
        config.Preferences.JavaScriptCanOpenWindowsAutomatically = true;
        
        // 允许混合内容加载（解决HTTP iframe嵌入HTTPS页面的限制）
        config.Preferences.SetValueForKey(NSNumber.FromBoolean(true), new NSString("allowsInlineMediaPlayback"));
    }
}

然后在MauiProgram.cs中注册该Handler：

builder.ConfigureMauiHandlers(handlers =>
{
#if IOS
    handlers.AddHandler<IWebView, CustomWebViewHandler>();
#endif
});

2. 修正Info.plist的安全配置 #

除了ATS设置，还需要添加针对文件访问和Web内容的权限：

<key>NSAppTransportSecurity</key>
<dict>
    <!-- 测试阶段允许任意加载，上架时可替换为具体域名的例外配置 -->
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSAllowsArbitraryLoadsInWebContent</key>
    <true/>
</dict>
<!-- 允许APP访问本地文件系统 -->
<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

3. 规范本地HTML归档的路径处理 #

加载本地归档时，必须将文件路径转换为iOS认可的file://格式URL，不能直接使用相对路径：

// 获取本地归档的完整路径
var archivePath = Path.Combine(FileSystem.AppDataDirectory, "your_archive.html");
// 转换为NSUrl格式的绝对字符串
var fileUrl = new Foundation.NSUrl(archivePath).AbsoluteString;
// 生成带iframe的包装HTML
var wrapperHtml = $@"
<html>
    <body style='margin:0;padding:0;'>
        <iframe src='{fileUrl}' width='100%' height='100%' frameborder='0'></iframe>
    </body>
</html>";
// 设置WebView源
webView.Source = new HtmlWebViewSource { Html = wrapperHtml };

4. 监听iframe加载错误获取详细日志 #

实现自定义WKNavigationDelegate，捕获更具体的加载失败信息：

public class CustomNavigationDelegate : WKNavigationDelegate
{
    public override void DidFailProvisionalNavigation(WKWebView webView, WKNavigation navigation, NSError error)
    {
        // 打印完整错误信息，定位核心问题
        Console.WriteLine($"Iframe加载失败: {error.LocalizedDescription}, 错误域: {error.Domain}, 错误码: {error.Code}");
    }
}

在CustomWebViewHandler的ConnectHandler方法中绑定Delegate：

platformView.NavigationDelegate = new CustomNavigationDelegate();

5. 检查iOS物理机的沙箱权限 #

iOS物理机的App Sandbox限制比模拟器严格，确保离线归档文件存储在FileSystem.AppDataDirectory或FileSystem.CacheDirectory目录下，这些是APP拥有读写权限的合法路径，避免使用其他自定义路径导致访问被拦截。

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