如何防止Python Google Functions日志被拆分为多行

升级到Python 3.11后，Google Cloud Functions默认日志处理器会将每行输出识别为单独日志条目，导致Traceback被拆分，可通过以下几种方式解决：

方法1：使用结构化日志统一输出 #

利用Google Cloud Logging的JSON格式支持，将多行Traceback封装为单个日志条目：

1. 安装依赖库（若未安装）：

pip install google-cloud-logging

2. 配置结构化日志处理器：

import logging
from google.cloud.logging_v2.handlers import CloudLoggingHandler
from google.cloud.logging_v2.formatters import StructuredFormatter

def setup_logging():
    logger = logging.getLogger()
    logger.setLevel(logging.INFO)
    
    # 移除默认日志处理器
    for handler in logger.handlers[:]:
        logger.removeHandler(handler)
    
    # 添加结构化日志处理器
    handler = CloudLoggingHandler()
    handler.setFormatter(StructuredFormatter())
    logger.addHandler(handler)

# 在函数启动时初始化日志
setup_logging()

def your_function(request):
    try:
        # 业务逻辑代码
        raise ValueError("测试异常")
    except Exception:
        logging.exception("函数执行失败")
        return "Error", 500

此方式会将完整Traceback封装到JSON日志的message字段中，在Cloud Logging中显示为单个条目。

方法2：自定义日志格式化器合并多行 #

通过自定义格式化器处理Traceback的换行，让日志处理器识别为单条内容：

import logging
import traceback

class MultilineFormatter(logging.Formatter):
    def formatException(self, exc_info):
        # 获取完整Traceback字符串并转义换行符
        return ''.join(traceback.format_exception(*exc_info)).replace('\n', '\\n')

def setup_logging():
    logger = logging.getLogger()
    logger.setLevel(logging.INFO)
    
    # 替换默认格式化器
    for handler in logger.handlers:
        handler.setFormatter(MultilineFormatter('%(asctime)s - %(levelname)s - %(message)s'))

setup_logging()

def your_function(request):
    try:
        raise ValueError("测试异常")
    except Exception:
        logging.exception("函数执行失败")
        return "Error", 500

方法3：手动捕获并输出完整Traceback #

无需修改全局日志配置，捕获异常时直接拼接完整Traceback输出：

import logging
import traceback

def your_function(request):
    try:
        # 业务逻辑代码
        raise ValueError("测试异常")
    except Exception:
        tb_str = traceback.format_exc()
        logging.error(f"函数执行出错:\n{tb_str}")
        return "Error", 500

内容的提问来源于stack exchange，提问作者M.wol