4. 版本管理：语义化版本规范（SemVer）、发布包版本号规则、版本兼容性策略

在 Serverless Eventing 生命周期中，发布包（如 Knative Broker 的 Trigger 配置、CloudEvents 扩展协议、自定义函数包）的版本管理是保障系统稳定演进的核心。版本号不仅是标识，更是发布包之间兼容性契约的载体。本节围绕语义化版本规范（SemVer）、发布包版本号规则以及版本兼容性策略展开，帮助你在发布包校验流程中建立可靠的版本治理体系。

4.1 语义化版本规范（SemVer）

语义化版本规范（Semantic Versioning，简称 SemVer）是目前云原生生态中最广泛采用的版本号格式。其核心格式为：MAJOR.MINOR.PATCH，每个字段的含义与变更类型严格绑定。

在 Serverless Eventing 场景中，SemVer 的严格应用意味着：

• MAJOR 版本变更：例如 Trigger 的过滤表达式语法从 v1 升级到 v2，旧版表达式不再被解析，必须更新所有订阅方。
• MINOR 版本变更：例如在 CloudEvents 扩展属性中新增一个可选字段 datacontenttype，已有消费者不受影响。
• PATCH 版本变更：例如修复 Broker 在特定事件源下的重试逻辑 bug，不改变任何接口或行为契约。

4.2 发布包版本号规则

除了 SemVer 基础格式，Serverless Eventing 发布包通常还需要附加额外的版本标识，以支持多维度管理。常见的版本号规则包括：

• 基础 SemVer：1.2.3，用于标识发布包的功能与修复状态。
• 构建元数据：1.2.3+build.20250301，用于记录构建时间或 CI 流水线编号，不影响兼容性。
• 预发布标签：1.2.3-rc.1，用于发布候选版本，在正式发布前进行集成验证。
• 平台/环境后缀：1.2.3-knative 或 1.2.3-aws，用于标识特定平台适配版本。

以下是一个典型的发布包版本号规则表：

function validateVersion(version, environment):
    if not match(version, r'^\d+\.\d+\.\d+'):
        reject("版本号格式不符合 SemVer")
    if environment == "production":
        if contains(version, "alpha") or contains(version, "beta"):
            reject("生产环境禁止预发布版本")
        if contains(version, "rc"):
            requireManualApproval()
    return accept()

4.3 版本兼容性策略

版本兼容性策略决定了发布包在升级过程中对上下游系统的影响范围。在 Serverless Eventing 中，兼容性策略通常分为三类：向后兼容、向前兼容 和 完全兼容。以下通过一个内联 SVG 图展示三种策略在事件发布包生命周期中的适用场景。

4.4 版本兼容性校验流程

在发布包校验阶段，版本兼容性校验是防止生产事故的关键防线。以下是一个典型的版本兼容性校验流程，包含四个核心步骤：

1. 版本号解析：提取发布包的 MAJOR.MINOR.PATCH，并与当前已部署版本进行对比。
2. 变更类型判定：通过 diff 工具分析发布包与上一版本的差异，自动归类为 MAJOR、MINOR 或 PATCH 变更。
3. 兼容性规则匹配：根据变更类型匹配预设的兼容性策略（如 MAJOR 变更必须触发人工审批）。
4. 阻断或放行：如果违反兼容性规则（如生产环境出现 MAJOR 变更但未提供迁移方案），则阻断发布。

以下是一个版本兼容性校验的决策矩阵：

通过上述版本管理规范、版本号规则以及兼容性策略的组合，Serverless Eventing 发布包校验能够在保证系统稳定性的前提下，支持快速迭代与安全发布。下一节将深入探讨发布包签名与完整性校验的具体实现。