2***@qq.com
2***@qq.com
  • 发布:2026-02-06 09:28
  • 更新:2026-02-06 19:24
  • 阅读:34

【报Bug】uniapp ios的app ,引入map高德地图,就会闪退

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Mac

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

HBuilderX类型: 正式

HBuilderX版本号: 4.87

手机系统: iOS

手机系统版本号: iOS 26

手机厂商: 苹果

手机机型: 14promax

页面类型: nvue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

示例代码:

就直接新建个uniapp项目

把map标签引入nvue文件,用ios基座运行,就会闪退

<template>
<view>
<map id="myMap" />
</view>
</template>

<script>

</script>

<style>

</style>

操作步骤:

就直接新建个uniapp项目
<map id="indexMap" ></map>
把map标签引入nvue文件,用ios基座运行,就会闪退

预期结果:

正常打开app,不闪退

实际结果:

引入了map组件的nvue文件,直接app导致闪退

bug描述:

uniapp ios ,引入map高德地图,运行自定义基座和打包成app , 就都会闪退
我已引入高德key的相关配置,也和高德后台的key值都填写正确

2026-02-06 09:28 负责人:DCloud_UNI_OttoJi 分享
已邀请:
Ask小助手

Ask小助手

需补充平台分类:安卓,ios,鸿蒙; 请提供hbuilderx版本及具体代码示例。
欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

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


一、反馈完整性评估

检查项 状态 说明
BUG 标题 简洁明了,指出“iOS + 高德地图 + 闪退”
BUG 描述 ⚠️ 描述过于简单,仅一句“引入 map 就闪退”,未说明是否已配置高德 key、是否已勾选 maps 模块、是否使用自定义基座等关键信息
代码示例 ⚠️ 仅给出 <map id="indexMap"></map>,未提供完整 nvue 文件结构,也未说明是否配置了 stylescript 部分
复现步骤 ⚠️ 步骤过于简略,未说明是否新建的是 Vue3 项目、是否使用标准基座还是自定义基座、是否已配置 manifest.json 中的地图模块
预期结果 合理,期望不闪退
实际结果 描述清楚,直接闪退
分类信息 ⚠️ 存在明显错误:<br>- PC 系统版本号写为“26.1”,应为 macOS 版本号,如“14.x”<br>- iOS 系统版本写为“26”,应为“17.x”或“18.x”

二、是否构成有效 bug

根据知识库内容:

  • app-maps 明确指出:

    App端使用地图组件需要向高德申请 SDK 资质,获取 AppKey,并在 manifest 中勾选 Maps 模块,填写 AppKey,且包名需与申请时一致。

  • release-archive 中提到:

    iOS 平台曾修复过高德地图 SDK 引起的权限申请问题,但未提及“仅引入 map 标签就闪退”。

  • 对话知识库中也有用户反馈:

    “文档示例直接闪退,升级版本后解决” —— 说明部分闪退问题可能与版本或配置有关。

因此,当前反馈信息不足以确认是否为 bug,更像是未正确配置地图模块或缺失 AppKey导致的崩溃。


三、是否属于基本概念问题

是。用户未提及是否已完成以下必要步骤:

  1. manifest.json → App模块配置中勾选 Maps(地图)
  2. 选择 高德地图 并填写正确的 iOS AppKey
  3. 使用 自定义基座 进行真机调试(标准基座不支持地图)
  4. 确保包名、签名证书与高德后台配置一致

四、官方建议回复(基于知识库)

您好,感谢反馈。根据当前信息,您遇到的“引入 map 组件即闪退”问题,大概率是由于未正确配置地图模块或缺失高德 AppKey 所致

请您按以下步骤自查:

  1. 打开 manifest.json → App模块配置 → 勾选 Maps(地图)
  2. 选择 高德地图,并填写您在高德开放平台申请的 iOS AppKey;
  3. 确保包名、Bundle Identifier 与高德后台配置完全一致;
  4. 使用 自定义基座 真机调试(标准基座不支持地图);
  5. 如仍有问题,请提供完整的 nvue 文件、manifest.json 配置截图及崩溃日志(Xcode 控制台)。

若确认配置无误仍闪退,请补充上述信息,我们将进一步跟进。

参考文档:App端地图使用指南


五、结论

该反馈不构成有效 bug,属于配置缺失或版本兼容性问题,建议用户补充配置信息后重新验证。

内容为 AI 生成,仅供参考
DCloud_UNI_OttoJi

DCloud_UNI_OttoJi - 日常回复 uni-app/x 问题,如果艾特我没看到,请主动私信

我测试 vue3 ios 模拟器 HBuilderX alpha5.0 在 nvue 标准基座使用 map 表现正常,你提供下复现工程

要回复问题请先登录注册