iOS Widget偶现图片加载失败（ERROR: could not find plugin for image source）

问题描述 #

我正在用SwiftUI开发首个iOS应用，尝试在Widget中展示图片。大部分时候能正常显示，但有时图片无法渲染——哪怕之前成功加载过同一张图，故障触发完全随机，Widget每小时刷新一次，加载成功率约95%，失败率5%。

错误日志 #

standard    06:39:45.111861+0200    WidgetsExtension    container_create_or_lookup_app_group_path_by_app_group_identifier: success
fehler  06:39:45.124706+0200    WidgetsExtension    CreateWithURL:342: *** ERROR: err=1 (Operation not permitted) - could not open '<CFURL 0x102346d60 [0x1f78674f8]>{string = file:///private/var/mobile/Containers/Shared/AppGroup/DBD07167-ED05-4BDF-A302-5173C84F0717/5230A437-503C-430E-A808-4AEF47D4D1B9-systemSmall.jpg, encoding = 134217984, base = (null)}'
fehler  06:39:45.126538+0200    WidgetsExtension    createImageAtIndex:1869: *** ERROR: could not find plugin for image source - imageRead is NULL
fehler  06:39:45.126574+0200    WidgetsExtension    createImageAtIndex:2007: *** ERROR: createImageAtIndex[0] - 'n/a ' - failed to create image [-62]
fehler  06:39:45.126601+0200    WidgetsExtension    CGImageSourceCreateImageAtIndex:4984: *** ERROR: CGImageSourceCreateImageAtIndex[0] - 'n/a ' - failed to create image [-62]

当前图片加载代码 #

struct HighlightsTile: View {
    var highlight: Moment
    var photoImage: UIImage?

    init(highlights: [Moment], size: ImageSize) {
        self.highlight = highlights[0]

        if highlight.photo != nil {
            let photoUrl = FileManager.documentsDirectory.appendingPathComponent("\(String(describing: highlight.photo!))-\(size).jpg")
            self.photoImage = UIImage(contentsOfFile: photoUrl.path)
        }
    }
}

补充信息 #

• 更新1：故障偶尔出现在之前加载正常的图片上，怀疑和线程、竞态条件、文件并发访问有关，但我是Swift新手，不确定这个猜测对不对。
• 更新2：把设备锁屏设置成“立即”后，Widget图片完全加载失败——也就是iPhone锁定时，后台加载图片会失败，需要找到允许这个场景加载图片的方法。

解决方案 #

1. 修复文件访问权限与竞态问题 #

日志里的Operation not permitted和加载失败错误，核心原因有两个：

• Widget扩展和主App共享App Group目录时，文件写入/读取的竞态条件：主App可能在更新图片文件时，Widget刚好尝试读取，导致文件锁定或权限临时失效。
• 锁屏时系统的文件访问限制：iOS在设备锁定后会限制后台进程的文件访问权限，直接用UIImage(contentsOfFile:)读取本地文件会被拦截。

代码调整建议：

不要在View的init方法里同步读取图片，改用异步方式加载，并且添加文件访问错误处理：

struct HighlightsTile: View {
    var highlight: Moment
    @State private var photoImage: UIImage?
    let size: ImageSize

    init(highlights: [Moment], size: ImageSize) {
        self.highlight = highlights[0]
        self.size = size
    }

    var body: some View {
        Group {
            if let image = photoImage {
                Image(uiImage: image)
                    .resizable()
                    .scaledToFill()
            } else {
                // 占位图
                Color.gray
            }
        }
        .onAppear {
            loadImage()
        }
    }

    private func loadImage() {
        guard let photoId = highlight.photo else { return }
        let photoUrl = FileManager.documentsDirectory.appendingPathComponent("\(photoId)-\(size).jpg")
        
        // 用异步队列读取文件，避免阻塞UI线程
        DispatchQueue.global(qos: .background).async {
            do {
                let data = try Data(contentsOf: photoUrl)
                if let image = UIImage(data: data) {
                    DispatchQueue.main.async {
                        self.photoImage = image
                    }
                }
            } catch {
                print("图片加载失败：\(error.localizedDescription)")
            }
        }
    }
}

2. 适配锁屏场景的文件访问 #

要让Widget在锁屏时也能读取图片，需要确保：

• 图片存储在App Group共享目录中（你目前已经在使用，但要确认主App写入文件时的权限设置）
• 主App写入文件时，设置正确的文件属性，确保Widget扩展有读取权限：

// 主App中写入图片到共享目录时的代码示例
func saveImageToAppGroup(image: UIImage, photoId: String, size: ImageSize) {
    guard let appGroupURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "你的App Group ID") else { return }
    let fileURL = appGroupURL.appendingPathComponent("\(photoId)-\(size).jpg")
    
    if let data = image.jpegData(compressionQuality: 0.8) {
        do {
            // 写入时设置文件权限为可被共享组读取
            try data.write(to: fileURL, options: [.atomicWrite])
            var attributes = try FileManager.default.attributesOfItem(atPath: fileURL.path)
            attributes[.posixPermissions] = 0o644 // 所有者可读写，组和其他用户可读
            try FileManager.default.setAttributes(attributes, ofItemAtPath: fileURL.path)
        } catch {
            print("保存图片失败：\(error.localizedDescription)")
        }
    }
}

注意：替换你的App Group ID为实际的App Group标识符。

3. 避免竞态条件的额外措施 #

• 主App更新图片时，先写入临时文件，再替换目标文件（原子操作），避免Widget读取到不完整的文件：

// 原子替换文件的示例
let tempURL = appGroupURL.appendingPathComponent("\(photoId)-\(size)_temp.jpg")
try data.write(to: tempURL)
try FileManager.default.replaceItemAt(fileURL, withItemAt: tempURL)

• Widget中添加重试逻辑：如果首次加载失败，间隔几秒后再次尝试读取。

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