发生了什么

用户有两种方式进入同一个合同页面:从列表点进去,或者先打开详情,再进入合同页面。

从列表进入后可以新增合同,从详情进入后点新增却报错,提示缺少必填信息。两条路都能打开页面,但只有一条能把事情做完。

本质

目标页面除了需要知道“操作哪个对象”,还需要知道它属于哪类业务。入口跳转时,必须把这些信息一起带过去。

  1. 新增合同功能开始依赖这些信息。
  2. 开发给列表入口补齐了跳转参数。
  3. 详情入口没有一起修改,只传了对象编号。
  4. 目标页面缺少业务信息,调用新增所需的接口时就失败了。

检查入口时,要把进入后的操作做完,不能只看页面能不能打开。

两条入口已统一参数的接收和传递,修复已发布。

错误代码

// 前端:两个入口进入同一页面,带的路由参数却不同。
router.push({ path: "/contract", query: { entityId, domain } });
router.push({ path: "/contract", query: { entityId } }); // 缺少业务信息

修复代码示例

function openContractPage(entityId, context) {
  if (!entityId || !context?.domain) {
    throw new Error("缺少对象或业务信息");
  }
  router.push({
    path: "/contract",
    query: { ...context, entityId }
  });
}
// 列表和详情入口统一调用此方法。
openContractPage(entity.id, entity.context);

这是前端路由问题,使用 JavaScript 展示。router 负责页面跳转,query 是带给目标页面的参数;实际页面需要的参数应在所有入口保持一致。

下次遇到这些场景要警惕

  • 一个页面有多个入口:分别从每个入口进入,再执行新增、编辑等操作,确认都能完成。
  • 页面新增了必需信息:检查所有入口,以及中间页面是否继续把信息传下去。
  • 刷新页面或直接打开链接:缺少必要信息时,应能补齐或明确提示,不能一直到提交时才报未知错误。