操作日志

操作日志装饰器自动记录写请求（POST/PUT/DELETE/PATCH）的操作日志，无需手动埋点。源码位于 src/common/middleware/operation_log.py。

工作原理

1. Handler 方法通过 @operation_log 装饰器标记需要记录的操作
2. 装饰器在 Handler 方法执行前后记录时间和参数
3. 方法执行完成后同步记录操作日志到数据库
4. 记录请求参数、响应结果、耗时、操作类型

排除路径

以下路径不记录操作日志：

_EXCLUDE_PATHS = (
 '/api/v1/login',
 '/api/v1/logout',
 '/api/v1/captcha',
 '/api/v1/upload',
 '/api/v1/loginlog',
 '/api/v1/operationlog',
 '/api/v1/index/menu',
 '/api/v1/index/user',
)

操作类型自动推断

中间件根据 URL 路径末段自动推断操作类型，映射表定义在 _TYPE_MAP 中：

_TYPE_MAP = {
    'add': 1,            # 新增
    'update': 2,         # 修改
    'delete': 3,         # 删除
    'batchdelete': 4,    # 批量删除
    'status': 5,         # 状态设置
    'resetpwd': 6,       # 重置密码
    'updatepassword': 7, # 修改密码
    'import': 8,         # 导入
    'export': 9,         # 导出
    'kickout': 10,       # 强退
    'generate': 11,      # 生成代码
    'clear': 12,         # 清空数据
    'auth': 13,          # 授权
    'refresh': 14,       # 缓存
    'openaccount': 15,   # 开账号
}

def _infer_type(request) -> int:
    """从 URL 路径末段推断操作类型，匹配不到返回 0（其它）"""
    path = request.path.rstrip('/')
    last_segment = path.split('/')[-1].lower()
    # 跳过纯数字路径参数（如 /delete/123 → 取 delete）
    if last_segment.isdigit():
        parts = path.split('/')
        last_segment = parts[-2].lower() if len(parts) >= 2 else ''
    return _TYPE_MAP.get(last_segment, 0)

路径末段	操作类型	类型ID
add	新增	1
update	修改	2
delete	删除	3
batchdelete	批量删除	4
status	状态设置	5
resetpwd	重置密码	6
updatepassword	修改密码	7
import	导入	8
export	导出	9
kickout	强退	10
generate	生成代码	11
clear	清空数据	12
auth	授权	13
refresh	缓存	14
openaccount	开账号	15
其它	其它	0

日志字段

字段	说明
title	操作标题（从路由 summary 获取）
type	操作类型（自动推断）
method	路由方法名（如 v1.level.add）
url	请求路径
param	请求参数（截取前2000字符）
result	响应结果（截取前2000字符）
consume_time	耗时（毫秒）
status	状态：0-成功 1-失败
error	错误信息
create_user	操作人姓名（realname）

查询接口

GET /api/v1/oper/log/list?pageNo=1&pageSize=10
GET /api/v1/oper/log/detail/{id}

性能优化

1. 装饰器模式：仅对标记了 @operation_log 的 Handler 记录日志
2. 长度截断：参数和结果截取前 2000 字符，防止撑爆日志表
3. 路径排除：登录/验证码等高频路径不记录
4. IP 归属地：通过 ip2region 离线库解析，无网络开销

总结

操作日志模块具备以下特点：

1. 装饰器标记：通过 @operation_log 装饰器标记需要记录的 Handler
2. 类型推断：根据 URL 路径自动推断操作类型
3. 同步落库：Handler 方法执行完成后同步记录到数据库
4. 性能友好：长度截断 + 路径排除
5. 完整信息：记录参数、结果、耗时、操作人、IP 归属地等