為什麼你的旅遊eSIM QR碼失敗：SM-DP+、匹配ID、確認碼和激活時間

一個“無法使用”的旅遊eSIM QR碼很少是因為像素方塊損壞。更常見的是，攝像頭能夠正常讀取代碼，然後手機的本地配置助手 (LPA) 在GSMA消費者遠端SIM配置路徑中的某處失敗：錯誤或重複使用的激活數據，沒有通往SM-DP+的路徑，確認碼不匹配，中斷的Bound Profile Package下載，或無法接受另一個配置文件的設備。

該路徑是為消費者設備定義的，位於GSMA SGP.22（RSP 技術規範）。QR 只是用來傳遞的包裝 啟用碼。了解該碼的編碼內容，以及掃描後必須發生的事情，可以將模糊的“無效啟用碼”畫面轉化為可診斷的階段。

這部分內容專注於 消費者 RSP 安裝/啟用：如何排序、認領和下載配置檔案。這不是 SGP.32 IoT 的解釋，也不是多 IMSI 覆蓋地圖的深入探討。

掃描旅遊 eSIM QR 時實際發生的事情 #

從高層次來看，消費者 eSIM 設置是人們隨意稱為“啟用”的三個不同工作：

1. 認領 / 下載, LPA 聯繫 SM-DP+，進行身份驗證，並將綁定的配置包下載到 eUICC。
2. 安裝, eUICC儲存配置檔（在ISD-P中的操作憑證）。
3. 網路啟用, 配置檔啟用後，調製解調器會連接到訪問或家庭網路（計劃規則、覆蓋範圍和首次連接時間因發行者而異）。

GSMA的消費者RSP架構以SM-DP+（訂閱管理器，數據準備+）: 負責準備配置檔包，保護它們，可能將它們分配給指定的EID，將受保護的配置檔包綁定到特定的eUICC，並安全地將綁定的配置檔包傳送到設備LPA（SGP.22 v2.7概述; SGP.22 v2.7 PDF)。

您的手機不會通過離線讀取QR而“成為SIM”。QR（或輸入的激活字串）告訴LPA去哪裡以及要認領哪個待處理訂單。配置檔位元組仍需通過互聯網從SM-DP+傳送到LPA，然後再到eUICC。

Apple自己的設置指南對連接的前提條件直言不諱：iPhone在一般情況下需要Wi-Fi網路或熱點來設置eSIM（Apple Support，關於iPhone上的eSIM; Apple Support，若無法設置eSIM）。

啟用碼：SM-DP+ 地址、匹配 ID、可選確認標誌 #

GSMA SGP.22 定義了「啟用碼」為運營商或服務提供商發行的信息，以便最終用戶可以請求下載和安裝配置文件。在 QR 形式中，它以「LPA:」為前綴；其有效載荷是一個以「$」分隔的字串（SGP.22 v1.2 §4.1；結構仍在後續 SGP.22 修訂版中記錄於啟用碼/匹配 ID 下，包括v2.7）。

概念上（示意佈局，非真實憑證）：

``文字 LPA:1$smdp.example.com$MATCHING-ID-TOKEN[$SM-DP+-OID][$1] ``

行業解析器總結了相同的消費者格式：LPA:1$SM-DP+-address$token, 帶有可選的 OID 和確認碼標誌（iot.cards 啟用碼解析器說明)。手動輸入界面只是將相同的字段分為SM-DP+ 地址, 啟用碼（匹配 ID），和可選的確認碼（手動 SM-DP+ 輸入說明；SimFinder 手動碼指南)。

匹配 ID 與確認碼（它們不是同一回事） #

• 匹配 ID / 啟用碼標記, 用於識別 SM-DP+ 上的*待下載訂單*。SGP.22 將匹配 ID 視為架構文檔中的啟用碼標記；它必須在運營商/SM-DP+ 範圍內是唯一的，以便服務器僅處理已知的有效請求（SGP.22 v1.2 §4.1.1)。
• 確認碼, 可選的最終用戶密碼，用於當運營商要求更強的確認時，SM-DP+ 才會釋放配置文件。SGP.22 指出，如果使用確認碼，它應該與啟用碼分開提供 (SGP.22 v1.2 §3.1.1.3)。LPA會對您輸入的內容進行雜湊處理，並在下載驗證過程中由SM-DP+進行驗證。

