通过Jenkins+Elastic Beanstalk部署Django到AWS失败求助

核心诱因 #

从Amazon Linux 2切换到Amazon Linux 2023（AL2023）后，平台的包管理工具、系统权限、默认软件版本都有重大变化，这是你部署失败的核心原因。

具体排查步骤 #

1. 修正包管理相关配置 #

• AL2023确实移除了amazon-linux-extras，默认用dnf替代yum作为包管理器。如果你的.ebextensions配置或构建脚本里还有yum、amazon-linux-extras相关命令，必须全部替换为dnf语法。
  示例：AL2的amazon-linux-extras install python3.8要改成AL2023的dnf install python3.11（AL2023默认Python版本为3.11，注意和你的Django版本兼容）。

2. 对齐Elastic Beanstalk配置规范 #

• AL2023对.ebextensions配置的语法和权限要求更严格：
  • 确认config.yml里的平台版本指定准确，比如platform: "Python 3.11 running on 64bit Amazon Linux 2023"；
  • container_commands的执行用户默认是webapp（AL2用的是ec2-user），所有涉及文件操作的命令要确保权限正确；
  • 即使清空了旧配置，也要检查是否有残留的无效配置片段（比如注释里的旧命令）干扰部署。

3. 精准定位日志中的错误 #

• 不要只看表面日志，重点查看这几个关键文件：
  • /var/log/eb-engine.log：记录Elastic Beanstalk部署引擎的执行细节，包括配置脚本的执行失败信息；
  • /var/log/httpd/error_log：Web服务器启动或应用运行时的错误；
  • /var/log/django.log（如果配置了）：Django自身的启动报错；
• 在EB控制台的「日志」选项卡下载完整日志包，用文本搜索工具查找ERROR、Failed、Permission denied等关键词。

4. 验证Python环境与依赖兼容性 #

• AL2023默认Python 3.11，而你生产环境（AL2）可能用的是3.8/3.9版本，检查requirements.txt中的依赖是否支持Python 3.11：
  • 比如旧版Django（<4.0）对Python 3.11兼容性不佳；
  • 本地用Python 3.11创建虚拟环境，安装依赖并运行python manage.py check，提前排查兼容性问题。

5. 排除Jenkins因素 #

• 跳过Jenkins，直接在本地用eb deploy部署到AL2023环境：
  • 如果手动部署失败，说明问题在代码/EB配置，和Jenkins无关；
  • 如果手动部署成功，检查Jenkins构建脚本：是否遗漏了.ebextensions目录、是否在构建时修改了依赖版本、是否打包了多余文件。

6. 检查SELinux与文件权限 #

• AL2023默认启用SELinux，而AL2默认关闭。如果应用需要读写目录（比如静态文件、媒体目录），可以临时执行setenforce 0测试是否是SELinux导致的问题；
• 确保应用文件所有者为webapp，可在.ebextensions中添加命令：container_commands: { fix_perms: command: "chown -R webapp:webapp /var/app/current" }。

澄清概念 #

教程中「Ubuntu作为EC2实例OS，搭配Amazon Linux 2023作为平台」的描述有误：Elastic Beanstalk平台的底层EC2实例OS由AWS管理，你只需指定EB平台版本（比如Python 3.11 on AL2023），无需手动选择EC2的OS，两者不要混用。

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