为什么你的旅行eSIM二维码无法使用：SM-DP+、匹配ID、确认码和激活时间

一个“无法使用”的旅行eSIM二维码很少是因为像素方块损坏。更常见的是，摄像头能正常读取代码，然后手机的本地配置助手 (LPA) 在GSMA消费者远程SIM配置路径中的某处失败：错误或重复使用的激活数据，没有通往SM-DP+的路径，确认码不匹配，中断的绑定配置文件包下载，或设备无法接受另一个配置文件。

该路径是为消费者设备定义的，见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支持，关于iPhone上的eSIM; Apple支持，如果你无法设置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二维码/安装失败模式 #

错误字符串不是通用的GSMA状态词汇。Apple、Google、OEM和发行商对相同的底层问题的措辞各不相同。将表格视为由RSP机制和公共支持模式支持的分类，而不是每个品牌都使用相同措辞的承诺（eSIM Ready QR故障排除；Apple Support故障排除）。

旅行品牌反复遇到的故障模式说明 #

错误或过期的 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故障诊断)。

为什么这在技术上很重要：

• 配置文件下载需要与SM-DP+ FQDN（HTTPS/TLS）的IP连接，无论旅行线路是否已启用。
• 机场和酒店的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 指导）。
• 记录有效期是从安装, 首次连接, 还是从日历日期开始，时间混淆会导致错误的“激活失败”票据。
• 培训支持人员询问：扫描与下载与安装与连接；配置文件是否已存在？；Wi-Fi/门户网站？；确认标志与匹配 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