uniapp 使用腾讯地图打包显示没有maps模块如何解决？

在uniapp中使用腾讯地图开发时，打包后提示"没有maps模块"，应该如何解决？已经按照官方文档配置了manifest.json和引入SDK，但依然报错。具体表现是H5端正常，但打包成APP后地图无法显示。请问需要额外配置哪些参数？是否有完整的操作步骤或兼容性注意事项？

2 回复

在HBuilderX中检查manifest.json，确保已勾选腾讯地图模块。若已勾选，尝试删除unpackage文件夹后重新打包。


在 UniApp 中使用腾讯地图时，打包后提示“没有 maps 模块”通常是由于配置缺失或平台差异导致的。以下是常见原因和解决方案：

1. 检查 manifest.json 配置

在 manifest.json 中正确配置腾讯地图的 AppKey 和模块声明：

{
  "mp-weixin": {
    "appid": "你的微信小程序AppID",
    "setting": {
      "urlCheck": false
    },
    "permission": {
      "scope.userLocation": {
        "desc": "用于地图定位功能"
      }
    },
    "requiredPrivateInfos": ["getLocation"],
    "plugins": {
      "tencentMap": {
        "version": "1.0.0",
        "provider": "wx76a9a06e5b4e693e"
      }
    }
  }
}

2. 引入并正确使用地图组件

在页面中声明并使用 <map> 组件：

<template>
  <view>
    <map 
      :latitude="latitude" 
      :longitude="longitude" 
      :markers="markers"
      style="width: 100%; height: 300px;">
    </map>
  </view>
</template>

<script>
export default {
  data() {
    return {
      latitude: 39.908823,
      longitude: 116.397470,
      markers: [{
        id: 1,
        latitude: 39.908823,
        longitude: 116.397470,
        title: '北京市'
      }]
    }
  }
}
</script>

3. 配置微信小程序权限

在微信公众平台配置：

  • 进入【开发】-【开发管理】-【接口设置】
  • 启用「地理位置」和「地图」相关接口

4. H5 平台特殊处理

H5 平台需在 manifest.json 中配置 H5 地图提供商：

{
  "h5": {
    "publicPath": "./",
    "template": "template.h5.html",
    "sdkConfigs": {
      "maps": {
        "qqmap": {
          "key": "你的腾讯地图H5密钥"
        }
      }
    }
  }
}

5. 检查打包配置

  • 确保打包时勾选了「地图」模块
  • 在 HBuilderX 中：运行 → 运行到小程序模拟器 → 勾选所需模块

6. 常见问题排查

  • 密钥配置错误：确认腾讯地图密钥正确且对应平台（小程序、H5 等）
  • 权限未开启：在小程序后台开启地理位置权限
  • 组件使用错误：确保使用 <map> 而非第三方组件

补充说明

  • 腾讯地图小程序插件需通过微信公众平台添加
  • H5 平台可能需要单独申请 H5 地图密钥
  • 真机调试时需开启定位权限

按照以上步骤配置后，重新打包即可正常使用地图功能。

回到顶部