Flask中url_for生成Cloud Run服务URL而非自定义域名的问题解决

核心问题解析 #

你设置SERVER_NAME后出现404，是因为Flask会强制校验请求的Host头必须与SERVER_NAME完全匹配，而Firebase Hosting转发请求时的头部处理逻辑导致这个校验失败。另外，Cloud Run的负载均衡会修改请求头，默认情况下Flask无法识别自定义域名，所以生成的URL会用Cloud Run的服务域名。

推荐修复方案：配置Flask信任代理并获取正确的转发头 #

Cloud Run会在转发请求时带上X-Forwarded-Host（自定义域名）、X-Forwarded-Proto（HTTPS）等头部，只需让Flask信任这些代理头部，就能生成正确的URL：

from flask import Flask

app = Flask(__name__)

# 启用转发头支持
app.config['USE_X_FORWARDED_HOST'] = True
app.config['USE_X_FORWARDED_PORT'] = True
app.config['PREFERRED_URL_SCHEME'] = 'https'

# Flask 2.3+ 版本需要配置信任的代理（生产环境建议指定Cloud Run的代理IP段，而非通配符）
app.config['TRUSTED_PROXIES'] = ['*']

配置完成后，url_for会自动从X-Forwarded-Host获取自定义域名，生成的重定向URL就会是my-app-name.web.app/auth/login，符合预期。

为什么设置SERVER_NAME会失败？ #

SERVER_NAME的设计目的是绑定固定的主机名，Flask会要求所有请求的Host头必须与该值一致，否则返回404。而Firebase Hosting转发到Cloud Run的请求，其Host头可能是Cloud Run的服务域名，而非你的自定义域名，因此触发了Flask的路由校验，导致所有请求返回“Not Found”。

应急方案：手动构造重定向URL #

如果上述配置无法生效，可以绕过Flask的自动URL生成，手动拼接自定义域名的路径：

from flask import url_for, redirect

def build_custom_url(endpoint, **kwargs):
    base_domain = "https://my-app-name.web.app"
    return f"{base_domain}{url_for(endpoint, **kwargs)}"

# 使用示例
if not session.get('user'):
    return redirect(build_custom_url('authentication.login'))

这种方法无需依赖代理头，但需要硬编码域名，维护性较差，仅作为临时应急方案。

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