2401_82404985的博客

【摘要】在鸿蒙游戏开发中，当应用compatibleSdkVersion与设备API版本不匹配时，会出现真机运行失败报错。问题根源在于工程配置的最低兼容版本高于设备镜像版本。可通过两种方案解决：1)升级设备系统版本；2)修改build-profile.json5文件中的compatibleSdkVersion字段，使其兼容设备API版本。开发者可使用hdc命令查询设备apiVersion进行版本比对。更多技术支持可访问鸿蒙游戏官网或华为开发者学堂。（150字） 注：摘要严格控制在150字内，完整呈现了问题本

【摘要】开发者在调用unionLogin接口时出现System internal error错误，主要排查方向：1）检查accountIcon参数大小是否超过35KB限制；2）验证context参数是否符合规范，建议使用标准方法let context = getContext(this) as common.UIAbilityContext获取。建议访问鸿蒙游戏官网（https://developer.huawei.com/consumer/cn/games/）或华为开发者学堂获取更多技术支持。（150字）

《华为游戏登录授权问题解决方案》 摘要：开发者反馈游戏登录失败，华为ID授权接口报错1001502014。经日志分析显示"该应用未获得必要的权限范围（noscopepermission）"。解决方案需在配置中申请对应scope权限。更多技术支持可访问鸿蒙游戏官网（https://developer.huawei.com/consumer/cn/games/）或华为开发者学堂公开课。（98字）

摘要： 通过分析鸿蒙IAPKit服务端通知失败案例，发现沙盒环境订单通知失败不重试。该笔订单因"environment":"SANDBOX"标记为沙箱测试订单，不同于正式环境的400状态码重试机制。开发者需注意沙盒环境与正式环境的差异，更多问题可参考鸿蒙游戏官网及开发者学堂资源。（99字）

《鸿蒙游戏IAPKit商品查询数量限制问题解决》 摘要：鸿蒙游戏集成IAPKit应用内支付时，出现商品查询失败（错误码1001860001）。通过系统日志分析发现，queryProducts接口存在商品ID查询数量限制（上限200个）。当传入商品ID超过200个时，系统返回内部错误。将查询商品数量控制在200以内后，接口恢复正常。该问题常见于沙盒测试环境，建议开发者在处理大批量商品查询时进行分页处理。更多问题可参考鸿蒙游戏官方资源。

游戏服务ID转换接口报错分析 在将游戏从双框架迁移至单框架过程中，调用转换ID接口时出现错误（rtnCode:2，errMsg:"gettokeninfofailed"）。经分析，主要原因为accessToken参数未进行URL编码处理。建议开发者在调用接口前对参数进行规范化编码。更多技术细节可参考华为鸿蒙游戏官方文档及开发者学堂课程。

鸿蒙游戏APP上架审核因"登录失败"被驳回，日志显示指纹证书校验错误(1001500001)。经排查发现可能原因包括：client_id配置错误、指纹证书未正确配置或新旧包签名不一致。最终确认问题源于使用了错误的发布证书(p7b文件)，重新选择正确证书后测试通过。建议开发者仔细检查证书配置，并参考官方文档进行调试。更多资源可访问鸿蒙游戏官网和开发者学堂。(150字)

摘要：华为鸿蒙游戏服务集成过程中，调用unionLogin接口时出现登录提示重复弹出的问题。经排查发现，当用户选择"华为账号登录-玩过，继续游戏"后，因verifyLocalPlayer接口的thirdOpenId参数长度超过128字符，导致云侧合规校验失败，未能记录登录方式。解决方法是调整thirdOpenId参数长度至128字符以内。更多技术支持可通过鸿蒙游戏官网或华为开发者学堂获取。

