Zion后台操作日志默认记录当前登录用户身份(ID、用户名、角色、IP),但仅当接口启用@Auth()鉴权且JWT校验通过时有效;未鉴权接口标记为system或留空,前端伪造或直连数据库变更均无法追溯。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用函子Zion做的后台,操作日志默认记录执行操作的当前登录用户身份,包括用户ID、用户名(如已配置)、角色类型及会话来源IP,但【不自动捕获前端伪造身份或服务端绕过鉴权时的真实操作者】。
操作日志记录主体的判定逻辑
Zion后台的操作日志由服务端中间件在请求生命周期末尾统一写入,其“谁改的”字段取值来源是请求上下文中的 ctx.user 对象。该对象由Zion内置的JWT鉴权流程注入,前提是:接口已启用 @Auth() 装饰器且Token校验通过。
若某接口未加鉴权(例如开放的上传回调、Webhook入口),则 ctx.user 为空,日志中“操作人”将标记为 system 或留空——此时无法追溯真实修改者。
关键前提验证步骤
第一步:确认目标接口是否启用鉴权
打开对应Controller文件,检查方法上方是否存在 @Auth() 或 @Auth('admin') 等装饰器。没有则日志不记人。
第二步:检查Token解析是否绑定用户实体
进入 src/middleware/auth.middleware.ts,确认 verifyToken 函数返回的payload中包含 userId 和 username 字段,且被正确挂载到 ctx.user。
第三步:排除代理层覆盖头信息
若Nginx或API网关透传了 X-Forwarded-For 但未清理原始 Authorization 头,可能导致鉴权读取到错误Token——此时日志里显示的“操作人”是被冒用的账号。
特殊场景处理方式
方法一:系统级任务(如定时同步)
使用 ctx.setUser({ userId: 'system', username: 'SYSTEM_TASK' }) 主动注入标识,确保日志归因清晰。
方法二:代操作模式(如管理员替用户提交)
需在业务逻辑中显式调用 auditLog.withOperator(operatorId),否则仍记为当前登录管理员,不体现被代操作对象。
方法三:数据库直连变更(绕过API)
Zion操作日志对此类行为【完全无记录】,必须通过数据库触发器或Binlog监听单独补全审计链路。











