Zappa部署AWS Lambda Django应用：如何指定Python导入优先级？

针对你遇到的Zappa部署Django时的包优先级冲突问题，我整理了几个实用的解决方案，都是实际项目中验证过的：

方案1：在代码中动态调整sys.path（最灵活） #

Python的模块搜索顺序由sys.path决定，我们可以在Lambda环境下把预编译包目录插入到sys.path的最前面，同时让本地运行时不生效。

在Django项目的wsgi.py或者settings.py的最顶部添加这段代码：

import sys
import os
from pathlib import Path

# 判断当前是否处于AWS Lambda环境（Lambda会自动设置这个环境变量）
if os.environ.get("AWS_EXECUTION_ENV"):
    # 替换成你的预编译包实际存放路径，这里假设是项目根目录下的prebuilt_wheels
    prebuilt_package_dir = Path(__file__).parent.parent / "prebuilt_wheels"
    # 插入到sys.path的第一个位置，确保优先搜索
    sys.path.insert(0, str(prebuilt_package_dir))

本地运行时因为没有AWS_EXECUTION_ENV环境变量，会直接使用Pipenv安装的包；而Lambda环境下会优先加载预编译目录里的包，完美区分两种场景。

方案2：让Zappa排除Pipenv安装的目标包（最干净） #

既然Lambda只需要预编译版本，那直接不让Zappa把Pipenv安装的那个包打包进去就行，从根源上避免版本冲突。修改zappa_settings.json：

{
    "your_stage_name": {
        // 其他原有配置...
        "exclude": [
            "*.pyc",
            "__pycache__",
            "cryptography"  // 把你要替换的包名加在这里
        ],
        "include": [
            "prebuilt_wheels/**"  // 确保预编译目录被打包到Lambda
        ]
    }
}

这样Zappa打包时会跳过Pipenv安装的目标包，Lambda环境里就只有预编译版本的包，自然会优先导入它。

方案3：通过Lambda环境变量强制修改PYTHONPATH #

在zappa_settings.json里设置Lambda的环境变量，把预编译包目录放到PYTHONPATH的最前端：

{
    "your_stage_name": {
        // 其他原有配置...
        "environment_variables": {
            "PYTHONPATH": "/var/task/prebuilt_wheels:/var/task"
        },
        "include": [
            "prebuilt_wheels/**"
        ]
    }
}

Lambda中项目的根目录是/var/task，把预编译目录放在PYTHONPATH的第一个位置，Python会优先搜索这个目录下的包，覆盖默认的导入顺序。

额外注意事项 #

• 确保预编译包的版本和Pipfile中声明的版本完全一致，避免版本兼容问题；
• 预编译包必须和Lambda的运行环境匹配：比如Lambda用Python 3.9+的话，要对应Amazon Linux 2的架构（x86_64或arm64）编译；
• 测试时可以在本地手动设置AWS_EXECUTION_ENV环境变量，验证Lambda环境下的导入逻辑是否正常。

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