9***@qq.com
9***@qq.com
  • 发布:2026-03-26 14:52
  • 更新:2026-03-26 14:54
  • 阅读:35

【报Bug】uni-wifi 使用Hbuilder v5.04云打包以后ios无法获取wifi信息了

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Mac

PC开发环境操作系统版本号: 15.6.1

HBuilderX类型: 正式

HBuilderX版本号: 5.04

手机系统: iOS

手机系统版本号: iOS 26

手机厂商: 苹果

手机机型: IPhone 16 Pro

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

uni.getConnectedWifi({
success: (res) => {
if (lbert) {
utils.showToast('WIFI更新成功', 'success');
}
this.setData({
ispositioning: true
});
if (res.wifi) {
res.wifi.ok = true;
this.setData({
wifi_err: ''
});
resolve(res.wifi);
} else {
resolve({
ok: false
});
}
},
fail: (err) => {
console.error(err);
if (err.errCode == 12006) {
this.setData({
ispositioning: false
});
if (lbert) {
utils.showToast('未打开手机定位,WIFI更新失败', 'error');
}
}
this.setData({
wifi_err: err
});
resolve({
ok: false
});
}
});
});

预期结果:

获取到连接的wifi信息

实际结果:

{
    "code": 0,
    "errSubject": "uni-wifi",
    "userInfo": {},
    "message": "",
    "errCode": 12010,
    "errMsg": "unknown error",
    "name": "Error",
    "domain": ""
}

bug描述:

使用Hbuilder 4.87 云打包时没有问题,更新Hbuilder 5.04以后调用uni.getConnectedWifi 报错

"Access WiFi Information" capability已开启

NSLocationWhenInUseUsageDescription等权限也已配置

2026-03-26 14:52 负责人:DCloud_iOS_LZY 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

作为DCloud官方人员,对这个bug反馈进行如下评审:

反馈内容完整性评审

信息完整性评价:基本合格,但缺少关键复现要素

缺失的必要信息

  1. 代码示例不完整:仅提供了uni.getConnectedWifi方法名,缺少完整的调用代码(包括success/fail回调、complete处理等)以及manifest.json中关于WiFi权限的配置。

  2. 复现步骤过于简略:只有方法名,没有具体操作流程(如是否先调用uni.startWifi、是否申请定位权限等)。

  3. 权限配置信息缺失:iOS平台获取WiFi信息需要特殊的权限配置,反馈中未提供manifest.json中是否开启"Access WiFi Information"能力以及定位权限配置。

  4. iOS版本号存疑:填写的"iOS 26"可能是笔误或测试版系统版本号,需要确认具体版本。

已提供的关键信息

  • 版本对比明确(4.87正常 vs 5.04异常)
  • 提供了详细的错误返回体(errCode: 12010, errSubject: uni-wifi)
  • 设备信息完整(iPhone 16 Pro, Vue2)

Bug成立性分析

根据知识库内容,该问题可能涉及以下技术点

  1. iOS权限要求:根据WiFi功能模块文档,iOS平台获取WiFi信息需要:

    • 开启"Access WiFi Information"能力(需在苹果开发者网站配置App ID并重新生成profile)
    • iOS 13及以上系统需先获取系统定位权限
  2. 历史相关问题:在对话知识库中发现,历史版本(4.76)曾出现uni_modules/uni-wifi编译错误(cannot find type 'wifioption' in scope),但当前反馈的是运行时错误(errCode: 12010),与历史编译问题不同。

  3. Vue2兼容性:HBuilderX 5.x系列对Vue2的支持可能存在变动,但知识库中未明确记载5.04版本废弃Vue2对uni-wifi的支持。

官方评审意见

当前反馈无法直接确认为有效Bug,需要补充以下信息后进一步判断:

  1. 请提供manifest.json中iOS权限配置截图或代码,确认是否包含:

    • "Access WiFi Information" capability已开启
    • 定位权限描述字段(NSLocationWhenInUseUsageDescription等)
  2. 请提供完整的复现代码,包括:

    • 调用uni.getConnectedWifi的完整代码(含fail回调)
    • 是否先调用了uni.startWifi
    • 是否申请了定位权限(iOS 13+必需)
  3. 请确认iOS系统版本:"iOS 26"是否为"iOS 18"的笔误,或是Beta版本系统。

  4. 请验证4.87版本打包的IPA在当前设备上是否仍可正常运行,以排除iOS系统升级导致的问题。

初步判断:从错误码12010和"unknown error"来看,更可能是iOS权限配置或签名证书中的WiFi能力未正确配置,而非HBuilderX 5.04本身的问题。建议先检查WiFi功能模块文档中的iOS配置要求,特别是苹果开发者后台的Capability设置和重新生成的profile文件是否正确嵌入到云打包配置中。

如确认权限配置无误且4.87打包的APP在同一设备上可正常运行,请补充上述信息后重新提交,我们将安排进一步排查。

内容为 AI 生成,仅供参考

要回复问题请先登录注册