使用模拟器调试时，需在AGC云侧注册调试凭据，以保护应用/元服务对Cloud Foundation Kit的访问。在模拟器中启动应用/元服务时，开发者触发一次云函数、云数据库或云存储业务接口，该模拟器下会生成调试凭据并输出到日志；将生成的调试凭据注册到AGC云侧，即可在模拟器中调试应用/元服务。

具体可按如下步骤操作：

1. 获取调试凭据。
   1. 创建并启动模拟器，具体请参见[管理模拟器](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-emulator-management)。
   2. 在模拟器中启动应用，并触发任意一次云函数、云数据库或云存储业务接口（建议使用云函数接口）。此时，由于未注册调试凭据，接口调用会失败，请忽略，继续执行下一步。
   3. 通过设置“No filters”模式、过滤“clouddevelopproxy.debugToken”关键字，查找日志中打印的调试凭据，并复制该调试凭据。

      格式示例：[clouddevelopproxy.debugToken=*xxx*]，其中“*xxx*”为调试凭据。

      说明

      如日志中查找不到调试凭据，请排查应用是否使用了错误的签名方式。当前Cloud Foundation Kit支持[关联注册应用进行自动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section20943184413328)和[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)两种方式，请修改后再重试。

      ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bb/v3/x1fO_F45S5Glpha7B2_syQ/zh-cn_image_0000002440934308.png?HW-CC-KV=V1&HW-CC-Date=20260414T025942Z&HW-CC-Expire=86400&HW-CC-Sign=67980B319392B60B4C3E0F1E6200416CB04D7BD7D6339ADF5CEB87EBBFAD9A4A)
2. 将获取的调试凭据注册到AGC云侧，具体可参见[注册模拟器调试凭据](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-credential-0000002415343501)。
3. 调试凭据注册成功后，您即可使用模拟器调试应用/元服务。关于模拟器使用指导，请参见[使用模拟器运行应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-emulator)。

   如调用接口时返回的错误信息提示401签名校验失败或者403鉴权失败，可能原因如下：
   * 调试凭据未注册。请先[注册模拟器调试凭据](https://developer.huawei.com/consumer/cn/doc/app/agc-help-add-credential-0000002415343501)。
   * 注册调试凭据时绑定了错误的应用/元服务。请先删除该调试凭据，重新绑定正确的应用/元服务，等待30分钟后再进行调试。