CoreData存储UIImage后加载仅显示左上角异常问题求解

这个现象有两个最高频的触发原因：

• CoreData Binary Data属性的「Allows External Storage」系统bug
  这是iOS 13、iOS 14版本的已知框架问题：当二进制数据属性勾选了允许外部存储选项后，只要存入的Data体积超过系统阈值（约1MB），CoreData在自动将数据转存到沙盒独立文件的流程中会出现数据截断，仅写入文件开头的部分内容。JPEG格式本身按左上到右下的顺序分块编码，截断后的残留数据刚好可以解码出原图像的左上角区块，剩余部分因数据缺失无法解码，就会出现仅显示左上角的效果。存图前预览正常是因为预览的是内存中完整的UIImage对象，还未经过CoreData持久化的截断流程。
• UIImage缩放参数（scale）不匹配导致的显示裁切
  如果你存入前的源UIImage是从相册获取、屏幕截图等场景生成的2x/3x倍率图像（scale属性为2或3），调用jpegData(compressionQuality: 1.0)导出的是全像素尺寸的图像数据，但用UIImage(data:)从Data重建UIImage时，系统默认会将图像scale设为1，重建后的UIImage点尺寸是源图的2~3倍。如果图像承载视图（UIImageView、自定义绘制控件）没有开启自适应缩放，比如用了topLeft对齐模式，视图只会渲染图像左上角和自身尺寸等大的区域，视觉上和图像被裁切一致。

• 针对外部存储bug的修复
  • 小体积图片场景：直接取消对应Binary Data属性的「Allows External Storage」勾选，将数据直接存入CoreData数据库即可，注意单条二进制数据不要超过100MB，避免影响数据库读写性能。
  • 大体积图片场景：不要依赖CoreData的自动外部存储能力，手动将图片写入沙盒Documents/Caches目录，CoreData实体中仅存储图片文件的相对路径，读取时根据路径加载沙盒文件，彻底规避系统bug。
• 针对scale不匹配的修复
  从CoreData取出数据重建UIImage时，手动传入和当前屏幕匹配的scale参数，不要使用默认的scale=1初始化，代码示例：

  guard let imageData = myEntity.uiImage else { return }
  let targetScale = UIScreen.main.scale
  let uiImage = UIImage(data: imageData, scale: targetScale)
  

  同时检查图像承载视图的contentMode属性，确保设置为scaleAspectFit/scaleAspectFill/scaleToFill这类带缩放逻辑的模式，不要使用无缩放的对齐模式。

存入前打印JPEG数据的字节长度，从CoreData取出后再打印一次返回Data的字节长度，如果两个数值不一致，即可确定是CoreData存储流程发生了数据截断，直接按外部存储bug的方案修复即可。

内容的提问来源于stack exchange，提问作者Ramy Al Zuhouri