常见错误一：未正确配置应用签名

开发鸿蒙应用时，若未在config.json中正确配置应用签名信息，会导致云服务接口调用失败。需确保签名文件的fingerprint和bundleName与云端注册信息完全一致。

错误示例：

// config.json 错误配置  
"abilities": [  
  {  
    "name": "MainAbility",  
    "type": "page",  
    "label": "$string:mainability_label"  
  }  
]  
// 缺少签名配置  

正确做法：
在config.json中显式声明app字段的签名信息，并通过DevEco Studio生成匹配的证书文件。

常见错误二：云服务API权限未声明

调用HCCDA接口（如@ohos.net.http）时，若未在module.json5中声明权限，会触发PERMISSION_DENIED错误。

解决方案：
添加以下权限声明：

"requestPermissions": [  
  {  
    "name": "ohos.permission.INTERNET"  
  }  
]  

常见错误三：网络请求未适配鸿蒙生命周期

直接在主线程发起同步网络请求会导致UI卡顿甚至应用崩溃。应使用异步任务或TaskPool处理网络操作。

代码示例：

import http from '@ohos.net.http';  
import taskpool from '@ohos.taskpool';  

@Concurrent  
async function fetchData(url: string): Promise<string> {  
  let httpRequest = http.createHttp();  
  return new Promise((resolve) => {  
    httpRequest.request(url, (err, data) => {  
      resolve(data.result);  
    });  
  });  
}  

// 调用示例  
taskpool.execute(fetchData, ["https://example.com"]).then((result) => {  
  console.log(result);  
});  

常见错误四：未处理HTTPS证书校验

鸿蒙默认启用HTTPS证书校验，若对接自签名证书的测试环境，需在http.RequestOptions中显式关闭校验（仅限开发阶段）。

关键配置：

let options: http.HttpRequestOptions = {  
  method: http.RequestMethod.GET,  
  extraData: {  
    "customKey": "value"  
  },  
  expectDataType: http.HttpDataType.OBJECT,  
  usingCache: true,  
  usingProtocol: http.HttpProtocol.HTTPS,  
  usingProxy: false,  
  // 关闭证书校验（生产环境需移除）  
  sslCaPath: ""  
};  

常见错误五：响应数据格式解析错误

HCCDA接口返回的JSON数据需通过JSON.parse()解析，但未处理异常可能导致应用闪退。建议使用安全解析方法：

function safeParse(jsonStr: string): any {  
  try {  
    return JSON.parse(jsonStr);  
  } catch (e) {  
    console.error("JSON解析失败:", e);  
    return null;  
  }  
}  

其他注意事项

• 设备兼容性：部分云服务API仅支持特定系统版本（如HarmonyOS 3.0+），需在config.json中声明apiVersion。
• 调试工具：使用hiLog输出日志时，需开启hilog.debug()级别并配置过滤标签，避免遗漏关键错误信息。
• 配额限制：免费版HCCDA可能有QPS限制，频繁调用会触发429错误，建议实现请求队列或缓存机制。