WebView无法加载本地BullsEye.html文件？求排查方案

我在ViewController中添加了一个WebView，已在项目内创建BullsEye.html文件，希望在WebView中展示该文件。以下是我写在viewDidLoad中的代码：

if let url = Bundle.main.url(forResource: "BullsEye", withExtension: "html") { 
    if let htmlData = try? Data(contentsOf: url) { 
        let baseURL = URL(fileURLWithPath: Bundle.main.bundlePath) 
        webView.load(htmlData, mimeType: "text/html", textEncodingName: "UTF-8", baseURL: baseURL) 
    } 
}

请问我遗漏了什么配置或代码？

嘿，我来帮你梳理下可能漏掉的关键配置和代码细节：

1. 确认WebView类型与框架引入 #

如果你用的是苹果推荐的WKWebView（旧的UIWebView已经被废弃），首先要确保：

• 已经在文件顶部导入WebKit框架：

  import WebKit
  

• 你的webView属性确实是WKWebView类型：如果是通过Storyboard拖入的控件，要在Identity Inspector里确认类型是WKWebView；如果是代码创建，要正确初始化：

  let webView = WKWebView(frame: view.bounds)
  view.addSubview(webView)
  

2. 检查HTML文件的Target Membership #

这是最容易忽略的点！你需要确保BullsEye.html已经被添加到项目的主Target中：

• 选中项目里的BullsEye.html文件
• 在右侧的File Inspector面板中，找到Target Membership区域，勾选你的项目主Target
  这样文件才会被打包进App的Bundle里，否则Bundle.main.url(...)会返回nil。

如果HTML依赖了其他资源（比如CSS、JS、图片），这些资源也要同样勾选Target Membership，不然页面加载后样式或资源会缺失。

3. 补上错误处理，方便调试 #

你的代码里用了try?会直接吞掉读取文件时的错误，换成do-catch并加上找不到文件的判断，能帮你快速定位问题：

if let url = Bundle.main.url(forResource: "BullsEye", withExtension: "html") {
    do {
        let htmlData = try Data(contentsOf: url)
        let baseURL = URL(fileURLWithPath: Bundle.main.bundlePath)
        webView.load(htmlData, mimeType: "text/html", textEncodingName: "UTF-8", baseURL: baseURL)
    } catch {
        print("读取HTML文件失败：\(error.localizedDescription)")
    }
} else {
    print("找不到BullsEye.html文件，请检查文件名和Target配置")
}

4. 试试更简洁的加载方式 #

其实WKWebView支持直接加载本地文件URL，不需要转成Data，代码更简洁还能自动处理资源路径：

if let url = Bundle.main.url(forResource: "BullsEye", withExtension: "html") {
    // 允许WebView读取当前文件所在目录的所有资源
    webView.loadFileURL(url, allowingReadAccessTo: url.deletingLastPathComponent())
}

5. 可选：添加代理监听加载状态 #

如果需要知道页面是否加载成功，或者处理加载失败的情况，可以设置WKNavigationDelegate：

class ViewController: UIViewController, WKNavigationDelegate {
    var webView: WKWebView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        webView = WKWebView(frame: view.bounds)
        webView.navigationDelegate = self
        view.addSubview(webView)
        
        // 加载HTML文件的代码...
    }
    
    func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
        print("HTML页面加载完成")
    }
    
    func webView(_ webView: WKWebView, didFail navigation: WKNavigation!, withError error: Error) {
        print("页面加载失败：\(error.localizedDescription)")
    }
}

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