方案适用场景与前置说明
适用场景
已有微信小程序商城，希望开发鸿蒙元服务。
前置准备工作

1. 梳理小程序源码关键配置文件，提取通信基地址、租户标识、加密密钥、向量 IV、报文信封格式。
   • 配置文件：config.js / cf.config：后端基址、租户 ID
   • 请求工具文件：utils/util.js：加密密钥、IV、响应信封格式
2. 建议把坑位经验一并给到 AI 辅助开发，规避协议、参数、登录态类高频问题。
3. 推荐核心调试方法论：PC 探针法，在写鸿蒙 App 代码之前，先在 PC 环境完整复刻后端加密通信协议，把协议问题和客户端代码问题解耦。

一、项目完整实施流程总结
1.1 新旧端对比
 

1.2 实施步骤

1. 源码考古阶段：梳理全部接口、理解小程序启动、登录逻辑，确认 DIY 首页装修数据结构。
2. SDD 五阶段开发流程：需求分析，明确 MVP 边界和裁剪范围；架构设计；任务拆解；编码实现；测试验证。
3. 鸿蒙特有能力适配：登录、支付、分享适配华为系统 Kit；实现 Mock 双开关；输出后端对接文档。
4. 多轮真机联调闭环
   • 第一轮：加密层问题，依靠 PC 探针确认后端无问题，定位客户端字节编码错误；
   • 第二轮：登录态问题，后端参数规则理解偏差，补充登录守卫逻辑；
   • 第三轮：完整业务链路回归测试：首页→商品详情→登录→加购→下单全流程。
5. 收尾：全部开发任务闭环，归档非阻断警告信息。
   1.3 两大核心实战方法论
   ① PC 探针法（最高价值）
   在编写鸿蒙客户端代码之前，在 PC 上完整复刻整套加密通信协议。
   • 实现方式：PowerShell 脚本完成 AES CBC 加密、Hex 编码、POST 请求、响应解密，打印完整业务返回。
   • 核心价值：区分问题归属，快速判断问题属于后端协议，还是鸿蒙客户端实现。同时可以提前验证匿名态、登录态两种请求场景，提前发现后端特殊参数规则，避免写到客户端才发现业务限制。
   ② 真机日志实时捕获
   系统自带hilog -x只能输出最近 1000 行日志，复杂问题日志被截断。通过后台进程持续抓取真机 hilog 输出保存到本地文件，方便复现问题后回溯完整日志。
   PowerShell 参考示例
   $p = Start-Process -FilePath $hdc -ArgumentList “-t <设备序列号> shell hilog” `
   -RedirectStandardOutput $logFile -PassThru -WindowStyle Hidden
   #复现业务问题后执行停止进程
   Stop-Process -Id $p.Id
   日志过滤使用Select String，注意日志 Tag 大小写敏感。
   最佳实践：关键链路（加密前后、路由跳转、模板解析、业务错误返回）全部打印日志，极大缩短排错时间。

二、实战踩坑汇总（高频坑位）
2.1 网络加密协议层
 

2.2 鸿蒙 ArkTS 业务实现层
 

2.3 真机调试坑
 

三、交付前完整验证清单（交付逐项核对）
协议层
• PC 探针脚本验证全部核心接口，覆盖匿名访问、登录态两种场景
• 加密解密全流程与小程序协议完全一致，密钥、IV、编码链路核对完成
• 接口路径、参数名称逐字核对，历史错误没有被擅自修改
功能层
• DIY 首页装修渲染正常，未知模板组件降级，不会白屏
• 未登录场景：需要 openid 页面被 LoginGuard 拦截，登录成功自动回跳原页面，参数正确
• openid 持久化，登录一次后续访问不需要重复登录
• 商品详情、搜索、购物车、下单完整业务链路真机跑通
• 系统分享功能正常调用
• 被裁剪模块入口有 “暂未开放” Toast 兜底提示
工程层
• arkts_check 无报错，工程构建编译成功
• 真机部署运行，关键链路无 Error 级日志
• Mock 开关状态确认，待后端联调的模块做好标注