我们游戏项目集成了华为应用内支付服务，在支付成功后需要获取华为接口返回的加密的JWS格式的订单信息，并上报到我们服务端解密后获取对应的json格式的订单信息做校验。因此想到了用文件读写保存的方式，鸿蒙新手简单记录下鸿蒙文件基本读写问题。代码完成后运行代码，可使用deveco工具找到"/data/storage/el2/base/haps/entry/files"路径并查看该文件，保存本地。打印出来的实际路径为"/data/storage/el2/base/haps/entry/files"。

我们安卓游戏在原华为安卓渠道的玩家标识属于playerId和openId混用情况，现在上架鸿蒙游戏需要配置转移appid映射关系，但是只能从playerid和openid中选择一个玩家标识字段，作为转移的玩家标识。华为侧给的解决方案是配置转移映射关系时先选择一种玩家标识，比如选择openid，然后unionlogin接口返回的gamePlayerId就是原华为渠道玩家登录游戏的playerid，再用获取到的gamePlayerId调用。鸿蒙游戏登录，联合登录，转换ID。我们按照这个流程测试，请。

这两处配置不正确，都会返回该错误。按照对方发的指导，发现我没有在工程的entry模块module.json5文件中配置client_id和app_id，并且也没有在AGC后台添加证书指纹。于是我按照指导，完成这两处配置，问题解决。报错2：鸿蒙联合登录接口返回Code 1002000017, message Illegal application identity.接口，接口返回错误信息错误码1002000001, 错误信息System internal error。报错1：集成鸿蒙游戏服务。

，出现该问题的原因是默认应用的等级是normal，只能使用normal等级的权限，但是我们项目使用了system_basic或system_core等级的权限，所以出现该报错。针对该问题，建议我们参考如下文档申请ACL提权和项目相关配置，即可解决问题。

我们传入的state值是一个函数，这种写法应该只是把Date.now.tostring 函数记录下来了，没有调用获取值，我们修改为先获取到Date.now.tostring() 的值，然后再传递给state，再次请求接口，接口调用成功，问题解决。经过仔细核实，发现我们配置的metadata位置是错误的，文档中要求的是与abilities同级别下，创建一个matedata，但是我们实际配置到了abilities节点内的matedata。经过华为技术支持答疑后，我们修改配置后问题解决。分析日志，暂未发现报错。

安装报错9568322，signature verification failed due to not trusted app source.但是按照官方提供的解决措施排查，我们是正常的，p7b签名文件中含有我们的设备udid。我们参考华为技术给出的定位解决，修改使用测试签名，重新出包后问题解决。技术支持解释到当前正式签名是无法自测安装的，建议我们切换测试签名。联系了华为技术人员，他们建议我们通过如下啊命令抓取安装日志。更多安装错误码处理案例可参考：bm工具错误码。表明当前使用的是正式签名。

{rootUrl}/order/harmony/v1/application/order/status/query，返回错误信息。平台，在“我的项目”中选择目标应用，获取“项目设置 > 常规 > 应用”获取APP ID。），对方告诉我， “rights invalid”应该是appid使用的不正确。在开发者联盟上查到错误码1001880006对应的描述和解决办法，如下。时aid的值需要与当前测试的应用的APP ID一致。按照指导，我重新获取了APP ID,问题解决。集成华为鸿蒙应用内支付服务，调用。

，对方告诉我，从错误信息“JWT signature time is later than the current time!{rootUrl}/order/harmony/v1/application/order/status/query，返回错误信息。exp和iat两个参数我传的时间戳单位是ms，导致JWT有效期晚于当前时间，改成以s为单位的时间戳，问题解决。时传的JWT有效期有问题。JWT的有效期是指exp-iat，其中exp和iat两个参数的时间戳单位是s。集成华为鸿蒙应用内支付服务，调用。

4.如果对日志做过滤，请输出关键字： UpdateSDK version is：xxx信息日志，这个是审核侧判断是否调用检测更新接口的依据。应用提交华为渠道审核，审核驳回：发现未调用检测更新接口（checkAppUpdate）3.建议不要对提审apk包做二次封装、加固、限制输出日志等操作；5.按照上述检查，仍未解决问题，可以联系华为技术支持（提交。

