配置HeaderField亲和实现会话亲和-函数计算-阿里云

HeaderField亲和功能允许通过HTTP请求头中的指定字段实现会话亲和，支持客户端传入或服务端生成两种模式，将携带相同HeaderField值的请求路由到同一个函数实例。

核心配置

在函数配置页面的高级配置 > 隔离性、亲和性中，开启会话亲和开关，选择HeaderField 亲和，配置Header Name（如mySessionId）、单实例并发 Session 数、会话生命周期配置，点击部署即可启用。

客户端可在请求头中携带自定义Session ID，或由服务端自动生成并在响应头中返回。

通用限制：使用前请先阅读会话亲和通用限制及原理说明。
会话 ID 来源：
- 若客户端在预定义 Header 中传入会话 ID，则以该值作为会话标识。
  1. 长度限制为 [1,64]
  2. 以字母、数字或下划线开头，后面可跟字母、数字、下划线或连字符（-）的字符串
- 若未传入，服务端将生成全局唯一会话 ID，通过CreateFunction预定义的Header字段，通过响应 Header 返回。
Header 字段定义：在创建函数时，于 SessionAffinityConfig 中指定用于传输会话 ID 的 Header 字段名。
请求限制
- 单实例可同时处理多个Session（默认20个，最大200个），当单实例下绑定的Session数达到上限时，系统自动创建新实例
- 多个Session共享实例的200并发度配额
支持 SessionAPI 管理：可通过 SessionAPI 对会话进行生命周期管理（如创建、更新、查询、终止等）。

配置HeaderField亲和包括四个步骤：开启会话亲和、选择HeaderField类型、配置Header Name、配置参数并部署。可在创建函数时配置，也可为已有函数补充配置。

目的：设置用于传递Session ID的HTTP请求头名称。

操作步骤：

在Header Name输入框中，输入自定义的Header名称

目的：设置Session数量、生命周期和空闲时长，控制会话绑定和资源使用。

操作步骤：

单实例并发 Session 数：设置单实例可同时处理的最大Session数
- 默认值：20
- 取值范围：1-200
- 建议：测试场景可设置为较小值（如10），生产环境根据业务需求调整
单个 Session 生命周期：设置Session从创建到销毁的最长时长
- 默认值：21600秒（6小时）
- 说明：超过此时间后，系统自动销毁Session，不再保证亲和性
Session Idle时长：设置Session空闲多长时间后自动销毁
- 默认值：1800秒（30分钟）
- 说明：实例无请求超过此时长，Session进入空闲状态并自动销毁
点击部署按钮保存配置

重要提示：

目的：验证相同HeaderField值的请求路由到同一实例，以及实例自动扩容机制。

可以通过在控制台函数详情页，查看实例扩容变化。

操作步骤：

准备测试环境
- 确保函数已部署并配置了HeaderField亲和（Header Name = mySessionId，单实例并发 Session 数建议设置为2）
- 在函数详情页，点击触发器，获取函数的HTTP触发器地址
- 如果HTTP触发器使用签名认证，建议修改为匿名访问以便测试
测试服务端生成模式

# 第一次请求，不携带Header，服务端会自动生成Session ID
curl -v http://your-function-url/your-path

# 使用提取的Session ID发起后续请求
curl -v -H "mySessionId: <从响应中提取的Session ID>" http://your-function-url/your-path

# 客户端主动传入Session ID
curl -v -H "mySessionId: session-2" http://your-function-url/your-path

# 客户端传入新的Session ID
curl -v -H "mySessionId: session-3" http://your-function-url/your-path

预期结果：

区别：

选择建议：