首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >云函数下次调用可能不是新实例:全局状态、/tmp 与冷启动

云函数下次调用可能不是新实例:全局状态、/tmp 与冷启动

原创
作者头像
一只特立独行的兔先生
发布于 2026-11-22 09:19:19
发布于 2026-11-22 09:19:19
100
举报

上一次调用已经返回,紧接着再调一次,第二次可能没有初始化日志,模块里的计数还是上次留下的。隔几分钟的定时任务则相反:调用稀疏时往往等不到这份复用,下一次仍要冷启动。云函数 SCF 隔离的是实例,不是一次调用。

复用是优化,不是契约

没有可复用的实例时,请求才触发启动。启动分三段:拉代码、层或镜像,准备运行时,执行入口函数之前的代码。耗时记在 PullCode、InitRuntime、InitFunction,之和是 Coldstart。初始化超时只在冷启动时生效:代码部署默认 60 秒,镜像部署默认 90 秒,可选 3–300 秒。执行超时默认 3 秒,范围 1–900 秒,管的是初始化结束之后的执行。

请求返回后实例不立刻销毁。处理完会保留一段时间,期内的新请求优先用它;保留多久由平台动态调整,不能写死秒数。低并发不再设保留期,改为智能回收,文档没给阈值。定时触发这种稀疏调用,最容易误判成刚跑过、实例还热着。

保留期结束且没有新请求,实例被回收。433 TimeLimitReached、434 MemoryLimitReached、439 用户进程意外退出也会回收实例,内存和本地盘随之消失。

默认一个实例同一时刻只处理一个请求。前一个还没返回,新请求进不了它;复用只发生在实例已空闲且还在保留期内。文档中的估算是每秒请求量乘以执行秒数:0.2 秒、每秒 300 次,大约 60 个实例。弹性扩容默认每地域 500 个/分钟,超速是 429 ResourceLimit;配额打满是 432 ResourceLimitReached。

冷启动只看 Init Report

Init Report 和初始化阶段的用户输出只在冷启动出现,复用时没有。下面是文档中的形态,毫秒数是示例,不是实测:

代码语言:plaintext
复制
Init Report RequestId: 09c346d3-8417-49c5-8569-xxxxxxxxxxxx Coldstart: 236ms (PullCode: 70ms InitRuntime: 8ms InitFunction: 158ms) Memory: 640MB MemUsage: 57.86MB

PullCode 大,先减代码包、层和镜像。InitFunction 大,说明建连和预热堆在了模块顶层,每次冷启动都要再付一遍。预置实例的启动日志是 Provisioned Report,打在预置过程,不挂在后来的业务请求上。在函数日志里搜 Init Report 或 Coldstart,它们是平台日志,SCF_Type 为 Platform。每次请求末尾的 Report 记本次 Duration 和 MemUsage,复用时也有,不能拿它判断冷启动。

全局变量和 /tmp 都只活在这个实例上

事件函数启动时会跑入口函数之前的全部代码。Web 函数跑的是 scf_bootstrap,以及开始监听 9000 端口之前的逻辑。复用时这些代码不重跑,对象还在;入口函数里的局部变量每次都是新的。

/tmp 要两句一起看。工作原理写:容器还在时目录内容会保留,下次有可能直接用到;同一页又写,数据可能不会在执行完成后保留。存储选型表把调用间共享标成否。它不是 COS、CFS 那种共享存储,实例没回收时也不是空目录。另一个实例看不到这一份文件。根文件系统只读,本地可写的是 /tmp。

免费额度 512 MB。存储选型文档允许按内存加大,步长 0.5 GB,最高 10 GB,再高要开白;超出部分按临时存储配额计费,价格以计费文档为准。工作原理页仍写成 512 MB,配额以存储选型文档和控制台为准。预置实例不会被主动回收,临时文件不删会一直堆,直到写满或实例因内存超限被换掉。

放在哪

同实例下次调用

其他实例

回收或 433/434/439 之后

入口函数内的局部变量

没有

没有

没有

模块级变量

还在

没有

没有

/tmp

实例还在就可能还在

没有

没有

COS、CFS、外部 Redis

看得到

看得到

看得到

跨实例要共享,用最后一行。前三行做不了锁,也做不了去重。

下面的事件函数只用标准库。执行方法填 index.main_handler(文件名为 index.py)。

代码语言:python
复制
# -*- coding: utf8 -*-
import os

COUNTER = 0
TMP_PATH = "/tmp/reuse-counter"

def main_handler(event, context):
    global COUNTER
    COUNTER += 1
    disk = 0
    if os.path.exists(TMP_PATH):
        with open(TMP_PATH, encoding="utf-8") as f:
            text = f.read().strip()
            disk = int(text) if text else 0
    disk += 1
    with open(TMP_PATH, "w", encoding="utf-8") as f:
        f.write(str(disk))
    request_id = context["request_id"] if isinstance(context, dict) else getattr(context, "request_id", "")
    return {"request_id": request_id, "memory_counter": COUNTER, "tmp_counter": disk}

间隔几秒、不要并发,打两次。第二次两个计数都大于 1,且没有 Init Report,就是复用。两次都是 1 且各自有 Init Report,就是没复用:超过保留期、函数刚更新,或落在智能回收上。请求叠在一起时计数接不上,说明进了多个实例。单并发下,全局变量串的是中间有空档的先后请求,串不到同时在飞的请求。更新函数后通常会重新启动,新实例看不到更新前的内存和 /tmp。

连接可以复用,但不能假定还活着