我们游戏支持设备包含手机、平板和PC，刚开始接触鸿蒙，不太清楚在哪里设置兼容设备，研究了下文档并写下来做个记录。鸿蒙游戏，平板，PC。

我们参考华为技术给出的排查建议，自检没有发现异常，华为技术排查发现：华为侧没有接到来自我方的业务请求，且他们使用我们的业务参数，在postman客户端上可以请求成功，而我们使用的postman是网页版。华为技术初步怀疑是网页版postman存在网络限制，建议我们更换后客户端postman，更换后问题解决。检查获取AccessToken的AuthCode是否正确：AuthCode从客户端。鸿蒙游戏登录，服务器，getPlayerInfo，3001，中获取凭证Access Token接口指导，请务必参考。

行 1617: 02-01 11:40:50.148 1315 1315 I A00000/ACCOUNT_TAG: No clientId in com.snailgame.snailharmonysdk(OHOS::CloudAuth::BundleManagerHelper::ExtractClientIdFromMetadata:80)自检发现我们确实没有配置clientId和appid，参考文档配置后，问题解决。集成华为鸿蒙游戏登录功能，登录接口报错。鸿蒙游戏登录，1001502003。

联系了华为技术人员，并提供订单号详情，华为后台查到支付时是银行侧返回了错误，原因是使用的测试账号所绑定的银行卡信息异常，可能是证件号异常或者超过有效期，建议检查下相关账号，或者换个银行卡测试支付。我们HarmonyOS NEXT游戏项目集成应用内支付服务，接入支付购买接口返回错误码1001860001，看文档上。的描述，该错误码对应描述为内部系统错误，看不出来报错具体原因。经核实，银行卡确实信息异常，换个银行卡支付正常了，问题解决。应用内支付服务，支付购买接口。

要求，要根据返回信息传参，即第一次查询时不传该参数，之后查询传参上次查询返回的continuationToken，直到接口不再返回continuationToken。联系了华为技术人员，并提供全量系统日志。经过服务端定位分析，我们补单接口调用的时候continuationToken参数有传参，该参数是分页查询的数据定位标志，传参需要遵循。根据文档要求，即第一次将continuationToken参数去掉后，请求成功，之后返回的continuationToken为空，表示订单数据已经请求到全部了。

1001860003表示传入的商品ID或者商品类型有误，需要到AGC后台查看对应商品是否存在，并且要确保支付接口的productId参数的值与AGC后台配置的商品id保持一致。接口发起购买，拉起收银台失败，返回错误码1001860003，错误信息Incorrect product information。经排查，我们代码中传给productId的值与AGC后台配置的不一致。重新配置AGC上商品信息，问题解决。游戏集成华为应用内支付功能，且在AGC后台配置了商品，调用。应用内支付服务，华为鸿蒙。

，经技术检查确认日志，搜索日志HMS_IAP，看到创建订单时候报错30001，并且提示错误applicationID没有配置。，看到需要配置应用身份信息，含clientid和appid，这边appid遗漏，根据文档配置后测试支付正常，问题解决。根据该错误码的描述信息，看不出具体错误原因。应用内支付服务，华为鸿蒙。

联系），技术支持解释：鸿蒙签名工具对java的jre版本有要求，如果使用java version 1.8等低版本，会有该报错，建议我们先升级java版本。Hvigorw打包，code: 109. Details: Init keystore failed。确实比较低，升级到java17后，问题解决。使用hvigorw工具打包，报错。联系华为技术支持沟通（提。

我们项目集成鸿蒙广告服务接口，按照接口文档调用激励广告接口报错21800003。根据文档提示，先在模块的module.json5文件中申请广告跟踪权限。这两步操作我们没有处理，按照文档要求补充后接口返回成功，问题解决。），技术反馈看日志oaid没有获取，调用接口之前要先。广告服务，21800003。

