4. 功能开关类型

功能开关（Feature Flag）的类型决定了其生效逻辑与适用场景。在发布工程自助门户中，正确选择开关类型是控制发布风险、实现精细化灰度与自动化运维的基础。本章详细解析五种核心开关类型的设计原理、配置参数与典型应用。

4.1 开关类型总览

下表从生效维度、配置复杂度、典型场景三个角度对比五种开关类型，帮助你在设计开关方案时快速选型。

4.2 Boolean 开关

Boolean 开关是最基础的开关类型，仅包含 true（开启）和 false（关闭）两种状态。它通常绑定到特定环境（如开发、预发布、生产），用于控制功能的全局可见性。

// Boolean 开关配置示例（JSON）
{
  "flagKey": "new-checkout-flow",
  "type": "boolean",
  "environments": {
    "development": true,
    "staging": true,
    "production": false
  }
}

4.3 百分比开关

百分比开关将流量按比例分配到开启或关闭组。它常用于金丝雀发布：先让 5% 的流量体验新功能，观察无异常后逐步提升至 100%。

百分比开关的核心机制是一致性哈希：对用户 ID、设备 ID 或请求 ID 进行哈希计算，确保同一用户在多次请求中始终落在同一分组，避免体验不一致。

// 百分比开关配置示例
{
  "flagKey": "recommendation-v2",
  "type": "percentage",
  "hashBy": "userId",
  "rules": [
    {
      "percentage": 10,
      "variant": "on"
    },
    {
      "percentage": 90,
      "variant": "off"
    }
  ]
}

4.4 用户分段开关

用户分段开关基于用户属性（如地域、会员等级、设备类型、内部员工标识）进行条件匹配。它允许你精确指定哪些用户群体可以访问新功能，而不依赖随机流量。

在自助门户中，用户分段开关通常与用户画像系统或身份认证服务集成，支持以下常见分段策略：

• 白名单分段：指定一组用户 ID 或邮箱，仅这些用户可见新功能。
• 属性分段：基于用户标签（如 country: CN、tier: gold）进行匹配。
• 百分比内嵌套分段：先筛选出特定用户群体，再对该群体内的流量进行百分比分配。

// 用户分段开关配置示例
{
  "flagKey": "premium-feature-x",
  "type": "segment",
  "segments": [
    {
      "name": "internal-testers",
      "conditions": {
        "email": { "endsWith": "@company.com" }
      },
      "variant": "on"
    },
    {
      "name": "gold-users",
      "conditions": {
        "tier": { "equals": "gold" }
      },
      "variant": "on"
    }
  ],
  "defaultVariant": "off"
}

4.5 时间窗口开关

时间窗口开关根据当前时间与预设时间范围的匹配结果决定开关状态。它支持一次性时间窗口和周期性时间窗口（如每周五 20:00-22:00）。

时间窗口开关在发布工程中常用于：

• 定时上线：新功能在指定日期自动开启，无需人工干预。
• 限时活动：活动结束后自动关闭，避免遗忘导致功能残留。
• 维护窗口：在低峰期自动切换流量到备用系统。

// 时间窗口开关配置示例
{
  "flagKey": "holiday-theme",
  "type": "timeWindow",
  "timezone": "Asia/Shanghai",
  "windows": [
    {
      "start": "2025-12-24T00:00:00",
      "end": "2025-12-26T23:59:59",
      "variant": "on"
    }
  ],
  "defaultVariant": "off"
}

4.6 自定义规则开关

自定义规则开关是最灵活的开关类型，允许通过表达式引擎或脚本语言定义任意复杂的条件组合。它通常用于业务逻辑高度定制化的场景，例如：

• 同时满足“用户等级为 VIP”且“当前时间在活动期内”且“设备系统为 iOS 15+”才开启。
• 基于实时风控分数动态决定是否展示某个支付渠道。
• 根据 A/B 实验分组结果叠加功能开关。

在自助门户中，自定义规则开关通常提供可视化规则编辑器或 DSL（领域特定语言）输入框，降低配置门槛。

// 自定义规则开关配置示例（伪代码 DSL）
{
  "flagKey": "dynamic-pricing",
  "type": "custom",
  "ruleEngine": "expr",
  "rule": "user.tier == 'platinum' && (time.hour >= 10 && time.hour < 22) && !blacklist.contains(user.id)",
  "variantOn": "new-pricing",
  "variantOff": "legacy-pricing"
}

4.7 开关类型选择决策流程

以下 SVG 流程图展示了在自助门户中如何根据发布需求选择最合适的开关类型。决策路径从需求粒度出发，逐步收敛到具体类型。

4.8 开关类型组合使用

在实际发布工程中，单一开关类型往往无法满足复杂场景。自助门户支持将多种开关类型进行层级组合，形成更精细的发布策略。常见的组合模式包括：

• 时间窗口 + 百分比：在活动期间内，逐步放量给更多用户。
• 用户分段 + 百分比：先筛选出内测用户群体，再对该群体内的 50% 用户开启功能。
• Boolean + 自定义规则：全局开关作为总闸，自定义规则作为细粒度控制。

以下 SVG 图展示了组合开关的评估优先级与数据流。

4.9 开关类型选型检查清单

在自助门户中配置功能开关前，建议对照以下清单进行选型确认：