连接放在入口函数外,能省掉冷启动时的握手,不保证连接还活着。实例可以留很久,数据库空闲超时、负载均衡空闲断开、NAT 连接跟踪都可能先拆掉这条 TCP。断了要到执行 SQL 才暴露。433、434、439 回收实例后,重试进来时连接根本不存在。

借出前 ping,失败就关掉再建。pymysql 要打进部署包或层。10.0.0.12 是示例地址,部署前改成实际内网地址,口令走环境变量。read_timeout 设 2 秒,小于默认 3 秒的执行超时,避免下游卡住时实例先被 433 回收。

代码语言:python
复制
# -*- coding: utf8 -*-
import os
import pymysql

_conn = None

def get_conn():
    global _conn
    if _conn is not None:
        try:
            _conn.ping(reconnect=False)
            return _conn
        except (pymysql.err.Error, OSError):
            try:
                _conn.close()
            except (pymysql.err.Error, OSError):
                pass
            _conn = None
    _conn = pymysql.connect(
        host="10.0.0.12",
        port=int(os.environ.get("DB_PORT", "3306")),
        user=os.environ["DB_USER"],
        password=os.environ["DB_PASSWORD"],
        database=os.environ["DB_NAME"],
        connect_timeout=2,
        read_timeout=2,
        write_timeout=2,
        autocommit=True,
    )
    return _conn

ping 只说明连接还能对话,不说明临时表、会话变量、未提交事务还在。这些限制在一次调用内。autocommit 打开,避免失败语句把事务挂在复用连接上。模块级缓存会随复用一直涨,看末尾 Report 的 MemUsage 是否往配置内存靠;这是趋势,不是阈值。要跨实例一致,放到 Redis。

请求多并发打破实例内的单请求假设

事件函数没有这个开关,仍是同时只跑一个请求,但跑完可以接下一个,所以上一节的问题一样存在。Web 函数的自定义静态并发范围是 2~100,多个请求进同一个实例;自定义动态并发只给 GPU。多数场景应维持单并发,免得在函数里处理线程安全。

打开后,重叠的执行时间只算一次。这些请求共享内存、/tmp 和全局连接,pymysql 的连接不能并发拿去查。CPU 实例内存超限会重启,进行中的请求一起收到 434;执行超时只终止那一个,返回 433。多请求同时写标准输出时,平台上的 SCF_RequestId 可能对不上一行用户日志,要从请求头取 X-Scf-Request-Id(有的框架是 x-scf-request-id),业务日志自己带上。

Web 函数启动文件必须叫 scf_bootstrap,权限 755,LF 换行,监听 0.0.0.0:9000,不能听 127.0.0.1。解释器走绝对路径,以启动文件说明的路径表为准,不要套同页模板里的 /var/lang/python3/bin/python3。Python 3.9 如下,app.py 换成自己的入口;PORT 不会替进程完成监听。

代码语言:bash
复制
#!/bin/bash
export PORT=9000
/var/lang/python39/bin/python3.9 app.py

预置并发盖不住配额外的冷启动

预置并发只能配在已发布版本上,不能配在 $LATEST。平台会预先拉起实例,并且不主动回收,用来去掉配额内的冷启动。它不提高并发上限。平均 100 并发、预置 80 个时,这 80 个不用再初始化,多出来的第一次调用仍要冷启动;超过独占配额是 432,和冷启动无关。

预置实例也会因进程退出或内存超限被换掉,替换完成前数量会短暂小于配置值。启动速度默认约 100 个/分钟,不占弹性扩容那 500 个/分钟。切流前先看监控里预置是否到位。没到位就切,切过去的仍是冷启动;旧版本的请求也不会打到新版本预热好的实例上。

调用方等待要稍大于初始化超时与执行超时之和。执行超时默认 3 秒,调用方若也只等 3 秒,冷启动会在 InitFunction 结束前被掐断。Web 函数走 API 网关触发器时,网关超时小于这两项之和,返回 499 RequestCanceled。网关默认超时以网关文档为准。异步重试的下一次也不保证回到刚才的实例;重试次数和超限保留时间是另一套规则,这里不展开。

上线前对一下

  • 入口函数外只放可重建的对象。用户数据、计数器、未提交事务不放这里。
  • /tmp 写入前检查,用完删除。不拿它做跨实例共享,也不假设它是空的。
  • 借出全局连接先 ping,失败就关闭并新建。会话状态限制在一次调用内。
  • 没有压测就维持单并发。开了多并发,每行日志带上本次 RequestId。
  • 冷启动只看 Init Report,不看末尾的 Report。
  • 预置只配已发布版本,数量按峰值。切流前确认预置到位。
  • 调用方超时大于初始化超时加执行超时。默认执行超时 3 秒,不等于调用方只等 3 秒。
  • 低并发、函数更新、433/434/439 之后,都按下一次是新实例来写。

工作原理:https://cloud.tencent.com/document/product/583/9694

并发概述:https://cloud.tencent.com/document/product/583/45757

日志结构说明:https://cloud.tencent.com/document/product/583/60336

函数概述:https://cloud.tencent.com/document/product/583/19805

预置并发:https://cloud.tencent.com/document/product/583/46743

云函数状态码:https://cloud.tencent.com/document/product/583/42611

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 复用是优化,不是契约
  • 冷启动只看 Init Report
  • 全局变量和 /tmp 都只活在这个实例上
  • 连接可以复用,但不能假定还活着
  • 请求多并发打破实例内的单请求假设
  • 预置并发盖不住配额外的冷启动
  • 上线前对一下
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档