HarmonyOS 鸿蒙Next中map kit不能正常渲染

Map Kit 403 提问总结

一、环境信息

二、当前问题

现象：Map Kit 调用失败，HiLog 报错：

queryTile error: no map permission!

含义：地图鉴权未通过，导致无地图权限。

三、已完成的配置检查

1. AGC (AppGallery Connect)

   • 已开通 Map Kit
   • 已添加 SHA256 指纹（来源：.p7b 证书）
   • 当前配置的 SHA256：55:38:5D:CE:CF:EC:59:ED:ED:B1:D0:E6:A9:9E:51:EF:66:16:43:7A:2A:5F:BE:85:46:A1:B1:0E:C3:7B:62:9A

2. 工程配置

   • agconnect-services.json 已放入 entry/src/main/resources/rawfile/
   • module.json5 中 metadata.client_id = 6917599280681179801（与 AGC App ID 一致）
   • capabilities 已添加 Map Kit：com.huawei.service.mapkit
   • 已声明 ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION、ohos.permission.INTERNET

3. 签名相关

   • 使用 DevEco 自动生成的调试签名
   • keystore：C:\Users\85082\.ohos\config\default_application_xxx.p12
   • profile：C:\Users\85082\.ohos\config\default_application_xxx.p7b
   • keyAlias：debugKey

四、疑点 / 待确认

1. SHA256 来源不一致

   • 听说 AGC 应使用 .p12 签名证书的 SHA256，而不是 .p7b 中的证书
   • 当前 AGC 中配置的 SHA256 来自 .p7b，不确定是否应与 .p12 一致
   • build-profile.json5 中的 storePassword 为 DevEco 加密存储，无法直接用 keytool 获取 .p12 的 SHA256

2. 鉴权失败原因

   • 除 SHA256 外，还有哪些常见原因会导致 no map permission!？
   • 是否需要检查 AGC 中应用的包名、签名等是否完全匹配？

3. agconnect-services.json

   • 是否需在 AGC 重新生成并下载最新配置？
   • 修改 SHA256 后，是否需要重新下载该文件？

五、请求帮助

1. 如何正确获取 .p12 调试签名证书的 SHA256 指纹？（已知 storePassword 为加密值，无法直接用于 keytool）
2. AGC 中 Map Kit 应配置的 SHA256 来自 .p12 还是 .p7b？两者是否必须一致？
3. queryTile error: no map permission! 的常见排查步骤有哪些？
4. 若需在 AGC 中更新 SHA256，修改后是否需要重新下载 agconnect-services.json 并覆盖本地文件？

六、相关文件路径（供参考）

application/build-profile.json5             # signingConfigs
application/entry/src/main/module.json5    # client_id, capabilities, 权限
application/entry/src/main/resources/rawfile/agconnect-services.json
application/entry/src/main/ets/pages/MapSelect.ets    # 地图选点页面

七、附：配置片段

build-profile.json5（signingConfigs，已脱敏）

"signingConfigs": [
  {
    "name": "default",
    "type": "HarmonyOS",
    "material": {
      "certpath": "C:\\Users\\85082\\.ohos\\config\\default_application_AoNyEqyq6CdRzny2-35HwmETY3K241_OH-yIYx6vDGw=.cer",
      "keyAlias": "debugKey",
      "keyPassword": "***（已脱敏）***",
      "profile": "C:\\Users\\85082\\.ohos\\config\\default_application_AoNyEqyq6CdRzny2-35HwmETY3K241_OH-yIYx6vDGw=.p7b",
      "signAlg": "SHA256withECDSA",
      "storeFile": "C:\\Users\\85082\\.ohos\\config\\default_application_AoNyEqyq6CdRzny2-35HwmETY3K241_OH-yIYx6vDGw=.p12",
      "storePassword": "***（已脱敏）***"
    }
  }
]

module.json5（metadata）

"metadata": [
  {
    "name": "client_id",
    "value": "6917599280681179801"
  }
]

build-profile.json5（capabilities）

"capabilities": [
  {
    "bundleName": "com.appv2.reminder",
    "config": [
      {
        "name": "Push Kit",
        "capability": "com.huawei.service.push.base_service"
      },
      {
        "name": "Device status detection",
        "capability": "com.huawei.service.device_security.device_verify"
      },
      {
        "name": "Map Kit",
        "capability": "com.huawei.service.mapkit"
      },
      {
        "name": "Safety Detect",
        "capability": "com.huawei.service.device_security.safety_detect"
      }
    ]
  }
]