Google App Engine弹性环境中nginx.conf位置及大文件上传报错排查

核心问题分析 #

你当前的Dockerfile仅启动了gunicorn，没有运行Nginx服务——虽然你复制了nginx.conf到/etc/nginx/nginx.conf，但Nginx根本没启动，所以你的配置完全没生效。另外，GAE弹性环境使用自定义Docker镜像时，前端是Google的负载均衡（而非自带Nginx），流量直接转发到你容器暴露的端口，不存在所谓“GAE自带Nginx配置文件”需要修改的情况。

解决步骤 #

1. 在Docker容器中安装并启动Nginx #

首先确保Dockerfile中安装了Nginx，同时用进程管理方式（比如shell脚本）同时启动Nginx和gunicorn（Docker默认只能运行单个进程）。

调整后的Dockerfile：

FROM ubuntu:bionic

# 安装Nginx及依赖
RUN apt-get -y update && apt-get -y upgrade && apt-get -y install nginx
RUN pip3 install virtualenv
RUN virtualenv -p python3.8 env
ENV VIRTUAL_ENV /env
ENV PATH /env/bin:$PATH
ADD requirements.txt /app/requirements.txt
RUN pip install -r /app/requirements.txt
ADD . /app
WORKDIR /app
# GAE弹性环境要求容器监听8080端口
ENV PORT 8080
EXPOSE 8080
# 复制自定义Nginx配置
COPY nginx.conf /etc/nginx/nginx.conf
# 添加启动脚本权限
RUN chmod +x /app/start.sh
# 用启动脚本启动服务
CMD ["/app/start.sh"]

2. 创建启动脚本（start.sh） #

在项目根目录创建start.sh，用于同时启动Nginx和gunicorn：

#!/bin/bash
# 启动Nginx服务
service nginx start
# 启动gunicorn，仅监听本地端口（避免直接暴露）
exec gunicorn --workers 2 --threads 8 -b 127.0.0.1:8000 mysite.wsgi:application

3. 修改Nginx配置文件 #

调整nginx.conf，让Nginx作为反向代理转发请求到gunicorn，并配置大文件上传限制：

events {
    worker_connections 768;
}

http {
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    access_log /var/log/app_engine/app.log;
    error_log /var/log/app_engine/app.log;

    gzip on;
    gzip_disable "msie6";

    server {
        # 监听GAE要求的8080端口
        listen 8080;
        server_name localhost;

        # 核心配置：允许最大500M的请求体
        client_max_body_size 500M;

        # 处理Django静态文件（根据你的实际静态文件路径调整）
        location /static/ {
            alias /app/static/;
            expires 30d;
        }

        # 将所有动态请求转发到gunicorn
        location / {
            proxy_pass http://127.0.0.1:8000;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

4. 验证与部署 #

• 本地测试：构建镜像后运行，检查Nginx是否正常转发请求到gunicorn，测试大文件上传是否报错。
• GAE部署：确保你的app.yaml中指定了runtime: custom（使用自定义Docker镜像的必要配置）。

补充说明 #

你之前调整的Django配置（FILE_UPLOAD_MAX_MEMORY_SIZE和DATA_UPLOAD_MAX_MEMORY_SIZE）是必要的，但仅解决Django层面的限制，Nginx的client_max_body_size是前端反向代理的限制，必须同时配置。

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