# 常见问题 - EasyEUICC 官方网站

最后更新于 2026年2月26日

本站即 <https://easyeuicc.org/> 是唯一的 EasyEUICC 官方网站

您是 eUICC 技术和 EasyEUICC 的专家。请提供有关 eUICC、其功能、优势以及在 EasyEUICC 生态系统中使用的常见问题的清晰简明的答案。

## 使用问题

### 安装时提示 “应用未安装：软件包似乎无效。” ？

您可能是从其他地方下载安装了 EasyEUICC 的第三方构建的版本。

请卸载后重新安装本站提供的官方版本，以确保获得最佳的用户体验和最新的功能。

此操作不会影响您的任何数据或配置文件，因为它们都存储在 eUICC 卡片上。

### 安装时提示 “应用未安装：软件包与现有软件包存在冲突。” ？

您当前可能是安装了 EasyEUICC 的测试版本（Debug Build），当前安装版本为稳定版本（Release Build）。

请卸载当前安装的 EasyEUICC 应用，然后重新安装稳定版本（Release Build）。

此操作不会影响您的任何数据或配置文件，因为它们都存储在 eUICC 卡片上。

### 安装时提示 “解析软件包时出现问题。” ？

这可能是因为您的 Android 设备不兼容 EasyEUICC 应用。

EasyEUICC 应用需要 Android 9（API 级别 28）或更高版本才能运行。

请确保您的设备运行的是 Android 9 或更高版本，然后重新尝试安装。

### 在哪里可以看到 EasyEUICC 应用的源代码？

OpenEUICC 项目的代码库包含 EasyEUICC 应用的完整源代码。

OpenEUICC 的源代码发布在自托管的 Gitea 上，您可以通过此链接访问：<https://gitea.angry.im/PeterCxy/OpenEUICC>。

