HarmonyOS鸿蒙Next中uni-app x（HBuilderX）项目调用Map Kit site.nearbySearch/reverseGeocode始终报1002600003 App authentication failed

HarmonyOS鸿蒙Next中uni-app x（HBuilderX）项目调用Map Kit site.nearbySearch/reverseGeocode始终报1002600003 App authentication failed

环境信息

• HBuilderX 版本：最新版
• HarmonyOS NEXT 5.0+（API 12）
• 设备：真机调试
• 开发框架：uni-app x（UTS 插件编译为 HAR 模块）
• 签名方式：手动签名（.p12 + .cer + .p7b）

问题描述

在 uni-app x 鸿蒙项目中，通过 UTS 插件调用 @kit.MapKit 的 Site Kit API（site.nearbySearch() 和 site.reverseGeocode()），始终返回错误码 1002600003 App authentication failed。

但同一个 UTS 插件中调用 sceneMap.chooseLocation() 则完全正常，可以成功打开原生选点页面并返回结果。

错误日志

[DIAG] testing site.reverseGeocode...
[DIAG] reverseGeocode FAILED: code=1002600003 msg=App authentication failed.
[DIAG] calling site.nearbySearch...
[DIAG] nearbySearch FAILED: code=1002600003 msg=App authentication failed.

系统日志中还会出现：

W C02D07/NapiProcessor: Parameter error. The configName parameter is invalid.

已验证正确的配置（逐项确认）

关键对比

两个 API 均在同一个 UTS 插件中调用。chooseLocation 接受显式 context 参数所以成功；Site API 不接受 context 参数，SDK 内部获取上下文时可能出错。

核心怀疑

uni-app x 的 UTS 插件编译为独立 HAR 模块。Site SDK 内部可能通过 getContext() 获取的是 HAR 模块的上下文，而非 entry 模块的上下文，导致 SDK 无法正确读取认证配置。

NapiProcessor: configName parameter is invalid 警告进一步支持这一判断——SDK 在读取某个配置时失败。

已尝试在 HAR 模块的 module.json5 中添加 client_id metadata，以及将 agconnect-services.json 放入 HAR 模块的 resources/rawfile/，均无效。

代码

import { site, sceneMap } from '@kit.MapKit'
import { BusinessError } from '@kit.BasicServicesKit'
import { common } from '@kit.AbilityKit'

// 此函数失败：1002600003
async function testSiteApi() {
    let params: site.NearbySearchParams = {
        query: '',
        location: { latitude: 123, longitude: 456 },
        radius: 200,
        language: 'zh',
    }
    const result = await site.nearbySearch(params)  // 抛出 1002600003
}

// 此函数成功
async function testChooseLocation() {
    let options: sceneMap.LocationChoosingOptions = {
        location: { latitude: 123, longitude: 456 },
        language: 'zh_cn',
        searchEnabled: true,
        showNearbyPoi: true,
    }
    const context = UTSHarmony.getUIAbilityContext()! as common.UIAbilityContext
    const data = await sceneMap.chooseLocation(context, options)  // 成功
}

期望获取的帮助

1. Site Kit 的 nearbySearch / reverseGeocode 是否支持在 HAR 模块中调用？是否需要特殊的初始化步骤？
2. NapiProcessor: configName parameter is invalid 的具体含义是什么？需要配置什么？
3. 是否有办法为 Site Kit API 显式传入 context 或进行初始化（类似 sceneMap.chooseLocation 接受 context 参数那样）？
4. 在非 DevEco Studio 环境（如 HBuilderX / uni-app x）中使用 Site Kit 是否有已知限制？