Gunicorn在本地Docker运行正常，部署AWS Beanstalk加载应用失败

问题根因 #

相同镜像本地运行正常、AWS Beanstalk运行报错，核心原因是Python模块搜索路径不匹配，和Gunicorn识别__init__.py无关，常见触发场景如下：

1. 未显式指定容器工作目录：如果Dockerfile中没有写WORKDIR指令，本地运行Docker时可能默认使用了镜像构建时的工作目录，而Beanstalk运行容器时默认工作目录变更，导致Gunicorn运行时找不到webapp包。
2. 代码命名错误：你贴出的目录中包文件写为__init___.py（多了一个下划线），正确的Python包标识文件应为__init__.py（前后各两个下划线），如果镜像中实际是错误命名，Python不会将webapp识别为合法包，自然无法导入内部属性。
3. 部署配置覆盖：如果使用Dockerrun.aws.json配置部署，配置中可能覆盖了容器工作目录、ENTRYPOINT指令，导致你写在Dockerfile、entrypoint.sh中的配置失效。
4. 镜像打包遗漏：本地运行时如果挂载了本地代码卷，即使镜像内代码有问题也会被本地覆盖，实际推送到Beanstalk的镜像可能漏了webapp/__init__.py文件，或者文件中没有定义server变量。

解决方案 #

1. 修正基础命名：确认webapp目录下的包文件命名为__init__.py，没有多余下划线。
2. 显式指定容器工作目录：在Dockerfile的ENTRYPOINT之前添加WORKDIR指令，明确指定项目根目录：

# 示例：假设代码全部存放在容器的/app目录下
WORKDIR /app
ENTRYPOINT ["sh","./entrypoint.sh"]

3. 在启动脚本中强制指定模块搜索路径：修改entrypoint.sh，运行Gunicorn前先把当前目录加入PYTHONPATH，也可以用Gunicorn的--chdir参数显式指定项目根目录：

#!/bin/sh
export PYTHONPATH=./:$PYTHONPATH
# 或直接用--chdir指定根目录，以下二选一即可
gunicorn -w 1 --timeout 1800 --bind :80 --chdir /app webapp:server

4. 验证镜像本身有效性：本地运行时不要挂载代码卷，直接运行推送到ECR的镜像，确认是否正常：

docker run --rm -p 80:80 <你的镜像远程地址>

如果该命令运行也报错，说明是镜像打包时的代码路径问题，重新检查Dockerfile的COPY指令是否正确把项目代码复制到了WORKDIR路径下。
5. 检查部署配置：如果使用Dockerrun.aws.json，确认配置中没有覆盖WorkingDirectory、Entrypoint字段。

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