3. 标准模板结构定义：模板元数据、请求模板、响应模板、错误模板的通用字段设计

标准模板是混沌工程基线核验的契约载体。一个完整的模板由模板元数据、请求模板、响应模板和错误模板四个部分组成。本章定义每个部分的通用字段及其设计原则，确保模板在不同微服务、不同协议（HTTP/gRPC/消息队列）之间具备一致的解析能力。

3.1 模板元数据（Template Metadata）

模板元数据描述模板本身的身份、版本、归属和生命周期信息，是模板检索、版本管理和基线匹配的入口。通用字段如下：

3.2 请求模板（Request Template）

请求模板定义混沌工程注入时发送的请求结构，包括请求头、查询参数、请求体和校验规则。通用字段如下：

{
  "headers": {
    "Content-Type": "application/json",
    "X-Request-Id": "{{request_id}}"
  },
  "query_params": {
    "page": "{{page}}",
    "size": "{{size}}"
  },
  "body": {
    "order_id": "{{order_id}}",
    "status": "{{status}}"
  },
  "variable_definitions": [
    {
      "name": "order_id",
      "type": "string",
      "default": "ORD-2024-001",
      "range": null
    },
    {
      "name": "page",
      "type": "integer",
      "default": 1,
      "range": [1, 1000]
    }
  ]
}

3.3 响应模板（Response Template）

响应模板定义基线核验时对返回结果的期望结构，用于比对实际响应与基线之间的差异。通用字段如下：

3.4 错误模板（Error Template）

错误模板定义混沌工程注入时预期可能出现的错误场景，用于验证系统在异常条件下的容错行为。通用字段如下：

{
  "error_code": "ORDER_SERVICE_TIMEOUT",
  "http_status": 504,
  "message_pattern": ".*timeout.*",
  "retryable": true,
  "impact_level": "critical",
  "expected_behavior": "触发网关重试机制，最多重试3次后返回降级响应",
  "error_body_schema": {
    "type": "object",
    "required": ["code", "message"],
    "properties": {
      "code": { "type": "string", "enum": ["ORDER_SERVICE_TIMEOUT"] },
      "message": { "type": "string" },
      "request_id": { "type": "string" }
    }
  }
}

3.5 四模板关系与核验流程

下图展示了四个模板在混沌工程基线核验中的协作关系：

3.6 通用字段设计原则

• 最小必填原则： 每个模板只定义最少的必填字段，其余字段提供默认值或允许为空，降低模板编写门槛。
• 向前兼容原则： 新增字段时不得破坏已有模板的解析逻辑，旧模板缺失新字段时使用默认值。
• 可扩展原则： 所有模板支持 extensions 字段（map[string]any），用于承载业务自定义属性。
• 可追溯原则： 模板元数据中的 version 和 updated_at 必须随每次变更递增，确保基线版本可追溯。
• 环境隔离原则： 通过 tags 字段区分开发、测试、预发、生产环境的模板配置，避免环境间基线污染。