FastAPI中url_for生成HTTP而非HTTPS导致静态资源加载失败

针对你用Nginx+HAProxy做反向代理、Uvicorn部署FastAPI时，url_for生成HTTP链接导致静态资源加载失败的问题，给你几个可行的解决办法：

方法一：让Uvicorn信任反向代理的转发头 #

反向代理会把用户请求的真实协议（HTTPS）放在X-Forwarded-Proto请求头里，只要让Uvicorn识别并信任这个头，url_for就能自动生成HTTPS链接。

1. 启动Uvicorn时添加参数：

   uvicorn main:app --host 0.0.0.0 --port 8000 --forwarded-allow-ips='*'
   

   --forwarded-allow-ips='*'表示信任所有反向代理发送的转发头，生产环境可以指定具体的代理IP提升安全性。

2. 确保反向代理正确传递头：

   • Nginx配置中需添加：

     location / {
         proxy_pass http://your-fastapi-service:8000;
         proxy_set_header Host $host;
         proxy_set_header X-Forwarded-For $remote_addr;
         proxy_set_header X-Forwarded-Proto $scheme;
     }
     

   • HAProxy配置中需添加：

     backend fastapi_backend
         server app 127.0.0.1:8000
         http-request set-header X-Forwarded-Proto https if { ssl_fc }
         http-request set-header X-Forwarded-For %[src]
     

方法二：全局强制url_for使用HTTPS #

如果第一种方法不生效，可以在代码层面修改url_for的行为，强制生成HTTPS链接：

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()
app.mount("/static", StaticFiles(directory="static"), name="static")

# 覆盖默认的url_path_for方法，替换HTTP为HTTPS
original_url_for = app.url_path_for

def https_url_for(name, **path_params):
    url = original_url_for(name, **path_params)
    return url.replace("http://", "https://")

app.url_path_for = https_url_for

或者在模板里直接指定协议（适合少量模板的场景）：

{{ url_for('static', path='css/style.css', _scheme='https', _external=True) }}

方法三：启动Uvicorn时直接指定HTTPS scheme #

启动Uvicorn时通过--scheme参数强制使用HTTPS：

uvicorn main:app --host 0.0.0.0 --port 8000 --scheme https

如果你的应用有根路径（比如反向代理映射到子路径），还可以加上--root-path参数：

uvicorn main:app --host 0.0.0.0 --port 8000 --scheme https --root-path "/your-app-path"

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