详情页被跨对象分栏状态污染后自动跳转为分栏模式

[yinlianghui]

问题描述

普通对象详情页会被其他对象的分栏状态污染。用户只在 company 对象上切换过分栏模式后，再次进入未启用分栏的 spaces 详情页时，URL 会被自动补全为带 side_object=spaces&side_listview_id=all 的三栏 URL，导致详情页错误进入分栏模式，中间栏渲染 spaces 列表。

重现步骤

1. 访问 http://127.0.0.1:5100/app/admin/company，默认进入二栏列表。
2. 点击工具栏切换为“分栏模式”，URL 变为类似：
   http://127.0.0.1:5100/app/admin/company/view/none?side_object=company&side_listview_id=all&additionalFilters=
3. 点击左侧菜单“公司”（spaces 对象），进入：
   http://127.0.0.1:5100/app/admin/spaces/view/<recordId>，首次显示正常二栏详情。
4. 点击左侧菜单“分部”（company 对象，仍为分栏模式列表）。
5. 再次点击左侧菜单“公司”（spaces 对象）。

实际结果

第 5 步后 URL 被自动改写为类似：

/app/admin/spaces/view/<recordId>?side_object=spaces&side_listview_id=all&additionalFilters=

同时 sessionStorage.tab_spaces_display 被写入 split，spaces 详情页错误进入分栏模式，中间栏显示 spaces 列表。

期望结果

spaces 对象未配置 enable_split: true，且用户没有明确要求 spaces 使用分栏模式。因此无论 company 对象是否切过分栏，spaces 菜单都应稳定显示普通二栏详情页，不应自动追加 side_object 参数，也不应写入 tab_spaces_display=split。

初步根因

本问题由两个行为叠加触发：

1. Steedos.Page.getDisplay(objectName) 会把 URL 上的 display 状态写入 sessionStorage.tab_${objectName}_display，需要避免在渲染其他对象/内嵌对象时把当前页面分栏状态写到错误对象。
2. ObjectDetail 在 split 状态且 URL 缺少 side_object 时会自动补全三栏 URL。该逻辑如果只依据 Steedos.Page.getDisplay(objectName)，就会被已污染的 sessionStorage 触发，把未启用分栏的对象详情页强制改写为分栏 URL。

引入提交与关联问题

本次现象中的“详情页自动补全三栏 URL”由以下提交引入：

• Commit: 3f83e5c
• PR: Fix ObjectDetail missing URL param auto-completion in split mode #8336
• 原始修复 issue: ObjectDetail 组件在三栏模式下缺少 URL 参数时未做自动补全，导致审批列表跨对象切换异常 #8335

该提交的目标是修复审批中心三栏模式下，ObjectDetail 缺少 side_object / side_listview_id / additionalFilters 时导致跨对象切换异常的问题。因此修复当前 bug 时必须把 #8335 作为回归场景。

回归测试清单

• 当前 bug：按上述步骤从 company 分栏切到未启用分栏的 spaces 详情页，URL 不应自动追加 side_object=spaces，页面保持二栏详情。
• 当前 bug：sessionStorage.getItem('tab_spaces_display') 不应因 company 分栏页面被写成 split。
• ObjectDetail 组件在三栏模式下缺少 URL 参数时未做自动补全，导致审批列表跨对象切换异常 #8335 回归：审批对象 instance_tasks / instances 配置了 enable_split: true，访问缺少三栏 query 的审批详情 URL 后，仍应自动补全 side_object / side_listview_id / additionalFilters，跨对象菜单切换正常发起数据请求。
• ObjectDetail 组件在三栏模式下缺少 URL 参数时未做自动补全，导致审批列表跨对象切换异常 #8335 回归：审批中心从 instance_tasks 跨对象切到 instances 时，列表视图、宽度、隐藏视图下拉等定制行为保持正常。
• 普通对象回归：用户在某个对象上显式点击工具栏切换分栏后，该对象自身的分栏持久化仍正常；切换到其他对象时不污染其他对象的 display 状态。

[yinlianghui]

修复总结

问题根因

SPA 路由切换到新对象时，amis 的 componentDidUpdate 时序导致 data 数据域更新滞后于 props。具体表现为：

• objectApiName prop 已经更新为新对象（如 spaces）
• 但 data.objectName 和 data.display 仍然是上一对象（如 company 三栏）的残留值

原代码 _display = data.display || display 让残留的 split 优先于新 prop 的 null，于是被 Router.setTabDisplayAs(objectApiName, _display) 错误写入 sessionStorage.tab_<新对象>_display = split，造成跨对象污染。

之所以 PR #8336（commit 3f83e5c10c）之后才暴露，是因为该 PR 在 detail.tsx 加了 split URL 自动补全逻辑，使污染后的 sessionStorage 立即被读取并把新对象强制跳成三栏。但根因不在 platform 的自动补全，而在 widgets 的 display 写入逻辑。

修改方案

在 widgets 的 PageRecordDetail.tsx 与 PageListView.tsx 中增加对象一致性守卫：

const isCurrentObjectData = !data.objectName || data.objectName === objectApiName
const _display = isCurrentObjectData ? (data.display || display) : display
if (isCurrentObjectData && _display) {
  Router.setTabDisplayAs(objectApiName, _display)
}

仅当 data 属于当前对象时才采用 data.display 并写入 sessionStorage，否则忽略残留值，避免污染其他对象。

修复提交：steedos-widgets 6.10 分支 315736ea9

修改文件：

• packages/@steedos-widgets/amis-object/src/pages/PageRecordDetail.tsx
• packages/@steedos-widgets/amis-object/src/pages/PageListView.tsx

回归测试清单

测试项	场景	结果
A	company 切到三栏 → 点击 spaces/分部 → 回 company：spaces 不再被误判为三栏	✅ 通过
B	工具栏切表格 ↔ 分栏 → 刷新页面：display 持久化正确	✅ 通过
C	三栏内点击列表行打开右侧详情	⏳ 待人工验证
D	#8335 回归：访问 /instance_tasks/view/none 自动补全为三栏 URL	✅ 通过
E	enable_split=true 对象（instance_tasks）默认进入三栏	✅ 通过
F	多对象切换交叉污染检查：sessionStorage 仅保留主动设置的对象 key	✅ 通过
G	移动端 375 宽度强制 grid，即使 sessionStorage=split 也不进三栏	✅ 通过
H	浏览器后退/前进键的 history state 行为	⏳ 待人工验证

结论：修复方案不影响 #8335 自动补全逻辑，无回归风险。