检查entry下面的moudle.json5的metadata中的clientid和appid是否和华为开发者后台对应的参数一致。我们参考华为技术给出的排查建议，发现unionLogin的参数accountIcon大小超过35kb，修改图标并替换后，问题解决。· 检查unionLogin接口的传参accountIcon总大小是否超过35kb，该图标有大小限制。经过修改项目中实际包名后，问题解决（路径：AGC-项目管理-应用-包名/appid/clientid）。，自动签名不支持联合登录。

参考华为技术的指导再检查一遍，发现在module.json5文件的metadata中有配置clientid，但是appid遗漏配置了，补充配置后，问题解决。再检查下签名证书以及指纹配置和module.json5文件中的clientid、appid是否都已配置。接口错误码提示是网络异常，但是我检查了网络是正常的，并且切换了热点测试，还是报错网络异常。联系华为技术支持，技术让我按照。

检查签名的配置，发现.p7b文件与.cer文件都是在华为AGC后台生成的，我们两个应用的.p12签名原文件都是一样的，但是.p12文件需要上传到华为平台生成.p7b文件与.cer文件再签名，怀疑这个步骤可能与应用名称绑定了，即不同的应用配置签名信息时都要上传.p12文件并下载.p7b文件与.cer文件才可以。其中，app.json5文件中的包名是com.lianyun.harmOS.huawei，SignConfigs中配置的包名是lianyun.harmos.huawei。

然后按照文档操作，下载新的p7b文件进行签名（cer文件未重新生成下载），重新打包后安装还是报错“signature verification failed due to not trusted app source.”。使用命令行重新获取设备Udid，并跟华为AGC后台已经配置的设备Udid对比，发现Udid有变动。签名等配置信息都是之前已经配置好的，且之前一直能正常安装，只是升级了rom版本。怀疑cer文件也跟设备有关，于是又替换新的cer文件，重新打包，可以安装成功，问题解决。

联系），技术支持说该接口要在unionLogin接口登录成功后才能调用。如果转移回退或者关联解绑以后，也需要再次调用unionLogin接口并且登录成功后才能查询到玩家信息。检查发现，我是在解绑后，还未调用unionLogin接口进行登录就调用了该接口查询玩家信息。按照对方的指导，在unionLogin接口登录成功后再调用，问题解决。报错responseBody={"rtnCode":-1,"errMsg":"Query Player Accounts Error."}于是我联系华为技术支持沟通（提。

鸿蒙游戏，合规校验。

鸿蒙化 游戏启动 图标。

鸿蒙游戏、软件包管理、上架提审。

联合登录，1002000002，转移，鸿蒙游戏服务。

游戏服务；授权绑定；关联登录。

经过排查定位，当时使用的命令是hvigorw assembleHap --mode module -p product=default -p buildMode=release --no-daemon，buildMode指定为了release，修改为debug后重新出包，安装成功。鸿蒙应用，安装报错，9568324，signature verification failed due to out of integrity.使用调试证书，并且是手动签名，命令行出包后安装报错。

修改包体文件后缀为.zip文件，打开查看pack.info文件。鸿蒙游戏上架、打包配置、deveco studio。

第二点按照步骤解压缩发现包体也没有问题，怀疑可能是网络原因，换电脑上传包体也不行，可能跟使用公司网络限制有关，换网络上传成功，应该为公司网络存在代理限制，问题解决。参考技术的指导自检，本次包体没有exe文件，也没有用压缩软件修改过打包后的包体，可以排除第一点和第三点。根据后台提示错误码点进去查看，提示说压缩包格式没能通过安全检查。鸿蒙游戏，AGC，提审，1015，软件包管理。

转移登录流程方式登录完成之后，即可通过登录接口unionLogin回调中获取到账号标识gamePlayerId，该标识真实值等于在步骤1选择的原华为安卓渠道账号标识值，完成进度同步和资产转移即可。更多问题可关注：华为开发者学堂。