You need to enable JavaScript to run this app. 如何解决SwiftUI ScrollView结合KFImage调用Firebase Storage内存不释放崩溃问题
优惠活动
大模型
产品
解决方案
定价
更多

如何解决SwiftUI ScrollView结合KFImage调用Firebase Storage内存不释放崩溃问题

项目基础信息

基于Xcode 12.3、Swift/SwiftUI技术栈开发,遇到两类待解决问题:

  • ScrollView中调用Firebase Storage下载API时,视图滚动过程中,已滑出可视区域的图片占用内存无法释放,最终内存达到约3GB时触发应用崩溃
  • 切换为自行实现的Flickr图片下载逻辑时,内存可正常释放,整体占用稳定在140MB左右
  • 核心诉求:调整现有代码,让Firebase接口加载的图片在滑出可视区域时,可像Flickr逻辑一样被正常回收内存
报错信息

网络请求报错

通过Firebase Storage路径gs://<MY DOMAIN>/figure_images/SWBS6I_100300_PrimaryFrontImage_Small.jpg拉取图片时,抛出如下错误:

2021-01-02 11:41:50.776056-0500 xxx[xxx] Task <xxx>.<87> finished with error [-1002] Error Domain=NSURLErrorDomain Code=-1002 "unsupported URL" UserInfo={NSLocalizedDescription=unsupported URL, NSErrorFailingURLStringKey=SWBS6I_116300_PrimaryFrontImage_Small.jpg, NSErrorFailingURLKey=SWBS6I_116300_PrimaryFrontImage_Small.jpg, _NSURLErrorRelatedURLSessionTaskErrorKey=(
"LocalDataTask <xxx>.<87>"
), _NSURLErrorFailingURLSessionTaskErrorKey=LocalDataTask <xxx>.<87>, NSUnderlyingError=0x2800c0840 {Error Domain=kCFErrorDomainCFNetwork Code=-1002 "(null)"}}

内存崩溃报错

内存占用超标触发崩溃时,返回如下系统日志:

iPhone quit unexpectedly.
Domain: IDEDebugSessionErrorDomain
Code: 4
Failure Reason: Message from debugger: Terminated due to memory issue
--

System Information
macOS Version 11.1 (Build 20C69)
Xcode 12.3 (17715) (Build 12C33)
Timestamp: 2021-01-02T11:44:56-05:00
涉及代码实现

SwiftUI视图层代码

import SwiftUI
import struct Kingfisher.KFImage

struct SeriesView: View {
    // Firebase 身份认证
    @EnvironmentObject var authState: AuthenticationState
    // 监听视图模型状态,获取剧集列表数据
    @ObservedObject var seriesList = seriesListSharedData

    var showFigures: [Figure] {
        let showFiguresFilter: [Figure] = seriesList.figureArray.filter({$0.seriesUniqueId == SeriesUniqueIdEnum.SWBS6I})
        return showFiguresFilter
    }

    var body: some View {
        ScrollView {
            LazyVGrid(columns: [
                GridItem(.adaptive(minimum: 100, maximum: 100))
            ], content: {
                ForEach(showFigures, id: \.self) { figure in
                    FigurePhoto(figure: figure)
                }
            })
        }
    }
}

struct FigurePhoto: View {
    @ObservedObject var figure: Figure

    var body: some View {
        VStack(alignment: .center, spacing: 4) {
            HStack(alignment: .top, spacing: 4) {
                VStack(alignment: .center, spacing: 0) {
                    let image = figure.imagePrimaryFrontString ?? ""
                    KFImage(URL(string: image))
                        .resizable()
                        .aspectRatio(1, contentMode: .fill)
                    Spacer()
                }
                .onAppear() {
                    // 1. 可正常运行的Flickr调用逻辑,整体内存占用约140MB
                    figure.fetchFlickrImageURL(withTags: figure.figureGlobalUniqueId, withText: "\(figure.figureGlobalUniqueId)\(kPrimaryFrontImageNameSuffix)\(kSmallSuffix)")
                    // 两类调用二选一,不会同时触发
                    // 2. 存在内存问题的Firebase调用逻辑:无论图片是否在可视区域内,所有已加载照片的内存都会被持续占用,直到内存达到3GB触发崩溃
                    figure.fetchFirebasePrimaryFrontImageString(firebaseStorageRef: kFigureImageRoot)
                }
            }
        }
    }
}

内存表现正常的Flickr实现

该逻辑下,视图滑出可视区域时内存可正常释放:

// 拉取所有Flickr图片URL,将主图设置为列表第一张
func fetchFlickrImageURL(withTags tags: String, withText text: String?) {
    var stringURL = String()
    let flickr = Flickr()

    flickr.flickrPhotosSearch(withTags: tags, withText: text) { results, error in
        if let error = error {
            print("Error searching Flickr: \(error)")
        }

        if let results = results {
            // 无搜索结果时直接返回
            if results.searchResults.count == 0 {
                return
            }

            for flickrPhoto in results.searchResults {
                if let text = text {
                    // 将主图插入列表最前
                    if let farm = flickrPhoto.farm, let server = flickrPhoto.server, let secret = flickrPhoto.secret {
                        if text.contains(("\(kPrimaryFrontImageNameSuffix)\(kSmallSuffix)")) {
                            stringURL = "https://farm\(farm).staticflickr.com/\(server)/\(flickrPhoto.photoID)_\(secret).jpg"
                        } else {
                            stringURL = "https://farm\(farm).staticflickr.com/\(server)/\(flickrPhoto.photoID)_\(secret).jpg"
                        }
                    }
                }
            }
            self.imagePrimaryFrontString = stringURL
        }
    }
}

