如何为Python AWS Lambda错误消息添加自定义字段

在AWS Lambda里处理异常并添加自定义字段，其实有几个实用的方法，我结合平时的实践给你拆解下：

方案1：直接给内置异常对象添加属性（快速临时方案） #

Python的Exception对象支持动态添加属性，虽然不能像字典那样用e['key']赋值，但可以用点语法直接加字段。不过要注意，Lambda默认的错误响应只会序列化errorType、errorMessage和stackTrace这三个字段，所以如果只是给异常加属性后直接抛出，这些额外字段不会出现在默认的错误输出里。更靠谱的做法是捕获异常后，手动构造符合Lambda格式的错误响应，把额外字段加进去：

import traceback

def lambda_handler(event, context):
    try:
        some_function()  # 你的业务逻辑函数
    except Exception as e:
        # 给异常添加额外属性（可选，主要用于内部日志）
        e.event_details = event.get("request_details")
        e.lambda_context = context.function_name
        
        # 构造包含额外字段的Lambda错误响应
        error_response = {
            "errorType": type(e).__name__,
            "errorMessage": str(e),
            "stackTrace": traceback.format_exc().splitlines(),
            # 这里添加自定义字段
            "additional_data": {
                "event_id": event.get("id"),
                "invoked_arn": context.invoked_function_arn,
                "error_timestamp": context.get_remaining_time_in_millis()
            }
        }
        
        # 同步调用场景：直接返回这个错误响应，调用方会拿到完整数据
        return error_response
        # 如果你需要触发Lambda的错误捕获机制（比如死信队列），可以重新抛出构造好的异常
        # raise ValueError(error_response)

方案2：自定义异常类（规范长期方案） #

如果你的项目需要频繁添加自定义错误字段，最好定义一个专属的异常类，这样代码更清晰，也方便统一管理错误格式：

import traceback

class LambdaCustomError(Exception):
    def __init__(self, message, additional_data=None):
        super().__init__(message)
        # 初始化额外字段，默认空字典
        self.additional_data = additional_data or {}

def lambda_handler(event, context):
    try:
        some_function()
    except Exception as e:
        # 将原异常包装成自定义异常，传入额外数据
        custom_error = LambdaCustomError(
            message=str(e),
            additional_data={
                "event_payload": event,
                "lambda_request_id": context.aws_request_id
            }
        )
        
        # 构造符合Lambda要求的错误响应
        error_response = {
            "errorType": type(custom_error).__name__,
            "errorMessage": custom_error.args[0],
            "stackTrace": traceback.format_exc().splitlines(),
            # 展开自定义异常的额外字段
            **custom_error.__dict__
        }
        
        return error_response

方案3：利用Lambda的错误序列化钩子（进阶） #

如果你希望让Lambda自动序列化自定义异常的额外字段，可以通过修改异常类的__reduce__方法或者使用自定义序列化器，但这种方式比较复杂，一般只在大型项目统一错误处理时使用。日常场景下，上面两种方案足够覆盖需求。

注意事项 #

• 同步调用（比如API Gateway触发）：直接返回构造好的错误字典，调用方可以直接拿到所有字段。
• 异步调用（比如SQS触发）：如果需要把额外字段写入CloudWatch Logs，建议在捕获异常时用logging模块把额外数据打出来，再抛出异常。
• 栈追踪：用traceback.format_exc().splitlines()可以把栈信息转换成Lambda默认的数组格式，保持和原生错误响应一致。

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