日志接口

接口列表

接口	方法	说明
/api/v1/logs/login	GET	获取登录日志
/api/v1/logs/operation	GET	获取操作日志
/api/v1/logs/login/{id}	DELETE	删除登录日志
/api/v1/logs/operation/{id}	DELETE	删除操作日志
/api/v1/logs/login/clean	DELETE	清空登录日志
/api/v1/logs/operation/clean	DELETE	清空操作日志
/api/v1/logs/operation/export	GET	导出操作日志

获取登录日志

GET /api/v1/logs/login?pageNum=1&pageSize=10
Authorization: Bearer {accessToken}

查询参数：

参数	类型	必填	说明
pageNum	number	❌	页码
pageSize	number	❌	每页条数
username	string	❌	用户名
ip	string	❌	IP 地址
status	number	❌	状态（1 成功，0 失败）
startTime	string	❌	开始时间
endTime	string	❌	结束时间

响应示例：

{
  "code": "00000",
  "message": "成功",
  "data": {
    "total": 256,
    "list": [
      {
        "id": 1,
        "username": "admin",
        "ip": "192.168.1.100",
        "location": "北京市",
        "browser": "Chrome 120",
        "os": "Windows 11",
        "status": 1,
        "message": "登录成功",
        "loginTime": "2024-01-15 10:30:00"
      }
    ]
  }
}

获取操作日志

GET /api/v1/logs/operation?pageNum=1&pageSize=10
Authorization: Bearer {accessToken}

查询参数：

参数	类型	必填	说明
pageNum	number	❌	页码
pageSize	number	❌	每页条数
title	string	❌	操作标题
moduleName	string	❌	模块名称
username	string	❌	操作人
status	number	❌	状态（1 成功，0 失败）
startTime	string	❌	开始时间
endTime	string	❌	结束时间

响应示例：

{
  "code": "00000",
  "message": "成功",
  "data": {
    "total": 1024,
    "list": [
      {
        "id": 1,
        "title": "用户登录",
        "moduleName": "系统管理",
        "methodName": "login",
        "requestMethod": "POST",
        "requestUrl": "/api/v1/auth/login",
        "requestParams": "{\"username\":\"admin\"}",
        "responseResult": "{\"code\":\"00000\"}",
        "ip": "192.168.1.100",
        "username": "admin",
        "status": 1,
        "errorMsg": null,
        "executeTime": 156,
        "operationTime": "2024-01-15 10:30:00"
      }
    ]
  }
}

导出操作日志

GET /api/v1/logs/operation/export?startTime=2024-01-01&endTime=2024-01-31
Authorization: Bearer {accessToken}

返回 Excel 文件流。

日志状态

值	说明
1	成功
0	失败

权限要求

操作	权限标识
查看登录日志	sys:log:login:list
删除登录日志	sys:log:login:delete
清空登录日志	sys:log:login:clean
查看操作日志	sys:log:operation:list
删除操作日志	sys:log:operation:delete
清空操作日志	sys:log:operation:clean
导出操作日志	sys:log:operation:export

注意事项

1. 登录日志会自动记录所有登录行为（成功/失败）
2. 操作日志通过 @Log 注解自动记录，无需手动调用
3. 日志数据保留 90 天，超期自动清理
4. 清空操作不可恢复，请谨慎操作