Google Cloud App Engine部署Flask应用遇Nginx 502错误求助

问题背景 #

Flask图片上传处理服务在本地及Google Cloud Cloud Editor中运行正常，已配置app.yaml和requirements.txt并解决依赖版本问题，部署到GAE成功，但访问应用URL时出现Nginx 502 Bad Gateway错误，本地修改后重新部署调试耗时过长，需快速定位解决。

应用核心配置 #

main.py核心代码 #

import os
import cv2
from werkzeug.utils import secure_filename
from flask import Flask,flash,request,redirect,send_file,render_template,send_from_directory
from PIL import Image, ImageDraw, ImageFont
import datetime
UPLOAD_FOLDER = 'uploads/'

app = Flask(__name__)
app.template_folder = 'templates'
app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER

# Upload API
@app.route('/', methods=['GET', 'POST'])
def upload_file():
    if request.method == 'POST':
        if 'file' not in request.files:
            print('no file')
            return redirect(request.url)
        file = request.files['file']
        if file.filename == '':
            print('no filename')
            return redirect(request.url)
        else:
            os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
            filename = secure_filename(file.filename)
            file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename))
            print("saved file successfully")
            return redirect('/process-file/'+ filename)
    return render_template('upload_file.html')

# Download API
@app.route("/downloadfile/<filename>", methods = ['GET'])
def download_file(filename):
    return render_template('download.html',value = filename)
@app.route('/return-files/<filename>')
def return_files_tut(filename):
    file_path = 'processed/' + filename
    return send_file(file_path, as_attachment=True)

if __name__ == "__main__":
    app.run(debug=False)

requirements.txt #

Flask==2.0.2
gunicorn==20.1.0
Jinja2==3.0.2
opencv-python==4.6.0.66
Pillow==8.3.0
python-dotenv==0.20.0
Werkzeug==2.0.2

app.yaml #

runtime: python311

解决方案步骤 #

1. 配置GAE启动入口 #

GAE Python运行时需要明确指定启动命令，修改app.yaml添加entrypoint，确保gunicorn绑定正确的端口和WSGI应用：

runtime: python311
entrypoint: gunicorn -b :$PORT main:app

• $PORT是GAE提供的环境变量，必须使用该端口而非硬编码
• main:app指向你的Flask应用实例（main.py中的app对象）

2. 修复文件系统路径问题 #

GAE运行环境中，除/tmp目录外其余文件系统为只读状态，原代码中uploads/和processed/目录无法写入，会导致文件保存失败引发502错误。修改main.py中的路径配置：

UPLOAD_FOLDER = '/tmp/uploads/'
PROCESSED_FOLDER = '/tmp/processed/'

app = Flask(__name__)
app.template_folder = 'templates'
app.config['UPLOAD_FOLDER'] = UPLOAD_FOLDER

同时确保处理文件时使用PROCESSED_FOLDER路径，并且创建目录的逻辑保持不变。

3. 兼容Python3.11的依赖版本 #

原requirements.txt中部分依赖版本（如Flask2.0.2、Jinja23.0.2）不兼容Python3.11，升级到兼容版本：

Flask>=2.2.0
gunicorn==20.1.0
Jinja2>=3.1.0
opencv-python==4.6.0.66
Pillow==8.3.0
python-dotenv==0.20.0
Werkzeug>=2.2.0

4. 查看GAE实时日志定位具体错误 #

通过命令行查看应用实时日志，获取502错误的具体原因：

gcloud app logs tail -s default

日志中会显示如模块导入失败、权限错误、路径不存在等具体异常，帮助精准排查。

5. 补全缺失的路由逻辑 #

原代码中上传成功后重定向到/process-file/路径，但未定义该路由，会引发404错误进而导致请求异常，需补充该路由的实现逻辑，确保请求链路完整。

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