Xcode 27.2 RC dSYM 缺失怎麼辦?2026 排查清單

Apple 的發布清單將 Xcode 27.2 RC 列為 2026 年 10 月 19 日發布的 Release Candidate。先找出發生崩潰的那次 Xcode Archive,再比對崩潰報告中的二進位 UUID 與 dSYM UUID;若 UUID 不符,不要拿其他版本或重新建置的 dSYM 代替原始符號檔。

適合閱讀對象:收到無法符號化崩潰報告的獨立開發者,以及負責留存每次發行 Archive 和 dSYM 的小型團隊。
如果你維護遠端 Mac 或 CI,也可用下列檢查清單確認產物是否保存、交接後是否仍可找回。

最後更新於 2026 年 11 月 1 日;Xcode 版本狀態依Apple Developer 發布清單核對,符號處理流程依 Apple 的 Xcode 文件複核。

01 Xcode 27.2 RC dSYM 缺失:先分清症狀

「崩潰報告沒有函式名稱」不一定代表整份 dSYM 遺失。先看報告呈現的是地址、部分未符號化堆疊,還是 Xcode 明確提示缺少符號檔,再確認問題涉及哪個二進位。Apple 的崩潰報告 JSON 格式說明可協助你辨認報告中的執行檔與影響的二進位映像。

  • 堆疊只顯示位址或偏移量:可能缺少與該二進位相符的 dSYM,也可能還未完成符號化。
  • 只有部分呼叫堆疊無法讀取:可能是 App、擴充功能、系統框架或第三方框架中的某一類符號缺失,不宜直接判定整個 Archive 都有問題。
  • Xcode 提示缺少符號:把提示中提到的二進位名稱與崩潰報告逐一對照;檔名相同不等於 UUID 相同。

目前 Apple 發布清單只確認 Xcode 27.2 RC 的版本狀態與發布日期,不能據此推論該版本普遍存在 dSYM 故障。先以崩潰報告和產物比對結果定位問題,不要把個別案例直接歸因於 RC 版本。

02 對照選項與恢復邊界

選項 可以確認什麼 判斷與下一步
找到原始 Xcode Archive 歸檔內是否有主 App、擴充功能及嵌入式框架的 dSYM 逐一核對二進位 UUID;匹配後再進行符號化
找到 dSYM,但沒有原始 Archive 候選符號檔是否對應崩潰報告中的二進位 UUID 不符就停止使用該檔,繼續找其他產物
只在 App Store Connect 看到該建置 可查看平台上的建置與中繼資料 不代表本機或遠端 Mac 仍保留完整原始 Archive
找不到相符符號檔 現有資料能否證明其來源及建置身分 若 Archive 已遺失且沒有 UUID 相符的 dSYM,舊建置可能無法恢復完整符號資訊

Apple 說明 Xcode Archive 可包含 App 二進位與除錯資訊;符號化需要能對應到該二進位的符號資料。這也是為什麼「同一份原始碼重新建置」不能自動補回舊建置的 dSYM:新產物不是舊二進位的 UUID 證據。可參考 Apple 的建置除錯資訊文件。

Xcode 27.2 RC 產生的 dSYM 在哪裡找?先找該次建置匯出的 .xcarchive,再檢查歸檔中的 dSYMs 資料夾,以及主 App、擴充功能和嵌入式框架各自的符號檔。若你只留下 IPA 或安裝包,不要假設它包含可供本機使用的完整 dSYM;回頭確認建置時是否另行保存 Archive 與符號產物。

03 UUID 比對與停止條件

Apple 的缺失除錯符號定位文件提供從報告與候選符號檔查找缺失符號的方向。核對時應以 UUID 為準,而非檔名、版本字串或資料夾名稱。

  • [ ] 從崩潰報告確認出問題的二進位名稱及其 UUID。不要只複製堆疊中的位址。
  • [ ] 從原始 Archive 找出對應二進位和 dSYM,避免把主 App 的符號檔拿去比對擴充功能或框架。
  • [ ] 使用 Xcode 的符號檢查流程,或在終端機對候選 dSYM 執行 dwarfdump --uuid,將輸出與報告中的 UUID 逐項核對。Apple 的崩潰報告符號名稱文件說明了將識別性符號名稱加入崩潰報告的相關流程。
  • [ ] 記錄比對結果、二進位名稱和產物來源,確認命中的 dSYM 屬於崩潰報告所指的建置。
  • [ ] UUID 不相符時停止嘗試該檔案。改查其他 Archive、交接目錄或建置保存位置,不要靠改名或重複執行符號化來繞過不匹配。

