📚 课程目录第4章接口编排核心概念

4. 接口编排核心概念

接口编排是构建复杂业务回放系统的中枢神经。本章围绕编排引擎的设计思想、DSL 与代码编排的权衡、以及编排与工作流的本质区别展开，帮助你在 Go 业务环境中做出正确的架构决策。

4.1 编排引擎设计思想

编排引擎的核心职责是：将一组离散的接口调用，按照业务语义组织成可执行、可观测、可恢复的执行计划。在 Go 业务回放场景中，编排引擎需要同时满足三个设计目标：

确定性：相同输入 + 相同编排 = 相同执行轨迹，这是回放可复现的基础。
可中断与可恢复：编排执行过程中允许暂停、持久化状态、重启后从断点继续。
可观测性：每个步骤的入参、出参、耗时、错误码都能被记录和查询。

  设计原则：编排引擎不应感知业务逻辑，只负责"何时调用、如何传递数据、失败后怎么走"。业务规则由编排定义（DSL 或代码）注入。

下图展示了一个通用编排引擎的内部架构：

Go 实现提示：在 Go 中，编排引擎的"步骤"通常定义为 Step interface{ Execute(ctx context.Context, input map[string]any) (output map[string]any, err error) }，通过组合模式构建执行树。

4.2 DSL vs 代码编排

编排定义的两种主流方式——DSL（领域特定语言）与代码编排——各有适用场景。下表从多个维度进行对比：

对比维度	DSL 编排	代码编排
定义方式	YAML / JSON / 自定义语法文件	Go 代码直接编写
可读性	非开发人员可理解	仅开发人员可维护
灵活性	受限于 DSL 语法能力	完全图灵完备
调试难度	需要 DSL 解析器支持断点	原生 IDE 调试
热更新	支持（配置文件重载）	需重新编译部署
类型安全	运行时校验	编译期检查
适用场景	业务人员可配置、多环境差异	复杂逻辑、高性能要求

在 Go 业务回放场景中，推荐混合策略：

使用 YAML DSL 定义接口调用顺序、数据映射、重试策略等"配置型"内容。
使用 Go 代码 实现自定义步骤（如数据转换、条件判断、外部服务调用）。
DSL 中通过 type: custom 字段引用 Go 中注册的步骤工厂。

避坑：不要试图用 DSL 实现所有逻辑。当编排中出现大量条件分支、循环、异常处理时，应果断切换到代码编排，否则 DSL 会变得难以维护且性能低下。

下面是一个典型的 YAML DSL 编排定义示例：

# replay_orchestration.yaml
version: "1.0"
steps:
  - id: login
    type: http
    method: POST
    url: "{{ .base_url }}/api/login"
    body:
      username: "{{ .input.username }}"
      password: "{{ .input.password }}"
    output:
      token: "$.data.token"

  - id: query_order
    type: http
    depends_on: [login]
    method: GET
    url: "{{ .base_url }}/api/orders/{{ .input.order_id }}"
    headers:
      Authorization: "Bearer {{ .steps.login.output.token }}"
    retry:
      max_attempts: 3
      backoff: exponential

  - id: validate_result
    type: custom
    step_ref: "order_validator"
    depends_on: [query_order]
    input:
      expected_status: "{{ .input.expected_status }}"
      actual_order: "{{ .steps.query_order.output }}"

4.3 编排与工作流的区别

编排（Orchestration）与工作流（Workflow）经常被混用，但在业务回放场景中，二者有本质区别：

维度	编排（Orchestration）	工作流（Workflow）
核心关注点	接口调用顺序与数据传递	任务状态流转与审批链路
执行模型	有向无环图（DAG）为主	有环图（支持循环、回退）
状态持久化	轻量级快照（入参/出参）	重量级状态机（待办/已办/驳回）
典型场景	API 回放、数据同步、服务编排	审批流、工单流转、流程审批
失败处理	重试 + 降级 + 跳过	驳回 + 重新提交 + 人工干预
Go 实现复杂度	中等（DAG 调度 + 数据映射）	高（状态机 + 权限 + 历史）

下图直观展示了两者在执行模型上的差异：

选型建议：如果你的业务回放场景需要"按顺序调用接口、传递数据、失败重试"，选择编排。如果涉及"多角色审批、状态回退、人工决策"，则应该使用工作流引擎。在 Go 生态中，temporal.io 和 cadence 是兼顾两者的成熟方案。

4.4 本章小结

编排引擎设计应围绕确定性、可中断恢复、可观测性三大目标。
DSL 适合配置型编排，代码编排适合复杂逻辑；推荐混合策略。
编排（DAG 模型）与工作流（状态机模型）有本质区别，选型取决于是否需要状态回退与人工介入。