混淆這些欄位，或在未發出確認碼時自行創造一個，這是典型的「無效啟動碼」情況。

常見的旅行eSIM QR / 安裝失敗模式 #

錯誤字串不是通用的GSMA狀態詞彙。Apple、Google、OEM和發行者對相同的底層問題有不同的表述。將該表格視為由RSP機制和公共支持模式支持的分類，而不是每個品牌都使用相同措辭的保證（不）eSIM Ready QR 疑難排解；Apple 支援故障排除).

旅行品牌反覆遇到的故障模式說明 #

錯誤或過期的 QR。 截圖會壓縮模組。轉發的聊天圖片會裁剪安靜區域。舊的電子郵件可能指向已取消的匹配 ID。請優先選擇發行者的當前訂單頁面或原始附件。

需要網路下載。 掃描是本地的; ES9+ 到 SM-DP+ 的流量則不是。飛行模式下無線電關閉、未接受的酒店強制入口網站或不穩定的機場 Wi-Fi 通常在成功掃描後中止(Apple 連接性前提; 面向開發者的 SM-DP+ 配置說明).

配置檔下載中斷。 SGP.22 描述了 SM-DP+、LPA 和 eUICC 之間的多步驟會話下載過程。通訊失敗可能會導致伺服器狀態可重試或不可重試，這取決於綁定進度；面向旅行者的品牌在部分成功後經常看到“已使用”。在要求新的 QR 之前，請檢查是否已經出現配置檔（SGP.22 下載/安裝程序; 與發行者無關的分診).

確認碼不匹配。 當啟用碼的確認標誌設置時，LPA 必須提示；SM-DP+ 驗證雜湊的確認材料。過多的錯誤輸入可以由 SM-DP+ 限制速率（SGP.22 記錄了對下載流程中過多錯誤確認碼輸入的保護）。

時機：旅行前安裝與在目的地安裝 #

兩個時鐘會混淆：

1. RSP 下載時鐘, 當 LPA 可以連接到 SM-DP+ 並完成安裝時。
2. 商業有效性時鐘, 當*計劃的付費使用窗口*開始時（安裝時間、首次網絡連接或固定日曆日期，發行者條款控制)。

公共旅行指導趨向於第一個時鐘的實用規則：在您還有穩定的Wi-Fi時安裝, 在家中或登機前，以免在降落後沒有數據時調試SM-DP+的可達性（旅行前的iPhone設置指南; QR故障診斷)。

為什麼這在技術上很重要：

• 配置文件下載需要IP連接到SM-DP+ FQDN（HTTPS/TLS），無論旅行線路是否已啟用。
• 機場和酒店的Wi-Fi通常會設置強制登錄頁面；在開始添加eSIM之前完成登錄。
• 安裝後，許多旅行者會將旅行配置文件安裝但禁用（或未選擇數據線）直到到達目的地，這樣您就可以將“eUICC上的字節”與“開始消耗有效期”分開。始終閱讀計劃的開始規則；有些產品在安裝時開始，有些則在首次連接時開始。

在目的地安裝如果您有可用的熱點、伴隨數據線或免費Wi-Fi，仍然可以工作，但您將把時差、強制登錄頁面和支持延遲疊加在RSP的複雜性之上。飛行前安裝可以減少這些問題。

當QR是問題（而不是配置文件）時的手動輸入 #

如果方形無法掃描但發行者打印了SM-DP+和激活詳細信息：

1. 打開系統添加eSIM / 添加蜂窩計劃流程（而不是隨便的QR工具）。
2. 選擇手動輸入詳細資料。
3. 貼上 SM-DP+ 地址 作為裸 FQDN。
4. 貼上 匹配 ID / 啟動代碼 到啟動代碼欄位。
5. 輸入 確認碼，僅當發行者單獨提供時。

Apple 文件記錄了在 QR 設定過程中，當運營商要求時的確認碼提示（Apple, 設定 eSIM / 關於 eSIM)。Android 路徑因 OEM 而異，但揭示了相同的三個概念欄位。

