Files
dacli/docs/decisions/0013-menu-create-currentuser-cache.md
T

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 不显示新挂菜单, 导致:

  1. TC-B 浏览器测试阻塞: dacli test browser --formId=X 找 menu URL 失败 (realUrl: "")
  2. 用户访问 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

  1. dacli 自动 invalidate Redis: 需知 JNPF Redis key pattern + 权限, 调研成本高
  2. 改 JNPF 后端菜单缓存策略: 平台只读, 禁止改
  3. 要求用户每次手动清 localStorage: 已成事实 (M2 阻塞原因), 不可接受作为长期方案
  4. 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 或类似