Cookie亲和配置

核心配置

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

首次请求时系统会自动在响应头中植入Cookie，客户端后续请求携带此Cookie即可路由到同一实例。

适用范围

• 通用限制：使用前建议先阅读会话亲和通用限制及原理说明；

• 仅支持服务端植入 Cookie 模式：客户端首次访问时，函数计算自动在响应中通过 Set-Cookie Header 植入 Cookie。客户端需解析并保存该 Cookie，并在后续请求中携带。

• 请求限制：

  • 单实例可同时处理多个Session（默认20个，最大200个），当单实例下绑定的Session数达到上限时，系统自动创建新实例

  • 多个Session共享实例的200并发度配额

• 支持 SessionAPI 管理：可通过 SessionAPI 对会话进行生命周期管理（如创建、更新、查询、终止等）。

配置Cookie亲和

验证Cookie亲和功能

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

• 相同Cookie值的请求路由到同一实例

• 当实例Session数达到上限时，系统自动创建新实例

• 所有请求都成功返回（状态码200）

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

操作步骤：

1. 准备测试环境

   • 确保函数已部署并配置了Cookie亲和（单实例并发 Session 数建议设置为2以便测试）

   • 获取函数的HTTP触发器地址

   • 测试时可以将HTTP触发器使用签名认证，修改为匿名访问以便测试：

     • 进入函数详情页面的触发器标签页

     • 点击触发器的编辑按钮

     • 将认证方式修改为匿名访问

     • 保存配置

2. 第一次请求：不带Cookie，系统会自动植入Cookie

   • 发起第一个请求：curl -i http://your-function-url/

     在函数详情页，点击HTTP触发器，可以获取临时验证的url。

     示例：

     curl -i https://test-cookies-b*******v.cn-hangzhou.fcapp.run

   • 预期结果：

     Content-Length: 13
     Content-Type: text/html; charset=utf-8
     Set-Cookie: x-fc-cookie-session-id=3******a-c**5-4**0-a**4-e**********4; Max-Age=21600
     X-Fc-Request-Id: 1-******e8-******c9-e**********8
     Date: Tue, 30 Dec 2025 11:47:53 GMT
     Hello, World!%

   • 从响应头中提取 Set-Cookie 中的Cookie值（x-fc-cookie-session-id）

   • 记录响应中的X-Fc-Request-Id（可用于分析请求路由情况）

3. 第二次请求：使用提取的Cookie值发起请求

   • 验证同一Session路由到同一实例，其中<first-x-fc-cookie-session-id>需替换为上一步提取的 Set-Cookie中x-fc-cookie-session-id的值

     curl -i -b "x-fc-cookie-session-id=<first-x-fc-cookie-session-id>" https://your-function-url/

     示例：

     curl -i -b "x-fc-cookie-session-id=3******a-c**5-4**0-a**4-e**********4" https://test-cookies-b********v.cn-hangzhou.fcapp.run

   • 预期结果：

     HTTP/1.1 200 OK
     Content-Length: 13
     Content-Type: text/html; charset=utf-8
     X-Fc-Request-Id: 1-******cb-******16-e**********2
     Date: Tue, 30 Dec 2025 12:12:59 GMT
     Hello, World!%

   • 亲和验证：在控制台函数详情页，点击实例>实例日志，可以观察到，两次请求由同一实例处理（根据X-Fc-Request-Id判断）

     第二次请求携带了第一次请求获取的cookie，同一实例的日志输出如下所示。

     2025-12-30 20:19:41
     FC Invoke Start RequestId: 1-695xxx08d1309db
     2025-12-30 20:19:41
     FC Invoke End RequestId: 1-69xxx1309db
     2025-12-30 20:19:42  * Serving Flask app 'app'
      * Debug mode: off
     WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
      * Running on all addresses (0.0.0.0)
      * Running on hxxx
      * Running on hxxx
     Press CTRL+C to quit
     Path:
     Data: b''
     21.0.0.1 - - [30/Dec/2025 12:19:41] "GET / HTTP/1.1" 200 -
     2025-12-30 20:22:18
     FC Invoke Start RequestId: 1-695xxxa15fef9d
     2025-12-30 20:22:18
     FC Invoke End RequestId: 1-695xxxa15fef9d
     2025-12-30 20:22:19 Path:
     Data: b''
     xxx - - [30/Dec/2025 12:22:18] "GET / HTTP/1.1" 200 -

