使用Zappa打包Django部署AWS Lambda返回null问题求助

检查Lambda执行角色权限 #

• 确保Lambda执行角色具备必要权限：
  • S3读取权限（若静态文件存放在S3）
  • CloudWatch日志写入权限（用于排查问题）
  • 数据库访问权限（如果项目用到RDS等数据库服务）
• 可直接复用Zappa自动创建的角色（通常命名为zappa-{project}-{stage}-ZappaExecutionRole），或手动添加对应权限策略。

配置关键环境变量 #

Zappa自动部署时会设置核心环境变量，手动上传包需手动添加：

• STAGE: 对应zappa_settings.json中的环境名（如dev）
• DJANGO_SETTINGS_MODULE: Django配置文件路径（如zappa1sample.settings）
• ZAPPA_SETTINGS: 将zappa_settings.json中对应环境的配置转为JSON字符串填入，或确保zip包内的zappa_settings.json路径正确

验证部署包完整性与路径 #

• 解压生成的zip包，确认：
  • handler.py在根目录，且lambda_handler函数正确导出
  • 所有依赖（Django、Zappa等）已完整打包，无缺失
  • Django项目目录结构正确（如zappa1sample目录在根目录下）

检查API Gateway集成配置（若使用） #

• 若通过API Gateway触发Lambda，需确认：
  • 已启用Lambda Proxy integration（Zappa默认使用代理集成）
  • 未修改默认的响应映射模板（默认会将Lambda返回的JSON转换为HTTP响应）
  • API Gateway已部署到对应阶段，且端点URL正确

增加调试日志排查 #

• 在Django的settings.py中开启DEBUG模式（仅测试环境），或在handler.py中添加调试代码：

import logging
logger = logging.getLogger()
logger.setLevel(logging.DEBUG)

def lambda_handler(event, context):
    logger.debug("Lambda handler已触发")
    logger.debug(f"请求事件: {event}")
    # 原handler逻辑...

• 查看CloudWatch日志，确认请求是否传递到Django，是否存在导入错误、数据库连接失败等报错

本地测试Lambda函数 #

• 使用AWS CLI模拟API Gateway请求，测试Lambda执行结果：

aws lambda invoke --function-name 你的函数名 --payload '{"httpMethod": "GET", "path": "/"}' output.json

• 查看output.json内容，确认Lambda返回结果是否正常，是否包含错误信息

内容的提问来源于stack exchange，提问作者David Foie Gras