推荐订阅源

• 日志模块
  • 1、关于记录用户操作日志的几个认知
  • 2、关于日志的几个认知
  • 3、设计
  • 4、例子
    • 后端维护日志同一性
    • 前端维护日志同一性

日志模块

1、关于记录用户操作日志的几个认知

（1）日志记录内容的设计，应方便后续查询、统计以及日志可视化等，因此可能跨页面、跨接口记录同一日志。
（2）由于是用户操作日志，所以只能由前端触发日志记录。
（3）由前端判断日志的同一性，即哪些操作属于同一条日志的应记录内容，哪些操作需要新建一条日志。

例如，若查询获取结果并记录日志之后，将对该查询结果的导出、打印等视为同一条日志的记录内容（记录是否导出、是否打印），则用户未导出、打印，又重新查询，就需要新建一条日志。或多开页面查询相同条件，就记录多条日志。

• 后端提供接口前端调用时，尽量不交流额外的信息。例如，若由后端判断日志的同一性，则后端需要返回查询结果的标识码，并持续跟踪这个标识码，则可能干扰业务代码（去update旧日志）。前后端传递过多与查询业务无关的参数，不利于代码维护（一个接口干了的活多了）。
• 由前端判断日志的同一性，可方便跨页面、跨接口记录同一日志内容。

（4）为减少请求压力，前端可批量上报日志，或在指定时间内无新日志产生时再上报日志。
（5）区分其他类型的日志，例如，用户登录日志，后端错误日志。这类日志不存在跨页面、跨接口，直接记录即可。

2、关于日志的几个认知

（1）日志完整性：包含 “谁 - 何时 - 何地 - 做了什么 - 结果如何” 核心要素。
（2）应方便后续查询、统计以及日志可视化等。
（3）性能优先，避免阻塞；
（4）可扩展性：支持后续新增操作类型、扩展日志字段；
（5）安全性：敏感数据脱敏（如用户 ID、查询参数中的隐私信息），防止日志泄露。

3、设计

对操作进行分类，并且可扩展操作类型。

（1）日志表的字段：
id，日志编号，生成日志的时间，用户Id，登录ip，日志类型，日志名称，日志内容（存为json）
注：

• 日志类型：一般就是固定的几类，如登录日志、错误日志、操作日志等。
• 日志名称：可以是“日志类型”的补充（子类），或是与功能、业务等相关，例如：“进行用户信息查询”。
• 日志内容：日志名称满足需求时，可以无该字段或不记录日志的内容。存为json，方便前端呈现。

（2）操作类型表的字段
id，名称，显示名称，描述
注：若系统有扩展需求，可对操作进行分类并单独建表。若扩展需求不大，有相应的字典即可。

（3）操作表的字段：
id，日志Id，操作发生的时间，操作类型的名称，是否成功，操作结果内容（存为json）
注：如有必要，前端依据操作类型，使用对应的界面呈现操作结果内容。

4、例子

对每次查询结果进行导出跟踪，并只记录一条记录

后端维护日志同一性

（1）前端发起查询；
（2）后端查询同时记录日志，并返回结果与日志Id；
（2）前端获取查询结果，并记录返回的日志Id；
（3）前端点击导出按钮，请求后端生成excel文件，请求参数携带日志Id；
（4）后端生成excel文件，并提供文件流，同时根据日志Id以更新日志；
（5）前端下载excel文件。

前端维护日志同一性

（1）前端发起查询；
（2）后端查询并返回结果；
（2）前端获取查询结果，并生成日志；
（3）前端点击导出按钮，请求后端生成excel文件；
（4）后端生成excel文件，并提供文件流；
（5）前端下载excel文件，更新日志；
（6）前端上传/批量上传日志，或定时触发上传/批量上传日志。