SwiftUI Image无法显示本地已存在的图片文件问题求解

问题根源 #

你遇到的权限错误和图片加载逻辑无关，是macOS 沙盒机制的默认限制：
通过系统文件导入器选择文件时，系统只会给应用授予该文件的临时访问权限，权限会在应用重启后自动失效，所以才会出现选择文件后可正常读取、重启后报257权限错误的现象。你的AppKit版本可以正常运行，大概率是没有开启App Sandbox限制。

解决方案 #

你需要将用户选择的文件路径生成为安全范围书签（Security-scoped Bookmark） 持久化存储，每次读取时通过书签恢复访问权限即可，步骤如下：

1. 配置沙盒权限
   打开项目的Signing & Capabilities标签，找到App Sandbox配置项：

   • 勾选「File Access > User Selected File」，权限设置为Read/Write
   • 确认Info.plist中存在以下配置：
     • com.apple.security.app-sandbox 值为 YES
     • com.apple.security.files.user-selected.read-write 值为 YES

2. 用户选择文件后生成安全书签存储
   不要只存储文件的URL，改为存储书签数据，示例代码：

   // 文件选择器返回选中的URL后调用，生成持久化书签
   func generateBookmark(for url: URL) throws -> Data {
       let hasAccess = url.startAccessingSecurityScopedResource()
       defer {
           if hasAccess {
               url.stopAccessingSecurityScopedResource()
           }
       }
       return try url.bookmarkData(
           options: .withSecurityScope,
           includingResourceValuesForKeys: nil,
           relativeTo: nil
       )
   }
   

   将生成的Data存入Book的metadata字段中，替换原有单纯存储URL的逻辑。

3. 读取图片时通过书签恢复访问权限
   改造你的封面读取逻辑：

   extension Book {
       func coverImage() -> NSImage {
           // 读取持久化存储的书签数据
           guard let bookmarkData = metadata.coverBookmark else {
               return NSImage()
           }
           do {
               var isStale = false
               // 从书签恢复文件URL
               let coverURL = try URL(
                   resolvingBookmarkData: bookmarkData,
                   options: .withSecurityScope,
                   relativeTo: nil,
                   bookmarkDataIsStale: &isStale
               )
               // 书签过期时可提示用户重新选择封面
               guard !isStale else {
                   return NSImage()
               }
               // 申请文件访问权限
               let accessSuccess = coverURL.startAccessingSecurityScopedResource()
               defer {
                   // 读取完成后关闭权限
                   if accessSuccess {
                       coverURL.stopAccessingSecurityScopedResource()
                   }
               }
               // 读取图片数据
               let imageData = try Data(contentsOf: coverURL)
               return NSImage(data: imageData) ?? NSImage()
           } catch {
               print("封面读取失败：\(error)")
               return NSImage()
           }
       }
   }
   

内容的提问来源于stack exchange，提问作者Swift Dev Journal