主题
API 错误日志
INF-LOG-02 | 模块
infra| 把未捕获异常集中记录,避免错误只停留在用户截图里。
1. 使用角色与场景
角色:运维、开发者
- 按异常类型聚合排查线上 500
- 把错误日志与访问日志按 traceId 关联
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| PUT | /infra/api-error-log/update-status | infra:api-error-log:update-status | 更新 API 错误日志的状态 | ApiErrorLogController#L40 |
| GET | /infra/api-error-log/get | infra:api-error-log:query | 获得 API 错误日志 | ApiErrorLogController#L53 |
| GET | /infra/api-error-log/page | infra:api-error-log:query | 获得 API 错误日志分页 | ApiErrorLogController#L62 |
| GET | /infra/api-error-log/export-excel | infra:api-error-log:export | 导出 API 错误日志 Excel | ApiErrorLogController#L70 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/infra/src/main/java/com/pmforge/module/infra/controller/admin/logger/ApiErrorLogController.java#L40 |
| DO | modules/infra/src/main/java/com/pmforge/module/infra/dal/dataobject/logger/ApiErrorLogDO.java |
4. 数据表
| 表 | DO |
|---|---|
infra_api_error_log | ApiErrorLogDO |
5. 机制与配置
- 全局异常处理器捕获后落库,带堆栈与请求上下文
6. 常见问题与排查
- 日志含请求参数,注意脱敏与保留时长
7. 关联
- 需求原件:02-05-监控运维
- 相关卡片:INF-LOG-01