4. 第三次请求：不带Cookie，系统会生成新的Cookie

   • 发起新请求curl -i https://your-function-url/

     示例：

     curl -i http://test-cookies-o********j.cn-hangzhou.fcapp.run/

   • 预期结果：系统为新的Session生成不同的Cookie值

     Access-Control-Expose-Headers: Date,x-fc-request-id
     Content-Disposition: attachment
     Content-Length: 13
     Content-Type: text/html; charset=utf-8
     Set-Cookie: x-fc-cookie-session-id=d******e-***3-4**5-a**2-3**********d; Max-Age=21600
     X-Fc-Request-Id: 1-******cb-******16-1**********a
     Date: Tue, 30 Dec 2025 12:31:00 GMT
     Hello, World!%      

   • 亲和验证：如果单实例并发Session数为2，新Session应该绑定到同一实例。在控制台函数详情页，点击实例>实例日志查看（根据X-Fc-Request-Id判断）

     实例日志验证结果（实例规格: vCPU 0.35 vCPU / 内存 512 MB，函数: test-cookies，自定义运行时 Debian10）：前两次请求使用同一个 cookie 值，第三次请求使用新 cookie 值，说明会话亲和生效。

     2025-12-30 20:26:41  * Serving Flask app 'app'
      * Debug mode: off
     WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
      * Running on all addresses (0.0.0.0)
      * Running on xxx
      * Running on xxx
     Press CTRL+C to quit
     2025-12-30 20:31:00
     FC Invoke Start RequestId: 1-6xxx60a    # 同一个cookie值
     2025-12-30 20:31:00
     FC Invoke End RequestId: 1-6xxx1760a
     2025-12-30 20:31:01 Path:
       Data: b''
       2xxx -- [30/Dec/2025 12:31:00] "GET / HTTP/1.1" 200 –
     2025-12-30 20:33:03
     FC Invoke Start RequestId: 1-6xxxe69    # 同一个cookie值
     2025-12-30 20:33:03
     FC Invoke End RequestId: 1-6xxxe69
     2025-12-30 20:33:04 Path:
       Data: b''
       2xxx -- [30/Dec/2025 12:33:03] "GET / HTTP/1.1" 200 –
     2025-12-30 20:33:48
     FC Invoke Start RequestId: 1-6xxx385d   # 新cookie值
     2025-12-30 20:33:48
     FC Invoke End RequestId: 1-6xxx385d
     2025-12-30 20:33:49 Path:
       Data: b''
       2xxx -- [30/Dec/2025 12:33:48] "GET / HTTP/1.1" 200 –

5. 发起第四次请求，不带Cookie，验证实例自动扩容

   • 不带Cookie，发起请求，生成新的Cookie值，实例Session数达到上限，新Session绑定到新创建的实例curl -i http://your-function-url/

     示例：

     curl -i http://test-cookies-o********j.cn-hangzhou.fcapp.run/

   • 预期结果：

     HTTP/1.1 200 OK
     Access-Control-Expose-Headers: Date,x-fc-request-id
     Content-Disposition: attachment
     Content-Length: 13
     Content-Type: text/html; charset=utf-8
     X-Fc-Request-Id: 1-6******c-1******2-**********5d
     Date: Tue, 30 Dec 2025 12:33:48 GMT
     Hello, World!%  

   • 亲和验证：在控制台函数详情页，点击实例，可以看到新增实例

     实例列表中显示两个状态为运行中的实例，版本均为LATEST，表明已成功创建多个实例可用于亲和验证。

常见问题