如何解决GCP Cloud Functions中的“UNKNOWN:Timer list shutdown”错误？

问题背景 #

在GCP上运行Python开发的Cloud Functions时，出现如下错误日志：

{
  "insertId": "-",
  "jsonPayload": {
    "message": " run_poller: UNKNOWN:Timer list shutdown {created_time:\"2023-03-14T16:28:27.200506461+00:00\"}",
    "pid": "75"
  },
  "labels": {
    "compute.googleapis.com/resource_name": "-",
    "k8s-pod/controller-uid": "-",
    "k8s-pod/job-name": "-"
  },
  "logName": "-",
  "receiveTimestamp": "2023-03-14T16:28:32.194472183Z",
  "resource": {
    "labels": {6},
    "type": "k8s_container"
  },
  "severity": "ERROR",
  "sourceLocation": {
    "file": "backup_poller.cc",
    "line": "122"
  },
  "timestamp": "2023-03-14T16:28:27.213678702Z"
}

错误原因判断 #

该错误并非GKE资源不足导致。它来自Cloud Functions底层运行时的backup_poller.cc组件，属于内部定时器列表关闭时的异常日志，是运行时在清理资源过程中触发的偶发性错误，和用户代码逻辑、GKE集群CPU/内存配额无直接关联。

定位问题的具体步骤 #

• 查看Cloud Functions的完整执行日志，确认错误发生时的函数触发类型（HTTP、Pub/Sub等），排查是否存在触发频率过高、函数执行超时的情况
• 检查函数的资源配置（内存、CPU配额），确认是否有函数因资源耗尽被强制终止，间接引发底层运行时的定时器清理异常
• 确认GCP Cloud Functions服务状态，排查当时是否存在平台侧的维护或故障

解决建议 #

• 偶发错误直接重试：如果仅出现一次该错误，直接重试对应的函数触发请求即可，此类底层运行时异常通常不会重复出现
• 优化函数执行逻辑：若错误频繁发生，检查函数中是否存在长时间运行的异步任务，或第三方异步库是否存在资源未正确释放的情况
• 调整函数资源配置：适当提高函数的内存配额（例如从256MB调整至512MB），避免因资源限制导致运行时提前终止，引发此类清理异常
• 联系GCP技术支持：若错误持续无法解决，收集完整的日志信息（包括完整的logName和resource标签内容），提交GCP支持工单排查底层运行时问题

内容的提问来源于stack exchange，提问作者esaeki