iOS中UIWebView加载自研服务器下载资源失败，报NSURLConnection错误1100

我来帮你梳理下这个特殊场景的可能原因和解决办法——自家服务器下载的文件iOS加载失败但Android正常，别家服务器的文件iOS却没问题，咱们从iOS和Android的差异点入手分析：

可能的原因 #

1. 路径/文件名的大小写&特殊字符问题 #

iOS的文件系统对路径的敏感度远高于Android：

• 比如你服务器返回的文件名是Player.js，但HTML模板里引用的是player.js，Android会忽略大小写直接加载，但iOS会严格匹配，找不到就报1100错误。
• 如果路径里有空格、中文这类特殊字符，Android会自动处理转义，但iOS的WebView内核对未转义的路径解析会出错，导致文件找不到。

2. 文件权限不匹配 #

iOS沙盒的权限管控很严格：

• 从自家服务器下载的文件可能带有特殊权限标记（比如只读），或者下载过程中没设置好读写权限，WebView没法读取文件。而Android的文件权限机制宽松很多，所以能正常访问。

3. 文件编码/格式的细微差异 #

虽然你说和别家服务器的文件对比过，但可能存在iOS敏感的细节问题：

• 比如JS/CSS/XML文件的编码不是UTF-8，而你用.utf8读取模板生成HTML，导致内容乱码，WebView加载失败。Android的WebView对编码兼容性更好，能自动适配。
• XML或JS文件存在格式不规范（比如未闭合标签、语法错误），iOS的WebView内核容错性低，直接拒绝加载；Android的WebView则会尝试兼容。

4. BaseURL设置与文件路径不匹配 #

你当前把BaseURL设为documentDirectory，但如果HTML里的相对路径是基于lessonURL的子目录，就会导致WebView找错位置。比如HTML里写./js/main.js，但实际文件在documentDirectory/lesson/js/main.js，BaseURL设根目录的话，WebView会去documentDirectory/js/main.js找，自然找不到报1100。别家服务器的文件目录结构可能刚好和模板匹配，所以没问题。

针对性解决办法 #

1. 统一路径和文件名规范 #

• 写个小工具，把下载后的所有文件名统一转成小写（或者和HTML模板里的引用完全一致），同时对路径里的特殊字符做URL转义：

  // 示例：给路径做URL转义
  let escapedLessonPath = lessonURL.path.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed) ?? lessonURL.path
  

• 用WKWebView的代理监听请求，打印出实际请求的URL，和本地文件路径对比，就能快速定位不匹配的地方。

2. 修复文件权限 #

• 文件下载完成后，手动设置读写权限：

  do {
      try FileManager.default.setAttributes([.posixPermissions: 0o644], ofItemAtPath: downloadedFileURL.path)
  } catch {
      print("设置文件权限失败：\(error)")
  }
  

• 提前用FileManager.default.fileExists(atPath:)逐一验证HTML里引用的所有文件是否真的存在于指定路径，排除“以为存在实际不存在”的情况。

3. 校验文件编码和格式 #

• 用文本编辑器打开自家服务器的文件，检查编码是否为UTF-8（和你读取模板的编码一致），如果不是，转成UTF-8后再保存到本地。
• 用XML校验工具检查XML文件的格式，修复未闭合标签等问题；JS文件可以用ESLint检查语法错误，确保符合标准规范。

4. 调整BaseURL或引用路径 #

• 如果所有资源文件都在lessonURL对应的子目录里，把BaseURL改成lessonURL而不是根目录：

  webKit.loadHTMLString(html, baseURL: lessonURL)
  

• 或者修改HTML模板里的引用路径，加上{{lessonPath}}前缀，比如{{lessonPath}}/js/main.js，确保路径是绝对正确的。

5. 切换到WKWebView并开启调试 #

• 建议彻底放弃UIWebView（苹果已经废弃），改用WKWebView，同时通过代理获取更详细的错误信息：

  func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
      print("加载失败详情：\(error.localizedDescription)")
      if let urlError = error as? URLError {
          print("错误码：\(urlError.code)，失败的URL：\(urlError.failingURL?.absoluteString ?? "")")
      }
  }
  

• 打开Safari的Web Inspector，连接真机调试WKWebView，查看控制台的报错，能直接看到哪个文件加载失败、具体原因是什么，比只看错误码1100有用多了。

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