发生了什么
用户有两种方式进入同一个合同页面:从列表点进去,或者先打开详情,再进入合同页面。
从列表进入后可以新增合同,从详情进入后点新增却报错,提示缺少必填信息。两条路都能打开页面,但只有一条能把事情做完。
本质
目标页面除了需要知道“操作哪个对象”,还需要知道它属于哪类业务。入口跳转时,必须把这些信息一起带过去。
- 新增合同功能开始依赖这些信息。
- 开发给列表入口补齐了跳转参数。
- 详情入口没有一起修改,只传了对象编号。
- 目标页面缺少业务信息,调用新增所需的接口时就失败了。
检查入口时,要把进入后的操作做完,不能只看页面能不能打开。
两条入口已统一参数的接收和传递,修复已发布。
错误代码
// 前端:两个入口进入同一页面,带的路由参数却不同。
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 是带给目标页面的参数;实际页面需要的参数应在所有入口保持一致。
下次遇到这些场景要警惕
- 一个页面有多个入口:分别从每个入口进入,再执行新增、编辑等操作,确认都能完成。
- 页面新增了必需信息:检查所有入口,以及中间页面是否继续把信息传下去。
- 刷新页面或直接打开链接:缺少必要信息时,应能补齐或明确提示,不能一直到提交时才报未知错误。