FastAPI返回重复Access-Control-Allow-Origin跨域头问题求助

排查方向1：检查多层中间件/代理的重复配置 #

• 若部署时用了Nginx、Apache等反向代理，检查代理配置里是否手动添加了Access-Control-Allow-Origin头——很多场景下会同时在FastAPI和代理端配置CORS，导致重复生成响应头。
• 排查FastAPI项目内的自定义中间件，确认是否有响应拦截逻辑不小心重复设置了该头。

排查方向2：FastAPI CORSMiddleware的配置问题 #

• 确保CORSMiddleware只注册一次，避免重复添加：

from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware

app = FastAPI()

# 仅需注册一次CORS中间件
app.add_middleware(
    CORSMiddleware,
    allow_origins=["你的前端域名"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

• 检查路由或依赖函数中是否手动修改了响应头，比如response.headers["access-control-allow-origin"] = "xxx"这类代码，会和CORSMiddleware生成的头冲突。

排查方向3：第三方库的隐式CORS处理 #

• 若使用了FastAPI第三方扩展（如认证库、API网关插件），确认这些工具是否自带CORS处理逻辑，与你手动配置的CORSMiddleware产生了重复。

临时验证方法 #

• 先注释掉FastAPI中的CORSMiddleware配置，测试请求后查看响应头：若仍有一个Access-Control-Allow-Origin头，说明是代理或其他组件添加的；若没有，则重新配置CORSMiddleware并确保仅注册一次。

修复后验证 #

• 修改完成后，通过浏览器开发者工具查看响应头，确认仅存在一个Access-Control-Allow-Origin头，且值为你允许的前端源。

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