Background Assets下载超出配额报错Error Code203如何解决？

在学习WWDC2022的Background Asset相关内容后，创建了新项目，并在Info.plist中配置了BAMaxInstallSize、BAManifestURL、BAInitialDownloadRestrictions（包含BADownloadAllowance与下载域名白名单）。使用调试命令：

xcrun backgroundassets-debug -s --app-install -b com.***.BADemo1 -d xxxxxxx

时，在Console.app中出现以下错误日志：

Download BAManifestDownload  - com.***.BADemo1.Manifest-xx rejected as we are out of download allowance.

Download did fail: BAManifestDownload  - com.***.BADemo1.Manifest-xx with error: Error Domain=com.apple.backgroundassets.error Code=203 "The requested download will not be allowed due to running out of download allowance." UserInfo={NSLocalizedFailureReason=The requested download will not be allowed due to running out of download allowance.}

Rejecting launching extension for <private> because it has already run too long.

解决方案 #

• 检查并调整下载额度配置：
  确认Info.plist中BAInitialDownloadRestrictions下的BADownloadAllowance值（单位为字节）大于Manifest文件加上所有待下载资源的总大小。比如要下载10MB的内容，需设置为10485760（1010241024），避免因额度不足触发Code203错误。

• 重置Background Assets调试状态：
  多次调试可能导致额度被占用未重置，执行以下命令清空应用的Background Assets状态后重新调试：

  xcrun backgroundassets-debug --reset -b com.***.BADemo1
  

• 优化扩展运行逻辑：
  排查Background Assets扩展的代码，确保没有无限循环、阻塞操作或不必要的耗时任务。扩展处理完下载逻辑后需及时退出，避免系统判定为“运行时间过长”而拒绝启动。

• 验证域名白名单配置：
  确认BAInitialDownloadRestrictions中的下载域名白名单包含BAManifestURL的域名，避免因域名未授权间接导致下载流程异常。

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