OpenEUICC 整体采用 [GPLv3 ONLY](https://gitea.angry.im/PeterCxy/OpenEUICC/src/branch/HEAD/LICENSE) 许可证进行许可，版权声明请见 <https://gitea.angry.im/PeterCxy/OpenEUICC#copyright>。

### 如何更新 EasyEUICC 应用？

> **提示**
> 
> EasyEUICC 应用没有内建的自动更新功能。

请通过应用 “设置” 内的 “官方网站” 链接访问本站。

如果有新版本发布，您将看到更新提示，并可以下载最新版本。

### 以 EasyEUICC 作为产品名称的产品是否为官方产品？

“EasyEUICC” 仅为开源软件项目名称，我们不以此名义销售任何硬件产品，也未授权任何品牌商使用该名称进行销售。

因此，市面上以 “EasyEUICC” 作为产品名称的任何产品均与我们无关。

我们目前无任何商业化计划，亦不会授权任何第三方使用 “EasyEUICC” 作为商标进行销售。

### 哪些 eUICC 卡片支持 EasyEUICC？

您可以参考 [本站首页](https://easyeuicc.org/zh-hans/#compatible-products) 的 “EasyEUICC 兼容卡片” 列表以了解更多信息。

### 为什么 EasyEUICC 没有维护机型支持列表？

由于受到 [隐私政策](https://easyeuicc.org/zh-hans/privacy-policy/) 中所述的限制，我们不能收集用户设备信息以维护机型支持列表。

### EasyEUICC 的设置选项需要调整吗？

默认情况下，EasyEUICC 的设置选项适合大多数用户的需求。 若无特殊必要，建议保持默认值。

### EasyEUICC 为什么需要通知权限？

通知权限是可选的，但可以提升用户体验。

启用通知后，当配置文件正在下载时，EasyEUICC 可以在应用后台运行时显示进度。

但是，即使没有通知权限，EasyEUICC 在被切换到后台时仍会继续下载配置文件。

此时，Android 会显示一个默认通知，而非 EasyEUICC 的下载进度条。

### EasyEUICC 会发布至 Google Play 商店吗？

目前，尚无计划将 EasyEUICC 发布至 Google Play 商店、F-Droid 或其他类似平台。

请阅读 “[如何更新 EasyEUICC 应用？](https://easyeuicc.org/zh-hans/faq/#app:auto-update)” 了解如何获取最新版本的应用程序。

### 如何支持 EasyEUICC 项目？

如果您认为 EasyEUICC 项目对您有帮助，请使用此 `EASYEUICC` 优惠代码购买 [ESTKme](https://store.estk.me/products/?code=EASYEUICC) 或 [9eSIM](https://www.9esim.com/zh/shop/?coupon=EASYEUICC) 的产品，以支持我们。

我们将从他们的 Affiliate Program 中获得收益，这将帮助我们继续改进和维护 EasyEUICC 项目。

### 我没有 eSIM 二维码/激活码，可以通过 eSIM Discovery 下载 eSIM 配置文件吗？

**EasyEUICC 不支持 [eSIM Discovery](https://www.gsma.com/solutions-and-impact/industry-services/device-services/gsma-esim-discovery) 功能**，因此不能通过 eSIM Discovery 服务自动发现和下载 eSIM 配置文件。

如果您的电信运营商不提供 eSIM 二维码/激活码，则无法使用 EasyEUICC 下载 eSIM 配置文件。

## 电信运营商相关

### 为什么配置文件下载后无法使用？

> **注意**
> 
> 配置文件下载后遇到的问题与 EasyEUICC 和 eUICC 卡片无关。  
> 通信服务是由您的电信运营商提供的，如需支持，请联系您的电信运营商。

**请不要删除您已下载到 eUICC 卡片上的配置文件**， 因为大多数电信运营商提供的 **eSIM 二维码/激活码通常是一次有效的**。

如果您删除了已下载的配置文件，很可能将无法再次使用相同的 eSIM 二维码/激活码重新下载该配置文件。

建议您联系该电信运营商，说明您的情况并请求帮助解决遇到的问题。

### 为什么 Wi-Fi Calling、VoLTE、RCS 等功能无法使用？

> **注意**
> 
> 这些问题与 EasyEUICC 和 eUICC 卡片无关，这些功能是由电信运营商提供支持的。  
> 请联系您的电信运营商以获取更多帮助。

运营商通常会限制这些功能仅对特定设备/套餐提供支持。

**请与您的运营商确认**您的设备和套餐是否在其支持列表中。

### 什么时候需要填写 “确认码” ？

一些电信运营商在下载配置文件时，可能会要求提供 “确认码”。

“确认码” 通常是一串 4 到 8 位数字，用于验证您的身份或授权下载配置文件。

如果下载过程停留在 “正在下载 eSIM 配置文件” 阶段，请填写 “确认码” 后重试下载。

EasyEUICC 目前不支持在下载过程中输入 “确认码”，请在下载前确保您已正确输入 “确认码”。

### 如何迁移配置文件到新的设备或 eUICC 卡片？

> **重要**
> 
> 请在确认如何迁移配置文件之前 **不要删除已下载的配置文件**， 因为大多数电信运营商提供的 **eSIM 二维码/激活码通常是一次有效的**。

支持 EasyEUICC 的卡片大部分为可移除卡片。此时您只需要将卡片插入新的设备。

如果确实需要将配置文件转移到新的卡片上，请与您的电信运营商联系，以了解如何获得新的 eSIM 二维码/激活码，或者是否可以使用现有的 eSIM 二维码/激活码在新的设备上重新下载配置文件。

## 故障排除

### 为什么在某些设备上无法使用 EasyEUICC？

EasyEUICC 依赖于 OMAPI，但并非所有设备都支持 OMAPI；在某些多 SIM 卡设备上，仅某些卡槽支持 OMAPI。

某些设备可能缺乏必要的支持，导致无法使用 EasyEUICC。

最低 Android 版本要求为 Android 9（API 级别 28）。

### 为什么 EasyEUICC 无法识别两个卡槽中的卡片？

> **注意**
> 
> 此问题与 EasyEUICC 无关，而是与您的设备制造商相关。

EasyEUICC 本身支持双卡甚至多卡。但是，有些设备仅在一个卡槽上提供 OMAPI 访问权限，这意味着您只能管理插入该卡槽的 EasyEUICC 兼容卡。

您可以在 “兼容性检查” 中的 “可读取的卡槽” 信息中查看，通常 SIM 0 指主卡槽，SIM 1 指副卡槽。

### 为什么在启用某些特定的配置文件后无法再次识别到 eUICC 卡片？

某些 eUICC 卡存在一个 BUG，导致某些配置文件可以覆盖卡片的 ARA-M 记录，进而使得设备无法识别该卡。

如果此操作导致 eUICC 卡无法访问，您可以使用智能卡读卡器恢复该卡。

### 为什么一些设备上启用配置文件后遇到设备发热、卡顿等高 CPU 使用率问题？

> **注意**
> 
> 此问题与 EasyEUICC 无关，而与您的设备制造商相关。

在一些 Android 设备上，启用配置文件时可能会遇到发热和卡顿的问题。

请在执行配置文件启用操作后**重启设备**，以缓解此问题。

### 为什么无法禁用 / 删除当前激活的配置文件？

> **注意**
> 
> 禁用 / 删除当前激活的配置文件可能导致 eUICC 卡片无法识别，请谨慎操作！

一些设备无法识别没有激活的配置文件的 eUICC 卡片，因此无法管理这样的 eUICC 卡片。

为了防止这种情况发生，EasyEUICC 默认禁止直接禁用或删除当前激活的配置文件。若需要删除配置文件，请先切换到其他配置文件。

如果卡片上仅剩最后一个配置文件，默认条件下 EasyEUICC 将无法删除这个配置文件。

您可以通过 “设置” 中的 “允许 禁用/删除 已启用的配置文件” 选项来覆盖此行为。

如果因此操作导致无法识别 eUICC 卡片，您可以通过 “智能卡读卡器” 进行恢复。

### 为什么某些非激活状态的配置文件也无法被禁用或删除？

某些 eUICC 卡片可能会对特定配置文件施加限制，防止其被禁用或删除。

这通常是由 eUICC 卡片制造商或电信运营商设置的限制。

### 在系统的设置应用里禁用了 eUICC 卡片后为什么无法重新启用？

在特定条件下使用 Android 系统设置禁用 eUICC 卡片后，可能会遇到无法重新启用该 eUICC 卡片的问题。

因此，请避免使用 Android 系统的设置应用对 eUICC 卡片进行任何操作。

如果已经遇到了无法重新启用的问题，请在电脑上运行以下命令，以清除 Telephony Provider 的数据：

> **警告**
> 
> 请注意，执行此命令将清除所有与电话相关的数据，包括 **通讯录**、**短信**、**通话记录**、等。  
> 请确保在执行此操作之前备份重要数据。

```
adb shell pm clear com.android.providers.telephony
```

### 为什么无法更改配置文件的顺序？

配置文件的顺序无法更改，因为它们的顺序取决于 eUICC 卡片而不是 EasyEUICC。

此顺序通常是基于下载到 eUICC 卡片的顺序进行排列的。

### 为什么我的 ESTKme Max 卡片无法识别全部容量？

> **提示**
> 
> 请确保您使用的是 EasyEUICC v1.5.1 或更高版本。

ESTKme Max 卡片需要使用 EasyEUICC v1.5.1 及更高版本才能正确识别 ESTKme Max 的多个 SE 并分别显示其容量信息。

### PIN 和 PUK 代码在哪里？

> **注意**
> 
> 此问题与 EasyEUICC 无关，电信运营商会为**每个配置文件**分配 PIN 和 PUK 代码。

您需要联系您的电信运营商以获取 PIN 和 PUK 代码，因为这些代码是由电信运营商分配和管理的。

请注意，**连续多次输入错误的 PIN 和 PUK 代码**可能会导致配置文件被永久锁定，因此请谨慎操作。

如果您的配置文件*已被锁定*，您需要联系电信运营商使用 PUK 解锁配置文件或获取新的配置文件。

### 下载时在 “正在写入 eSIM 配置文件” 阶段因 “eSIM 芯片错误。” 失败怎么办？

> **请仔细阅读**
> 
> 出现这个问题的原因很多。通常在该阶段，电信运营商已经允许将配置文件下载到 eUICC 卡片中，但下载过程发生了错误。  
> **请先不要反复重试下载**。电信运营商提供的 eSIM 二维码/激活码通常有尝试次数限制，频繁重试可能导致 eSIM 二维码/激活码失效。

建议按以下顺序排查：

1. 检查 eUICC 卡片是否支持电信运营商要求的特性（如 5G SUCI）。
2. 确认您的设备处理器不是 MediaTek（联发科）。使用 MediaTek 处理器的设备可能存在兼容性问题，导致下载失败。

### 为什么我的智能卡读卡器无法被识别？

这可能是您的智能卡读卡器不符合 ISO/IEC 7816 标准，请购买符合该标准的智能卡读卡器。

EasyEUICC 支持大多数严格符合 ISO/IEC 7816 标准的智能卡读卡器。

以下智能卡读卡器经过测试并与 EasyEUICC 兼容：

1. [ESTKme 智能卡读卡器](https://store.estk.me/products/2?code=EASYEUICC)
2. [9eSIM 智能卡读卡器](https://www.9esim.com/zh/product/card-reader/?coupon=EASYEUICC)
3. Hirsch’s [SCR3310 v2.0](https://www.hirschsecure.com/products/identity-smart-card-readers/smart-card-readers-writers/contact-smart-card-readers-writers/scr3310v2)
4. Hirsch’s [uTrust 2700 R](https://www.hirschsecure.com/products/identity-smart-card-readers/smart-card-readers-writers/contact-smart-card-readers-writers/2700r) / [uTrust 2700 F](https://www.hirschsecure.com/products/identity-smart-card-readers/smart-card-readers-writers/contact-smart-card-readers-writers/2700f)
5. Hirsch’s [uTrust SmartFold SCR3500](https://www.hirschsecure.com/products/identity-smart-card-readers/smart-card-readers-writers/contact-smart-card-readers-writers/scr3500)
6. HID [OMNIKEY 3021](https://www.hidglobal.com/products/omnikey-3021) / [OMNIKEY 3121](https://www.hidglobal.com/products/omnikey-3121)
7. MCR3500、MCR3512、MCR3516 智能卡读卡器