跳到主要内容

调试、联调与环境切换

切换环境​

在 ui/frontend 执行：

npm run env:status
npm run env:local
# 需要使用已验证的共享接口时切换：
npm run env:test

脚本只修改 .env.local 的 VITE_DUOGEX_API_HOST：local 对应本机网关，test 对应当前已登记的 HTTPS 网关。它不会迁移应用、自动切换租户或重载现有构建。切换后重启开发进程或重新构建，再核对实际运行信息。

联调顺序​

  1. 先确认匿名公开读取可用，区分网关前缀、分享配置和发布状态。
  2. 验证微信登录、App 会话和本人读取；手机号授权单独验证。
  3. 核对字段合同后，在授权样例上验证写入与详情回读。
  4. 设备、订单和跨表动作使用 BFF 业务入口，记录 apiId、traceId 与目标 ID。

微信登录、匿名接口和带 Token 请求优先参考 src/pages/debug/duogex.vue 及 services/actions/duogex-debug-actions.js。该页是接入参考，不保证作为正式小程序菜单发布；复用动作前检查当前 pages.json 与运行通道。

错误定位​

按网络/HTTP、网关鉴权、业务错误、字段合同、页面映射逐层定位。HTTP method 由合同决定，不能通过 POST 失败换 GET 试出一个可用返回。会话刷新使用统一客户端，同一动作失败后先查询是否已完成，再决定重试。

共享环境联调记录改动前值并恢复，不抢占他人的开发者工具会话，不使用虚构身份或占位业务数据证明链路通过。