Zappa部署Flask应用跳转无环境名URI返回Forbidden错误如何解决

问题原因 #

该报错是Zappa部署的API Gateway阶段前缀规则导致的：Zappa部署到AWS时会自动为部署环境（如dev、prod）添加对应环境名作为URI前缀，你代码中硬编码redirect("/")会直接跳转至站点根路径，缺少/dev前缀，API Gateway无法匹配到对应资源就会返回Forbidden错误。

解决方案 #

方案1：使用Flask url_for生成跳转路径（优先推荐） #

Flask的url_for方法会自动适配部署环境的路径前缀，无需手动处理环境名，仅需修改redirect逻辑即可：

# 导入所需方法
from flask import url_for, redirect

@app.route("/upload", methods=['GET','POST'])
def upload():
    if request.method == "POST":
        f = request.files['file']
        f.save(os.path.join(UPLOAD_FOLDER, secure_filename(f.filename)))
        upload_file(f"uploads/{f.filename}", BUCKET)
        # 替换硬编码路径，通过视图函数名生成跳转地址
        return redirect(url_for('home'))

方案2：绑定自定义域名移除阶段前缀 #

如果不需要多环境区分，可以在zappa_settings.json配置文件中添加自定义域名配置，绑定后访问路径就不会带/dev前缀：

{
  "dev": {
    // 其他原有配置不变
    "domain": "你的自定义域名",
    "certificate_arn": "你的AWS证书ARN",
    "append_server_name": true
  }
}

配置完成后执行zappa certify部署证书，原有硬编码的跳转路径即可正常运行。

方案3：手动配置Flask应用根路径 #

如果不想修改现有跳转逻辑，可以在Flask初始化时配置全局应用根路径，适配Zappa的环境前缀：

import os
from flask import Flask

app = Flask(__name__)
# 从Zappa注入的STAGE环境变量自动获取部署阶段，设置根路径
app.config['APPLICATION_ROOT'] = f"/{os.environ.get('STAGE', 'dev')}"

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