dSYM UUID 和崩潰報告中的 UUID 不相符時怎麼處理?先確認你比對的是同一個二進位,而非同名的另一個 Target。若二進位對象正確但 UUID 仍不一致,該 dSYM 不能作為這份報告的匹配符號檔;應回到原始 Archive 尋找正確產物。Apple 的 UUID 對應原則不能用「程式碼看起來相同」取代。

04 部分符號化與 App Store Connect 的邊界

若堆疊中只有一部分缺少函式名稱,按未符號化影格所屬的二進位分開處理:

  • 自有 App 或擴充功能:查找相同分發建置的 Archive,分別核對對應 dSYM UUID。
  • 系統框架:確認報告使用的作業系統與裝置資訊,再檢查相符的裝置符號。不要拿 App 自己的 dSYM 代替系統框架符號。
  • 第三方框架:確認該版本依賴是否有供應方提供的 dSYM,再以框架二進位 UUID 核驗。缺少第三方框架符號,不代表 App 本身的 dSYM 也遺失。

App Store Connect 裡有建置記錄,是否代表本機 Archive 還在?不代表。平台上的建置資訊可協助你確認上傳建置及其中繼資料,但不能證明團隊仍持有原始 .xcarchive。依 Apple 的查看建置與中繼資料說明檢查平台資訊後,仍要回到你自己的建置保存位置核對 Archive 與 dSYM。

沒有對應的 Xcode Archive,還能符號化舊版 App 崩潰嗎?若你另有 UUID 相符的 dSYM,仍可用它處理對應二進位;若 Archive 與匹配符號都已遺失,重新建置通常不能替代舊建置的符號資料。此時應保留現有崩潰報告及可找到的產物,確認哪些影格仍能解析,並把缺少原始符號列為恢復限制。

05 建立可複核的產物留存流程

下一次發行前,將留存檢查納入交付,而不是等收到崩潰報告才追找檔案:

  • [ ] 每次分發後保存對應的 .xcarchive,並記錄建置識別資訊、版本及產物位置。
  • [ ] 確認 Archive 內包含主 App、擴充功能與嵌入式框架所需的符號檔;缺少項目時先查明原因再交付。
  • [ ] 將 Archive 與 dSYM 放在團隊可存取的位置,保留足以辨認建置來源的資料夾或清單資訊。
  • [ ] 由另一位團隊成員或另一個工作環境實際取回檔案,確認交接後仍可讀取,而非只憑「上傳完成」訊息判定留存成功。
  • [ ] 發布後以實際崩潰報告抽查 UUID 對應,並記下檢查結果;若報告尚未產生,也至少確認交付清單包含歸檔與符號檔。

遠端 Mac 或 CI 的建置流程也應逐項核對產物實際位置、交付方式和取回權限。不要在沒有實際複核的情況下,假設遠端工作階段結束後 Archive 仍存在,或符號檔會自動備份。你可以先查看 CALMVPS 的方案資訊,再按自己的工作流程確認建置產物如何保存及交接。

如果目前以個人 Mac 手動建置,優點是你能直接管理本機 Archive;但硬碟空間、裝置可用性與人工交接都可能成為留存風險。若改用一般 CI,仍需核對它是否提供你需要的 macOS 建置環境,以及產物如何取回。需要額外 Mac 承接短期建置或發布工作時,遠端租用可作為另一種選項;它不會自動替你建立符號留存流程,也不適合需要實體裝置介面的工作。先查看 CALMVPS 的租用資訊,確認實際交付方式符合你的歸檔與取回需求,再決定是否用它處理後續的 Xcode 建置。