历史重大变更

本文档概述了 API7 企业版在不同版本中引入的重大变更。这些变更可能会影响你现有的配置和工作流。在升级前，请仔细阅读目标版本的相关变更说明，以确保平滑过渡。

3.9.2

发布日期：2026-01-19

• OpenID Connect

  当 bearer_only 为 false（默认值）时，session.secret 字段现为必填项。此前未配置该字段时，每个数据面实例会各自自动生成随机密钥，导致会话无法在多个网关实例间共享。从旧版本升级后，未配置 session.secret 的存量 openid-connect 插件配置（bearer_only 为 false 或未设置）将无法通过数据面的 schema 校验，其所在路由将停止服务。请在升级数据面之前配置 session.secret 字段（至少 16 个字符，所有网关实例使用相同的值）。

3.6.0

发布日期：2025-02-26

• 移除了服务模板中的服务运行配置，以便在不同的网关组之间更好地复用模板。服务模板中原有的服务运行配置将被移除，但你已发布的服务配置将保持不变。 此外，服务发布流程得到了简化和优化，发布过程中不再允许包含服务运行配置。请参阅更新后的发布服务指南。

注意

ADC 版本兼容性：从该版本开始，API7 企业版不再兼容 0.18.0 之前的 ADC 版本。请确保你使用的是 ADC 0.18.0 或更高版本，以避免兼容性问题。

3.5.0

发布日期：2025-01-27

• 服务中的多个上游：对于金丝雀发布、蓝绿部署或管理多个集群等高级场景，一个服务现在可以使用多个上游。在这种情况下，默认上游将作为大多数请求的主要目标，而其他上游可用于特定目的，例如将流量路由到金丝雀部署或备用集群。详情请参阅更新后的配置金丝雀流量切分。

注意

旧版的**金丝雀规则（Canary Rule）**功能不再可用。