Flickr实际网络请求实现

func flickrPhotosSearch(withTags tags: String, withText text: String? = nil,
                        completion : @escaping (_ results: FlickrSearchResults?, _ error : NSError?) -> Void) {
    var searchURL: URL

    // 检查是否传入主图名称参数
    if let text = text {
        guard let searchURLText = flickrSearch(withText: text) else {
            let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
            completion(nil, APIError)
            return
        }
        searchURL = searchURLText
    } else {
        guard let searchURLTags = flickrSearch(withTags: tags) else {
            let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
            completion(nil, APIError)
            return
        }
        searchURL = searchURLTags
    }

    let searchRequest = URLRequest(url: searchURL)

    URLSession.shared.dataTask(with: searchRequest, completionHandler: { (data, response, error) in
        if let _ = error {
            let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
            OperationQueue.main.addOperation({
                completion(nil, APIError)
            })
            return
        }

        guard let _ = response as? HTTPURLResponse,
            let data = data else {
                let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
                OperationQueue.main.addOperation({
                    completion(nil, APIError)
                })
                return
        }

        do {
            guard let resultsDictionary = try JSONSerialization.jsonObject(with: data, options: JSONSerialization.ReadingOptions(rawValue: 0)) as? [String: AnyObject],
                let stat = resultsDictionary["stat"] as? String else {
                    let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
                    OperationQueue.main.addOperation({
                        completion(nil, APIError)
                    })
                    return
            }

            switch (stat) {
            case "ok":
                break
            case "fail":
                if let message = resultsDictionary["message"] {
                    let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:message])
                    OperationQueue.main.addOperation({
                        completion(nil, APIError)
                    })
                }
                let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: nil)
                OperationQueue.main.addOperation({
                    completion(nil, APIError)
                })
                return
            default:
                let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
                OperationQueue.main.addOperation({
                    completion(nil, APIError)
                })
                return
            }

            guard let photosContainer = resultsDictionary["photos"] as? [String: AnyObject], let photosReceived = photosContainer["photo"] as? [[String: AnyObject]] else {
                let APIError = NSError(domain: "FlickrSearch", code: 0, userInfo: [NSLocalizedFailureReasonErrorKey:"Unknown API response"])
                OperationQueue.main.addOperation({
                    completion(nil, APIError)
                })
                return
            }

            var flickrPhotos = [FlickrPhoto]()

            for photoObject in photosReceived {
                guard let photoID = photoObject["id"] as? String,
                    let farm = photoObject["farm"] as? Int ,
                    let server = photoObject["server"] as? String ,
                    let secret = photoObject["secret"] as? String,
                    let originalSecret = photoObject["originalsecret"] as? String else {
                        break
                }

                let flickrPhoto = FlickrPhoto(photoID: photoID, farm: farm, server: server, secret: secret, originalSecret: originalSecret)
                flickrPhotos.append(flickrPhoto)

                // 加载缩略图
                guard let url = flickrPhoto.flickrImageURL(),
                    let imageData = try? Data(contentsOf: url as URL) else {
                        break
                }

                if let image = UIImage(data: imageData) {
                    flickrPhoto.thumbnail = image
                }
            }

            OperationQueue.main.addOperation({
                completion(FlickrSearchResults(searchTerm: tags, searchResults: flickrPhotos), nil)
            })
        } catch _ {
            completion(nil, nil)
            return
        }
    }) .resume()
}

存在内存问题的Firebase实现

该逻辑下,图片滑出可视区域时无法释放内存:

func fetchFirebasePrimaryFrontImageString(firebaseStorageRef: String) {
    let storage = Storage.storage()
    // 设置图片存储路径
    getFirebasePrimaryFrontImageString()
    // 构造图片存储引用
    let storageRefImage = storage.reference().child(firebaseStorageRef)
    let seriesImageRef = storageRefImage.child(self.imagePrimaryFrontString!)

    seriesImageRef.downloadURL { firebaseImageURL, error in
      if let error = error {
        #if DEBUG
        print("ERROR: Failure getting Firebase Series image: \(error.localizedDescription)")
        #endif
      }
      else {
        self.imagePrimaryFrontString = firebaseImageURL!.absoluteString
      }
    }
}

func getFirebasePrimaryFrontImageString() {
    self.imagePrimaryFrontString = "\(self.figureGlobalUniqueId)\(kPrimaryFrontImageNameSuffix)\(kSmallSuffix).\(kImageJpgExt)"
}

对应Firebase Storage API定义

FIRStorageReference中下载方法的签名与注释:

/**
 * 异步获取带可撤销令牌的长期有效下载链接
 * 该链接可用于向其他用户分享文件,开发者可在Firebase控制台手动撤销对应链接的权限
 * @param completion 完成回调:成功时返回下载URL,失败时返回错误信息
 */
open func downloadURL(completion: @escaping (URL?, Error?) -> Void)

该方法的实际实现代码:

- (void)downloadURLWithCompletion:(FIRStorageVoidURLError)completion {
  FIRStorageGetDownloadURLTask *task =
  [[FIRStorageGetDownloadURLTask alloc] initWithReference:self
                                           fetcherService:_storage.fetcherServiceForApp
                                            dispatchQueue:_storage.dispatchQueue
                                               completion:completion];
  [task enqueue];
}

内容的提问来源于stack exchange,提问作者Jacksonsox

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 13:45:07