模拟器调用getPhoneNumber接口失败，提示系统错误(-10000)

Question

在使用模拟器调用 `getPhoneNumber` 接口时，常出现“系统错误(-10000)”的提示。该问题多由模拟器环境不支持真机API引起，尤其在微信小程序、uni-app等跨平台框架中较为常见。`getPhoneNumber` 接口通常需用户授权并依赖客户端原生能力，而多数模拟器未模拟相关权限与原生模块，导致调用失败。此外，开发工具版本过低或未登录调试账号也可能引发该错误。建议开发者优先使用真机调试，或在模拟器中模拟授权流程与数据返回，避免直接调用原生接口。

Answer 1

一、问题现象：模拟器调用 getPhoneNumber 报错“系统错误(-10000)”

在使用微信小程序、uni-app等跨平台开发框架进行开发时，开发者在模拟器中调用 getPhoneNumber 接口时，常常遇到“系统错误(-10000)”的提示。该错误通常出现在调试阶段，尤其在使用开发工具内置的模拟器时更为常见。

二、问题分析：从浅入深理解错误根源

该错误的根本原因在于：

• 模拟器环境限制：模拟器无法完整模拟真机的原生能力，尤其是涉及用户授权、系统权限、加密通信等敏感操作。
• 接口依赖原生支持：getPhoneNumber 是一个需要用户授权并依赖客户端原生能力的接口，模拟器无法模拟这些授权流程。
• 工具版本问题：部分低版本的开发工具或未登录调试账号时，可能无法正常调用部分API。

三、问题影响范围与常见场景

该问题主要出现在以下场景中：

开发框架	常见问题表现	是否推荐使用模拟器
微信小程序	getPhoneNumber 接口报错 -10000	否
uni-app	uni.login + uni.getUserInfo 可能失败	否
H5/原生App	较少出现，因浏览器/原生环境支持更好	是

四、解决方案与调试建议

为解决该问题，开发者可采取以下策略：

1. 优先使用真机调试：对于涉及敏感权限或原生能力的接口，应优先在真机上测试。
2. 模拟器中模拟数据：在模拟器中通过 mock 数据模拟授权流程与接口返回结果。
3. 检查开发工具版本：确保使用的开发工具为最新版本，并已登录调试账号。
4. 使用条件编译处理平台差异：例如在 uni-app 中使用 #ifdef H5 或 #ifdef MP-WEIXIN 区分不同平台逻辑。

五、模拟授权流程的代码示例

以下是一个在 uni-app 中模拟 getPhoneNumber 接口返回结果的示例代码：

// #ifdef H5
function getPhoneNumberMock() {
  return {
    phoneNumber: '13800001111',
    purePhoneNumber: '13800001111',
    countryCode: 'CN'
  };
}
// #endif

// #ifdef MP-WEIXIN
function getPhoneNumberReal(e) {
  uni.getPhoneNumber({
    success: res => {
      console.log('真实手机号：', res);
    },
    fail: err => {
      console.error('获取失败：', err);
    }
  });
}
// #endif
  

六、流程图：模拟器与真机调用 getPhoneNumber 的差异

graph TD
    A[调用 getPhoneNumber] --> B{是否在真机上?}
    B -->|是| C[调用微信原生授权界面]
    B -->|否| D[模拟器无原生模块]
    D --> E[触发系统错误 -10000]
    C --> F[用户授权成功]
    F --> G[返回加密手机号数据]