Logbook 异常处理完全指南:错误日志记录与故障排查终极方案
2026/5/6 22:53:35
以在线考试系统项目为例,结合DDD(领域驱动设计)企业级规范工程和业务流程的设计指南。我会以DDD入门者为目标人群,通过这个在线考试系统,帮助你熟悉DDD的企业级开发流程、核心概念和代码规范。整个设计将分为以下几个部分:
DDD 的核心是通过领域模型来表达业务逻辑,而不是通过技术实现来驱动设计。以下是与考试系统相关的核心概念:
| DDD 概念 | 在线考试系统中的体现 | 说明 |
|---|---|---|
| 领域 | 在线考试业务 | 系统要解决的核心问题空间,如考试管理、题库管理、成绩管理等 |
| 子域 | 核心子域:考试执行;支撑子域:用户管理;通用子域:通知服务 | 根据业务重要性划分 |
| 限界上下文 | 考试上下文、题库上下文、成绩上下文等 | 每个上下文有独立的领域模型和统一语言 |
| 实体 | 考生(ID唯一)、试卷(ID唯一) | 有唯一标识,状态可变 |
| 值对象 | 考试时长、题目分数 | 无唯一标识,不可变 |
| 聚合根 | 考试聚合根(包含题目、规则) | 保护聚合内的一致性 |
| 领域事件 | 考试开始事件、交卷事件 | 表示领域中发生的重要事情 |
战略设计是 DDD 的核心,用于界定业务边界和服务划分。以下是考试系统的子域和限界上下文划分示例:
| 限界上下文 | 职责 | 关联子域 |
|---|---|---|
| 考试上下文 | 考试生命周期管理(创建、开始、结束) | 核心子域 |
| 题库上下文 | 题目的增删改查、批量导入、分类 | 核心子域 |
| 成绩上下文 | 成绩计算、统计、发布 | 支撑子域 |
| 用户上下文 | 考生、教师、管理员的身份管理 | 支撑子域 |
考试上下文 ──→ 题库上下文(通过防腐层获取题目) │ └─→ 成绩上下文(通过领域事件「考试完成」触发成绩计算)💡提示:限界上下文之间通过防腐层或领域事件解耦,避免直接依赖。
针对考试系统,我们采用 DDD 经典四层架构(或六边形架构),确保领域层独立于技术和应用逻辑。
| 层级 | 职责 | 示例代码包结构 |
|---|---|---|
| 用户接口层 | 接收前端请求(Vue3),返回 DTO | exam-web/src/api/ |
| 应用层 | 协调领域对象,处理业务流程(如组卷用例) | exam-service/src/main/java/com/exam/application/ |
| 领域层 | 核心业务逻辑(实体、聚合根、领域服务) | exam-service/src/main/java/com/exam/domain/ |
| 基础设施层 | 数据库持久化、消息队列、外部 API | exam-service/src/main/java/com/exam/infrastructure/ |
// 聚合根:考试publicclassExamimplementsAggregateRoot{privateExamIdid;privateStringtitle;privateDurationduration;privateList<Question>questions;// 值对象列表privateExamStatusstatus;publicvoidstart(){this.status=ExamStatus.IN_PROGRESS;this.registerEvent(newExamStartedEvent(this.id));}}// 领域事件:考试开始publicclassExamStartedEventimplementsDomainEvent{privateExamIdexamId;privateInstantstartedAt;}💡提示:领域层不依赖任何外部框架,确保业务逻辑纯净。
以下是一个核心业务流程的 DDD 实现示例:
exam.start()ExamStartedEvent考试上下文 → 发布「考试开始事件」 → 消息队列 → 成绩上下文订阅事件 → 生成成绩记录exam-service/ # 后端服务 ├── src/main/java/com/exam/ │ ├── application/ # 应用层 │ │ ├── ExamApplicationService.java │ │ └── dto/ # DTO 类 │ ├── domain/ # 领域层 │ │ ├── model/ # 实体、值对象 │ │ ├── service/ # 领域服务 │ │ └── events/ # 领域事件 │ ├── infrastructure/ # 基础设施层 │ │ ├── persistence/ # 仓储实现 │ │ └── message/ # 消息发布 │ └── interfaces/ # 用户接口层 │ ├── web/ # REST 控制器 │ └── facade/ # 门面类Exam、QuestionExamGenerationServiceExamRepositoryExamStartedEvent通过以上设计,你可以将 DDD 的企业级规范应用到在线考试系统中。关键是:
对于 DDD 入门者,建议从一个小上下文(如题库管理)开始实践,逐步扩展到整个系统。