如何在基于容器镜像的AWS Lambda Python函数中正确配置日志？

我来帮你分析下当前遇到的问题，然后一步步解决日志不输出的问题：

首先，你的代码里已经创建了日志文件，但返回的内容是空的，说明文件确实被创建了，但没有日志内容写入。结合Lambda的运行环境和Python logging的特性，主要有几个可能的原因，我们逐个解决：

一、先确认你是否实际触发了日志输出 #

如果只是配置了logger，但在其他模块里没有调用logger.info()、logger.error()这类日志方法，那日志文件自然是空的。你可以先在main.py里导入logger并添加测试日志，验证是否能写入：

import os
from logging_config import logger  # 确保导入自定义logger

def lambda_handler(event, context):
    # 先添加测试日志，确认日志能生成
    logger.info("Lambda函数启动了！")
    logger.error("这是一条测试错误日志")
    
    log_file = "/tmp/application.log"
    
    if os.path.exists(log_file):
        with open(log_file, "r") as f:
            file = f.read()
    else:
        file = "File does not exist"
    return {
        "statusCode": 200,
        "body": file
    }

二、修改日志配置，避免依赖basicConfig的坑 #

你当前用logging.basicConfig()配置日志，但这个方法只对root logger生效，而你创建的"my-logger"是子logger。如果Lambda的Python环境已经提前配置过root logger（比如Lambda默认的日志系统），basicConfig就不会生效，导致你的handler没被正确添加。

建议直接给自定义logger手动添加handler，这样更可靠，修改logging_config.py如下：

import logging

LOG_FILE = "/tmp/application.log"

# 创建自定义logger
logger = logging.getLogger("my-logger")
logger.setLevel(logging.INFO)

# 避免重复添加handler（如果多次导入该模块）
if not logger.handlers:
    # 配置文件handler，设置flush=True确保日志立即写入磁盘
    file_handler = logging.FileHandler(LOG_FILE, mode='a', flush=True)
    file_formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
    file_handler.setFormatter(file_formatter)
    
    # 配置控制台handler，输出到stdout（Lambda会将stdout收集到CloudWatch Logs）
    stream_handler = logging.StreamHandler()
    stream_formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
    stream_handler.setFormatter(stream_formatter)
    
    # 将handler添加到自定义logger
    logger.addHandler(file_handler)
    logger.addHandler(stream_handler)

这里的关键改进点：

• 直接给my-logger添加handler，不依赖root logger的配置
• 加入if not logger.handlers判断，防止多次导入模块时重复添加handler导致日志重复输出
• 给FileHandler设置flush=True，解决Lambda函数结束前日志未写入磁盘的缓冲问题

三、检查容器镜像的配置是否正确 #

确保你的Dockerfile正确设置了Lambda的入口点，比如：

# 使用Lambda官方Python镜像
FROM public.ecr.aws/lambda/python:3.11

# 安装依赖（如果有的话）
COPY requirements.txt .
RUN pip install -r requirements.txt

# 复制代码到Lambda任务目录
COPY main.py logging_config.py ${LAMBDA_TASK_ROOT}/

# 设置Lambda函数入口
CMD ["main.lambda_handler"]

四、查看CloudWatch Logs验证控制台日志 #

Lambda会自动把stdout和stderr的内容收集到CloudWatch Logs中，对应的日志组是/aws/lambda/<你的函数名>。修改配置后，你不仅能在/tmp/application.log里看到日志，也能在CloudWatch的这个日志组里看到StreamHandler输出的内容。

为什么原来的配置不生效？ #

1. basicConfig只在root logger没有任何handler时才会生效，Lambda的默认日志系统可能已经提前配置了root logger，导致你的配置被忽略
2. FileHandler默认有缓冲，Lambda函数执行结束时可能还没把缓冲的日志写入磁盘，导致文件为空
3. 如果没有实际调用日志方法，自然不会生成任何日志内容

备注：内容来源于stack exchange，提问作者Victor Baranga