請勿從隨機博客中抓取“SM-DP+ 地址列表”。權威地址是綁定到*您的*待處理訂單的地址。

旅行者應該注意的事項 #

• QR 編碼了一個 啟動代碼，而不是配置文件本身。
• SM-DP+ 地址 = 位置; 匹配 ID = 哪個順序; 確認碼 = 可選的第二因素，通常是分開的。
• 您需要穩定的網路來下載，即使您計劃稍後啟用該線路。
• 在重新掃描“已使用”代碼之前，請尋找已經存在的配置文件。
• 在旅行前，當計劃條款允許時，在受信任的 Wi-Fi 上安裝；然後在到達時管理啟用和數據線選擇。
• 捕捉準確的錯誤文本、設備型號/操作系統和嘗試時間以供支持，切勿在公共論壇中發布完整的 LPA 字串或 QR 圖像。

旅行 eSIM 品牌和運營商應該注意的事項 #

• 發送能夠正確解析的激活碼（LPA:1$…），並在同一封電子郵件中提供手動字段備選方案。
• 如果需要確認碼，請分開發送，並明確標記字段（SGP.22 指導）。
• 記錄有效性是從安裝, 首次連接, 還是從日曆日期開始，時間混淆會導致錯誤的“激活失敗”票據。
• 訓練支持人員詢問：掃描 vs 下載 vs 安裝 vs 連接；配置文件已存在？；Wi-Fi/捕獲門戶？；確認標誌 vs 匹配 ID 混淆。
• 優先考慮重新發行工作流程，檢查 SM-DP+ 訂單狀態，然後再在每次重試時使用新的匹配 ID。
• 將 OEM LPA 特點和運營商設置更新視為一級運行手冊，而不是邊緣案例。

首先進行標準教育：消費者 RSP 互操作性來自 SGP.22 形狀的 SM-DP+/LPA/eUICC 行為。品牌用戶體驗是您如何清晰地為在 B17 門口疲憊的旅行者繪製這些階段。

Roamify 的溫馨提示 #

Roamify 發布旅行連接教育，以便安裝失敗可以診斷，而不是神秘的。當您評估任何旅行 eSIM（包括我們的）時，優先考慮清晰的激活說明、誠實的有效性時間和能夠講解 SM-DP+/匹配 ID 而不發明功能的支持。始終使用您的訂單實際提供的激活碼和時間規則。

---

旅行 eSIM QR 失敗通常不是“壞條碼”。QR 編碼了一個 GSMA SGP.22 激活碼：SM-DP+ 地址（下載位置）+ 匹配 ID（哪個待處理配置文件）+ 可選的確認碼標誌。

您的手機的 LPA 仍然需要穩定的網路來提取綁定配置文件包。常見問題：將 https:// 粘貼到 SM-DP+，重複使用/過期的匹配 ID，確認碼混淆，捕獲門戶 Wi-Fi，中斷的下載看起來“已使用”，以及在降落後才安裝而沒有數據。

在計劃條款允許的情況下，在您飛行前在受信任的 Wi-Fi 上安裝，然後在到達時啟用該線路。

了解更多：https://www.getroamify.com/en/blogs/sm-dp-plus-travel-esim-activation-failures

• https://www.gsma.com/solutions-and-impact/technologies/esim/gsma_resources/sgp-22-v2-7/
• https://www.gsma.com/solutions-and-impact/technologies/esim/wp-content/uploads/2026/04/SGP.22-v2.7-.pdf
• https://www.gsma.com/newsroom/wp-content/uploads/SGP.22_v1.2.pdf
• https://support.apple.com/en-us/118669
• https://support.apple.com/en-us/102478
• https://iot.cards/en/resources/tools/esim-activation-code-parser
• https://roamless.com/blog/sm-dp-address
• https://sim-finder.com/en/guides/manual-code/
• https://esim.chatgpt.org.uk/en/guides/esim-qr-code-not-working/
• https://dev.to/purasim/esim-activation-qr-lpa-and-sm-dp-provisioning-for-developers-2980
• https://zenroam.co/blog/how-to-activate-an-esim-on-iphone