3.7 KiB
0013-menu-create-currentuser-cache
⚠️ 引用归档说明 (2026-07-23): 本 ADR 引用
cmd-review/menu.md, 已迁dacli/docs/archive/cmd-review-2026-07/menu.md. 路径仅溯源不变.
日期: 2026-07-20 状态: Accepted 作者: claude-code (jxcj M2 重启实战) 前置: 无 影响命令:
dacli menu create --formId=X+dacli test browser
Context
dacli menu create --formId=X --pcParents=Y 成功后, 走 web Actions/Module API 绑 form, 形式正确 (form 端 pcIsRelease=1, pcReleaseName 已设). 但 /api/oauth/CurrentUser 的 menuList 不显示新挂菜单, 导致:
- TC-B 浏览器测试阻塞:
dacli test browser --formId=X找 menu URL 失败 (realUrl: "") - 用户访问 http://nginx/jnpf_app_jxcj 看不到新菜单: 缓存未刷新
jxcj M2 重启 (2026-07-20) 实战:
- 11 个 form-bound menu 全部 create 成功 (form
pcIsRelease=1) dacli menu list显示 11 条 form-driven menus- 但
curl /api/oauth/CurrentUser返回的 menuList 只有 5 条 (默认平台菜单: 应用设置/在线开发 等), 0 条 jxcj form-bound - 二次
dacli app login --account=admin --password=123456 --appCode=jxcj(新 token) → 仍 5 条
根因猜测: JNPF CurrentUser 菜单缓存策略不透明, 可能:
- Redis 缓存 (token → menuList) 未 invalidate
- 前端 localStorage 缓存 (前端路由层) 未清
- 用户角色权限缓存 (isAllDevUser=1 时本应全显示, 但实际没显示)
具体根因需 JNPF 后端源码调研 (本次未深入), 当前变通方案: 用户手动清浏览器 localStorage + re-login 多次。
Decision
改进 1 (dacli 新命令, P1) - 加 dacli menu cache clear 一键清 CurrentUser 缓存:
dacli menu cache clear
# 内部: 调用 /api/oauth/CurrentUser 重置接口, 或 invalidate Redis key
# 或: 返回前端 localStorage 清除指令 (用户手动操作)
改进 2 (dacli menu create 自动 invalidate) - menu create 成功后自动调用缓存清理:
// dacli/src/commands/menu/create.ts 改进 (伪代码)
if (opts.formId && result.success) {
await invalidateCurrentUserCache() // 新增私有命令
log.info('✓ 已自动 invalidate CurrentUser 缓存 (避免 TC-B 阻塞)')
}
改进 3 (dacli test browser 兼容) - 找 menu URL 失败时 fallback 到直接 form URL:
// dacli/src/commands/test/browser.ts 改进 (伪代码)
const menuUrl = await findMenuUrl(formId)
if (!menuUrl) {
log.warn(`menu URL 未找到 (CurrentUser 缓存未刷新), fallback 到直接 form URL: /jnpf_app_${appCode}/model/${formEnCode}`)
return `/jnpf_app_${appCode}/model/${formEnCode}`
}
jxcj M2 实战已验证直接 URL 可访问 (绕过菜单), 临时方案。
Alternatives Considered
- dacli 自动 invalidate Redis: 需知 JNPF Redis key pattern + 权限, 调研成本高
- 改 JNPF 后端菜单缓存策略: 平台只读, 禁止改
- 要求用户每次手动清 localStorage: 已成事实 (M2 阻塞原因), 不可接受作为长期方案
- dacli test browser 不查菜单直接走 form URL: 改进 3 已采纳作为兜底
Consequences
正面
- TC-B 浏览器测试不再因 menu 缓存阻塞
- 用户访问 jxcj 应用可立即看到新挂菜单
- 跨项目 (jxcj / testspace / dos 等) 都受益
负面
- invalidate CurrentUser 缓存可能影响其他用户会话 (需限速/限频)
- 找 menu URL 失败时 TC-B 误判通过 (兜底 URL 可能不是用户期望的菜单路径)
References
- jxcj M2 重启:
docs/jxcj/learnings.md阶段 4 §M2 踩坑 4 (TC-B menu 缓存) - 现有 dacli cmd-review:
dacli/docs/cmd-review/menu.md§4 (无此条目, 需补) - JNPF 菜单缓存: 需查
jnpf-system-biz/.../service/impl/AuthorizeService.java或类似