# [063][调度模块]事件驱动的日志记录与高效查询体系



## 1. 事件驱动架构：解耦调度与日志

任务状态变更时，`ScheduleTaskManager` 发布 `ChangeStatusEvent`，`JobLogEventConsumer` 异步消费（需配置 `@Async`）。

```java
@Slf4j
@Component
@RequiredArgsConstructor
public class JobLogEventConsumer implements ChangeStatusEventConsumer {
    private final JobLogRepository jobLogRepository;
    private final JobRepository jobRepository;

    @Override
    @Async  // ✅ 异步执行，不阻塞主调度线程
    @Transactional(propagation = Propagation.REQUIRES_NEW)  // ✅ 独立事务，不受业务回滚影响
    public void consumer(ChangeStatusEvent event) {
        TaskRuntimeData runtimeData = event.taskRuntimeData();
        jobRepository.findByTaskCode(runtimeData.taskCode())
            .ifPresentOrElse(
                task -> {
                    JobLogEntity log = new JobLogEntity();
                    log.setJob(task);
                    log.setTaskStatus(runtimeData.taskStatus());
                    log.setLotNo(runtimeData.lotNo());
                    log.setTotalCount(runtimeData.totalCount());
                    log.setTotalFailureCount(runtimeData.totalFailureCount());
                    log.setStartTime(runtimeData.startTime());
                    log.setEndTime(runtimeData.endTime());
                    
                    // 异常信息智能截取
                    Throwable throwable = runtimeData.throwable();
                    if (throwable != null) {
                        log.setHasError(YesNoEnum.Y);
                        log.setMessage(StringUtils.substring(
                            ExceptionUtils.getSelfStackTrace(throwable), 0, 500));
                    } else {
                        log.setHasError(YesNoEnum.N);
                        log.setMessage(runtimeData.message());
                    }
                    
                    jobLogRepository.save(log);
                },
                () -> log.warn("任务不存在，无法记录日志，taskCode={}", runtimeData.taskCode())
            );
    }
}
```

**技术亮点：**
- **异步+独立事务**：日志写入不影响调度性能，且即使主业务事务回滚，日志依然留存。
- **异常堆栈裁剪**：500 字符限制防止数据截断异常，同时保留关键堆栈信息。
- **空值友好**：使用 `ifPresentOrElse` 优雅处理任务不存在的情况。

## 2. 日志查询的规格模式组合

`JobLogQuery` 支持多条件动态查询，包括关联表（`JobEntity`）字段。

```java
public class JobLogSpecification {
    // 关联查询示例：通过 leftJoin 连接 JobEntity
    public static Specification<JobLogEntity> taskCodeEqual(String taskCode) {
        return (root, query, cb) -> {
            Join<JobLogEntity, JobEntity> jobJoin = leftJoin(root, "job");
            return JobSpecification.taskCodeEqual(jobJoin, taskCode, cb);
        };
    }
    
    // 时间范围查询
    public static Predicate createdAtBetween(Path<JobLogEntity> path, 
                                             Instant start, Instant end, 
                                             CriteriaBuilder cb) {
        Predicate predicate = cb.conjunction();
        if (start != null) {
            predicate = cb.and(predicate, cb.greaterThanOrEqualTo(path.get("createdAt"), start));
        }
        if (end != null) {
            predicate = cb.and(predicate, cb.lessThanOrEqualTo(path.get("createdAt"), end));
        }
        return predicate;
    }
}
```

**技术亮点：**
- **类型安全**：使用 JPA 元模型（Metamodel）或字符串常量，避免硬编码。
- **可组合性**：每个条件都是独立的 `Specification`，可灵活组合复用。

## 3. VO 组装与关联数据补充

`JobLogVO` 在转换时额外填充任务标识字段，避免前端额外请求。

```java
@Data
public class JobLogVO extends BaseVO {
    // 日志自身字段
    private TaskStatusEnum taskStatus;
    private String lotNo;
    private Instant createdAt;
    // ... 其他日志字段
    
    // 关联任务冗余字段（非数据库字段，用于展示）
    private String taskCode;
    private String classSimpleName;

    public static JobLogVO of(JobLogEntity entity) {
        JobLogVO vo = new JobLogVO();
        BeanUtils.copyProperties(entity, vo);
        JobEntity job = entity.getJob();
        if (job != null) {
            vo.setTaskCode(job.getTaskCode());
            vo.setClassSimpleName(job.getClassSimpleName());
        }
        return vo;
    }
}
```

**设计权衡**：
- **优点**：一次查询返回完整信息，减少网络往返。
- **注意**：若 `JobEntity` 中关联数据较大（如 `metadata` 含大量 JSON），不建议全部复制，只取必要字段。

## 4. 日志分页查询接口

```java
@RestController
@RequestMapping("/api/job-log")
@RequiredArgsConstructor
public class JobLogEndpoint {
    private final JobLogService jobLogService;

    @GetMapping("page")
    public ResponseEntity<PagedModel<JobLogVO>> findPage(JobLogQuery query, Pageable pageable) {
        Page<JobLogEntity> page = jobLogService.find(query, pageable);
        return ResponseEntity.ok(new PagedModel<>(page.map(JobLogVO::of)));
    }
}
```

**技术亮点**：
- **Spring Data 集成**：`Pageable` 自动解析分页参数，`PagedModel` 封装分页元数据。
- **VO 映射**：`page.map(JobLogVO::of)` 流式转换，代码简洁。

任务状态变更时，ScheduleTaskManager 发布 ChangeStatusEvent，JobLogEventConsumer 异步消费（需配置 @Async）。

[063][调度模块]事件驱动的日志记录与高效查询体系

开发工具

后端

架构设计

基于事件驱动架构实现调度日志异步解耦，通过@Async与独立事务保障主流程性能。采用规格模式动态组合多条件查询，支持关联表字段过滤。VO层冗余任务标识减少网络请求，异常堆栈智能截取防止数据异常。分页接口集成SpringData，实现高效查询与类型安全。

代码解释

数据库

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

[063][调度模块]事件驱动的日志记录与高效查询体系-腾讯云开发者社区-腾讯云

[063][调度模块]事件驱动的日志记录与高效查询体系

[063][调度模块]事件驱动的日志记录与高效查询体系

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