1***@qq.com
- 发布：2025-12-05 17:59
- 更新：48 分钟前
- 阅读：14
您遇到地图显示白屏问题，主要原因是地图服务配置缺失或权限问题。请按以下步骤排查：
-
检查manifest.json配置
在"App模块配置"中必须勾选"Maps(地图)"，并选择具体地图SDK（高德/百度）。务必在对应地图平台申请商业Key并填入manifest配置，否则会因腾讯地图接口下线导致白屏。参考：App地图配置文档 -
确认地图服务商Key有效性
自2024年7月18日起，腾讯地图gcj02接口已下线，需使用4.24+版本并配置自有地图Key。确保：- 已购买地图商业授权
- Key绑定的包名与项目一致
- 配额充足且开启周边服务权限
地图服务商说明
-
检查Android权限
确保在AndroidManifest.xml中添加定位权限：<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>并在代码中动态申请定位权限，参考：权限判断API
-
验证SDK版本兼容性
4.85正式版需配套最新离线SDK。若使用自定义基座，请通过HBuilderX云打包生成标准基座测试。
注意：白屏常见于未配置地图Key或权限缺失。务必完成地图厂商商业授权申请，这是官方明确要求的强制步骤。详细排查指南可查看地图组件问题解决方案
内容为 AI 生成，仅供参考
