> 技术文档 > React Native 提交至 App Store 报错 The archive did not include a dSYM for the hermes.framework 终极解决方案_the archive did not include a dsym for the flutter

React Native 提交至 App Store 报错 The archive did not include a dSYM for the hermes.framework 终极解决方案_the archive did not include a dsym for the flutter


React Native 0.76.7 iOS 打包提交 App Store 遇到 Hermes dSYM 缺失问题的解决方案

错误描述

在使用 React Native 0.76.7 打包 iOS 应用并提交至 App Store Connect 时,可能会遇到以下错误:

The archive did not include a dSYM for the hermes.framework with the UUIDs [370D4F3B-9105-372E-A571-E4AA5F1DCE9A].Ensure that the archive\'s dSYM folder includes a DWARF file for hermes.framework with the expected UUIDs.

该错误表明归档文件(Archive)中 缺少 Hermes 引擎的调试符号文件(hermes.framework.dSYM),导致苹果无法验证二进制文件的完整性。


问题原因

  1. Hermes dSYM 未生成
    React Native 构建流程可能未正确生成 Hermes 的调试符号文件。

  2. 版本升级冲突
    从旧版本升级至 React Native 0.76.7 时,残留的构建缓存或依赖可能导致符号文件丢失。

  3. 架构目录不匹配
    Hermes 的 dSYM 文件需要根据 构建目标(真机、模拟器等)放置到正确的架构目录中。


完整解决方案

一、检查现有 dSYM 文件

塑料供求信息