TestFlight上传Home Assistant报错：缺少networkextension权限

从源码编译的Home Assistant应用可正常编译并安装到设备，公司开发者账户配置正确，Xcode已设置自动管理配置文件，归档也能成功创建，但上传至Apple Store Connect用于TestFlight测试时，收到90525权限缺失错误，提示主应用和推送扩展插件都缺少com.apple.developer.networking.networkextension权限。

手动添加该权限后，会收到配置文件不正确的提示；检查公司开发者账户的网络扩展设置，未找到与推送通知相关的配置（推送通知设置在其他位置），陷入循环：要么配置文件正确但缺权限，要么权限添加后配置文件失效。

完整错误日志 #

URL:https://contentdelivery.itunes.apple.com
 status code: 409 (conflict)
    httpBody: {
  "errors" : [ {
    "id" : "ceac6dcc-9c76-412e-8ea7-f2d2845f8013",
    "status" : "409",
    "code" : "STATE_ERROR.VALIDATION_ERROR.90525",
    "title" : "Asset validation failed",
    "detail" : "Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'."
  }, {
    "id" : "9ff2143b-3c00-4912-b59f-8342fa6fe5c0",
    "status" : "409",
    "code" : "STATE_ERROR.VALIDATION_ERROR.90525",
    "title" : "Asset validation failed",
    "detail" : "Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'."
  } ]
}
=======================================
2024-01-10 23:19:35.506 ERROR: [ContentDelivery.Uploader] Asset validation failed (90525) Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: ceac6dcc-9c76-412e-8ea7-f2d2845f8013)
2024-01-10 23:19:35.506 DEBUG: [ContentDelivery.Uploader] Error Domain=ContentDelivery Code=90525 "Asset validation failed" UserInfo={NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: ceac6dcc-9c76-412e-8ea7-f2d2845f8013), NSUnderlyingError=0x6000022b6430 {Error Domain=IrisAPI Code=-19241 "Asset validation failed" UserInfo={status=409, detail=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'., id=ceac6dcc-9c76-412e-8ea7-f2d2845f8013, code=STATE_ERROR.VALIDATION_ERROR.90525, title=Asset validation failed, NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'., NSLocalizedDescription=Asset validation failed}}, iris-code=STATE_ERROR.VALIDATION_ERROR.90525, NSLocalizedDescription=Asset validation failed}
2024-01-10 23:19:35.507 ERROR: [ContentDelivery.Uploader] Asset validation failed (90525) Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: 9ff2143b-3c00-4912-b59f-8342fa6fe5c0)
2024-01-10 23:19:35.507 DEBUG: [ContentDelivery.Uploader] Error Domain=ContentDelivery Code=90525 "Asset validation failed" UserInfo={NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: 9ff2143b-3c00-4912-b59f-8342fa6fe5c0), NSUnderlyingError=0x6000022b6640 {Error Domain=IrisAPI Code=-19241 "Asset validation failed" UserInfo={status=409, detail=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'., id=9ff2143b-3c00-4912-b59f-8342fa6fe5c0, code=STATE_ERROR.VALIDATION_ERROR.90525, title=Asset validation failed, NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'., NSLocalizedDescription=Asset validation failed}}, iris-code=STATE_ERROR.VALIDATION_ERROR.90525, NSLocalizedDescription=Asset validation failed}
2024-01-10 23:19:35.507 DEBUG: [ContentDelivery.Uploader] swinfo errors: (
    "Error Domain=ContentDelivery Code=90525 \"Asset validation failed\" UserInfo={NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: ceac6dcc-9c76-412e-8ea7-f2d2845f8013), NSUnderlyingError=0x6000022b6430 {Error Domain=IrisAPI Code=-19241 \"Asset validation failed\" UserInfo={status=409, detail=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'., id=ceac6dcc-9c76-412e-8ea7-f2d2845f8013, code=STATE_ERROR.VALIDATION_ERROR.90525, title=Asset validation failed, NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app/PlugIns/HomeAssistant-Extensions-PushProvider.appex' is missing entitlement 'com.apple.developer.networking.networkextension'., NSLocalizedDescription=Asset validation failed}}, iris-code=STATE_ERROR.VALIDATION_ERROR.90525, NSLocalizedDescription=Asset validation failed}",
    "Error Domain=ContentDelivery Code=90525 \"Asset validation failed\" UserInfo={NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'. (ID: 9ff2143b-3c00-4912-b59f-8342fa6fe5c0), NSUnderlyingError=0x6000022b6640 {Error Domain=IrisAPI Code=-19241 \"Asset validation failed\" UserInfo={status=409, detail=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'., id=9ff2143b-3c00-4912-b59f-8342fa6fe5c0, code=STATE_ERROR.VALIDATION_ERROR.90525, title=Asset validation failed, NSLocalizedFailureReason=Missing Entitlement. The bundle 'Home Assistant.app' is missing entitlement 'com.apple.developer.networking.networkextension'., NSLocalizedDescription=Asset validation failed}}, iris-code=STATE_ERROR.VALIDATION_ERROR.90525, NSLocalizedDescription=Asset validation failed}"
)

1. 确认开发者账户权限 #

登录Apple开发者后台，进入Certificates, Identifiers & Profiles，找到对应App的Identifier：

• 检查是否启用了Network Extensions权限，若未启用，勾选并保存。
• 注：Network Extensions属于特殊权限，Home Assistant推送扩展所需的网络权限通常无需额外审核，直接启用即可。

2. 重置Xcode配置文件 #

启用权限后，回到Xcode操作：

• 关闭Xcode，删除项目目录下的DerivedData文件夹（路径：~/Library/Developer/Xcode/DerivedData）。
• 打开项目，进入Signing & Capabilities页面，先切换到手动管理配置文件，再切回自动管理，触发Xcode重新下载包含Network Extensions权限的配置文件。

3. 通过Xcode Capabilities添加权限 #

不要手动修改Entitlements文件，通过官方流程添加：

• 在主应用和HomeAssistant-Extensions-PushProvider.appex目标的Signing & Capabilities中，点击+ Capability，搜索并添加Network Extensions。
• 确认添加后，Xcode会自动将com.apple.developer.networking.networkextension权限写入对应目标的Entitlements文件，同时确保配置文件同步包含该权限。

4. 清理缓存后重新归档 #

• 执行Product > Clean Build Folder清理编译缓存。
• 重新进行归档操作，再尝试上传至Apple Store Connect。

5. 检查推送扩展的配置关联 #

由于错误提示推送扩展也需要该权限，需确保：

• 推送扩展目标的Identifier是主应用Identifier的扩展格式（例如主应用为com.example.homeassistant，扩展应为com.example.homeassistant.pushprovider）。
• 推送扩展的Signing配置与主应用保持一致，使用同一个开发者账户和自动管理配置文件。

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