Swift 5中JSON返回的图片路径字符串含空格导致下载崩溃如何解决

核心原因 #

当前写法存在两个问题直接触发崩溃：

• 未对URL路径中的特殊字符（空格、中文、特殊符号等）做百分号编码，包含空格的字符串无法生成合法URL实例，URL(string:)会直接返回nil
• 使用强制解包!获取URL实例，返回nil时直接触发强制解包崩溃

浏览器访问路径时会自动对特殊字符做编码处理，因此可以正常访问，而iOS原生URL(string:)方法不会自动处理非法字符。

解决方案 #

1. 路径编码+安全解包修复崩溃 #

优先对图片路径做URL编码，同时替换强制解包为可选绑定做安全校验，修正代码如下：

// 对图片路径做百分号编码，仅保留URL路径允许的合法字符
guard let originalPath = item.image.first,
      let encodedPath = originalPath.addingPercentEncoding(withAllowedCharacters: .urlPathAllowed),
      let imageUrl = URL(string: "http://5.63.13.16:8080/\(encodedPath)") else {
    // 路径无效时可设置占位图避免空白
    cellol.offerImageView.image = UIImage(named: "placeholder")
    return
}
if let data = try? Data(contentsOf: imageUrl) {
    cellol.offerImageView.image = UIImage(data: data)
}

2. 性能优化建议 #

Data(contentsOf:)为同步网络请求，直接在UI线程调用会阻塞界面响应，建议替换为URLSession异步下载逻辑，也可以直接使用成熟的第三方图片加载库（如Kingfisher、SDWebImage），这类工具会自动处理URL编码、异步下载、内存/磁盘缓存等逻辑，无需手动处理路径编码问题。

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