nginxserver/memory/session-20260613-1.md

session_id, date, summary, status

session_id	date	summary	status
20260613-1	2026-06-13	Mokee Gateway统一登录接入 - 全栈改造 + 多个Bug修复	进行中 - Widget未显示，其他功能正常

Mokee Gateway 统一登录接入改造

系统编码: nginxServer，网关: https://gw.server.zgitm.com，登录: https://login.user.zgitm.com

最终改动的文件（汇总）

前端 (9 files)

文件	操作	说明
.env.development	改	VITE_GATEWAY_URL / VITE_LOGIN_URL / VITE_SYSTEM_CODE
.env.production	改	同上
index.html	改	引入 Widget CSS（JS 改在 main.js 动态加载）
src/main.js	重写	bootstrap() 鉴权→拉菜单→挂载→加载 Widget
src/utils/request.js	新增	网关 axios 实例，带 Token/X-System-Code，兼容双 code 格式，错误消息提取
src/api/nginxApi.js	改	换新 request，路径加 /api 前缀
src/router/index.js	重写	路由守卫，扁平路由注册，导出 menuTree
src/layout/MainLayout.vue	改	侧边栏从 menuTree 渲染（支持目录层级），ICON_MAP 字符串→组件映射，Widget 占位
index.html	改	Widget CSS，已移除静态 JS（改动态加载）

后端 (5 files)

文件	操作	说明
config/CorsConfig.java	新增	allowedOriginPatterns("https://.zgitm.com","http://localhost:") + allowCredentials
context/UserContext.java	新增	ThreadLocal 工具类（修复 JDK 17 兼容：不用 getOrDefault）
filter/UserContextFilter.java	新增	Servlet Filter 提取网关注入的 X-User-Id 等请求头
entity/ForwardingRule.java	改	status 字段加 @TableLogic(value="1", delval="0")
entity/DnsZoneConfig.java	改	status 字段加 @TableLogic(value="1", delval="0")
config/RestTemplateConfig.java	未改	保持原样，Spring Boot 直连 Python API

控制器 (3 files)

文件	操作	说明
ForwardingRuleController.java	改	删除 @CrossOrigin(origins="*")，CORS 统一由 CorsConfig 管
CertificateController.java	改	同上
DnsController.java	改	同上

配置 (1 file)

文件	操作	说明
application.yml	改	删除全局 logic-delete-field: status（这是证书重复键Bug的根因）

Python API (1 file)

文件	操作	说明
nginx-python-api/app.py	改	添加 before_request 中间件提取用户请求头到 Flask g（未部署到服务器）

SQL (1 file)

文件	操作	说明
sql/gateway_init.sql	新增	UUID 变量方式，菜单：Nginx代理管理→三个业务页面，角色：admin/user，管理员：admin_nginxServer

踩过的坑

1. @CrossOrigin(origins="*") + CorsConfig.allowCredentials(true) 冲突

• 三个 Controller 原来有 @CrossOrigin(origins="*")，与全局 CorsConfig 的 allowCredentials(true) 合并后产生非法组合
• 修复：删除三个 Controller 的 @CrossOrigin，CORS 统一由 CorsConfig 管理

2. 网关菜单返回字段和前端预期不一致

• 网关实际返回：{path, name, component, meta:{title,icon}, children}，component="Layout" 表示目录
• 前端最初判断 menuType/menu_name 等字段，全部对不上
• 修复：addDynamicRoutes() 改为判断 component==='Layout'，路由扁平注册到 /，侧边栏从 menuTree 渲染

3. Widget process is not defined

• Widget JS 内部引用了 process.env，浏览器环境无此全局变量
• 修复：main.js 中加载 Widget 前加 window.process = { env: {} }

4. 路由嵌套导致菜单不显示

• 最初 addDynamicRoutes 把页面路由嵌套在 /nginx/nginx-forwarding 下，redirect /nginx-forwarding 找不到
• 修复：页面路由全部扁平注册到 /，侧边栏层级单独从 menuTree 渲染

5. 证书列表查询触发 INSERT 重复键 — 全局 logic-delete-field 误伤

• 根因：application.yml 全局 logic-delete-field: status，MyBatis-Plus 给所有实体加 AND status = 1
• Certificate.status 是 String "active"，WHERE status = 1 永远不成立 → selectOne 返回 null → 走 INSERT → 重复键
• ForwardingRule.status 和 DnsZoneConfig.status 是 Integer 0/1，不受影响
• 修复：删除全局 logic-delete-field，在 ForwardingRule 和 DnsZoneConfig 的 status 字段加 @TableLogic(value="1", delval="0")

6. 前端错误消息丢失

• 新 request.js 错误拦截器直接透传 axios error，前端拿到 "Request failed with status code 500"
• 旧代码从 error.response.data.message 提取后端实际消息
• 修复：错误拦截器追加 new Error(error.response?.data?.message || error.message || '网络错误')

7. Widget 动态加载时机

• Widget 脚本在 index.html 同步加载时 Vue 未渲染，找不到 #mokee-user-chip
• 移到 main.js 的 app.mount() 之后动态加载
• 当前状态：Widget 仍未显示，待排查

待解决

• Widget 用户头像组件不显示（右上角）
• Python API app.py 中间件需部署到 10.1.1.160