AWS Lambda中logging无法输出日志但print可用问题排查

Logging模块无法输出到CloudWatch的原因及解决方法 #

Lambda的logging模块默认配置并非直接对接CloudWatch，和“不能操作文件”完全无关——Lambda运行环境会自动捕获stdout/stderr的输出并转发到CloudWatch Logs，print能正常显示就是因为它直接输出到stdout。

你遇到的问题大概率是logging的默认级别过高（默认是WARNING），或者没有配置正确的Handler。只要把logging的输出导向stdout，就能被Lambda收集到CloudWatch，不需要手动写文件。

正确配置logging的示例代码 #

import logging

# 初始化logger，避免重复添加Handler
logger = logging.getLogger()
if logger.handlers:
    for handler in logger.handlers:
        logger.removeHandler(handler)
logger.setLevel(logging.DEBUG)  # 设置日志级别，按需调整为INFO/WARNING等
handler = logging.StreamHandler()  # 输出到stdout
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)

def lambda_handler(event, context):
    logger.debug("DEBUG级日志，会被输出到CloudWatch")
    logger.info("INFO级日志")
    logger.warning("WARNING级日志")
    print("print语句输出")
    return {"statusCode": 200}

你的AWSLambdaBasicExecutionRole权限已经足够，这个角色包含了创建日志组、日志流以及写入日志的权限，只要logging配置正确，日志就能正常出现在CloudWatch。

Lambda单元测试配置方法 #

单元测试核心是在本地模拟Lambda的event和context参数，无需部署到AWS即可验证逻辑。

1. 代码结构拆分 #

把业务逻辑和Lambda入口解耦，方便单独测试：

├── lambda_function.py  # Lambda入口，处理event/context
├── business_logic.py   # 核心业务逻辑
└── test_lambda.py      # 测试用例

示例：
business_logic.py：

def process_input(input_str):
    return input_str.strip().upper()

lambda_function.py：

import logging
from business_logic import process_input

# 这里用上面的logging配置
logger = logging.getLogger()
# ...（省略logging初始化代码）

def lambda_handler(event, context):
    input_data = event.get("input", "")
    result = process_input(input_data)
    logger.info(f"处理结果：{result}")
    return {"result": result}

2. 编写测试用例 #

用pytest框架编写测试，模拟event和context：
test_lambda.py：

from lambda_function import lambda_handler

def test_lambda_normal_case():
    # 模拟event参数
    test_event = {"input": "  hello lambda  "}
    # 模拟context参数，只实现需要用到的属性
    class MockContext:
        function_name = "test-function"
        aws_request_id = "test-123"
    
    # 执行Lambda函数
    response = lambda_handler(test_event, MockContext())
    
    # 断言结果
    assert response["result"] == "HELLO LAMBDA"

3. 处理AWS服务依赖 #

如果你的Lambda用到了S3、DynamoDB等AWS服务，用moto库Mock这些服务，避免调用真实资源：

import boto3
from moto import mock_s3
from business_logic import read_s3_file

@mock_s3
def test_read_s3_file():
    # 创建Mock的S3桶和文件
    s3 = boto3.client("s3", region_name="us-east-1")
    s3.create_bucket(Bucket="test-bucket")
    s3.put_object(Bucket="test-bucket", Key="test.txt", Body="mock content")
    
    # 测试业务逻辑
    content = read_s3_file("test-bucket", "test.txt")
    assert content == "mock content"

4. 运行测试 #

安装依赖：

pip install pytest moto boto3

执行测试：

pytest test_lambda.py -v

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