FastApi接口返回500错误时前端收到CORS错误而非500问题求助

问题根因 #

你遇到的属于伪CORS错误，本质和CORS配置本身无关，原因如下：
FastAPI 的 CORS 中间件默认只会给正常执行完成的响应注入Access-Control-Allow-Origin等CORS相关头。当/pattern-data接口内部抛出未捕获的异常时，FastAPI 自动生成的500错误响应不会被CORS中间件处理，返回的响应头里没有CORS相关字段，浏览器出于安全策略会优先拦截该响应，直接报CORS错误，隐藏了真实的500状态码和错误信息。
你在后端日志能收到请求载荷，也验证了预检请求已经通过，CORS基础配置本身是正常的，问题完全出在接口内部的执行错误上。

解决方案 #

1. 优先修复接口内部逻辑 #

你可以直接查看后端服务的错误日志，定位/pattern-data接口抛出的具体异常，把逻辑问题修复后，接口可以正常返回响应时，CORS报错会自动消失。

2. 临时调试：捕获异常主动返回 #

如果需要前端能拿到真实的错误信息，可以先在接口内加全局异常捕获，主动构造响应：

from fastapi import HTTPException

@app.post("/pattern-data")
def pattern_input(payload: PatternReconData) -> Dict:
    try:
        # 原有业务逻辑
        return result
    except Exception as e:
        # 主动抛出标准化HTTP异常，会被中间件正常处理附加CORS头
        raise HTTPException(status_code=500, detail=f"接口执行失败: {str(e)}")

3. 永久修复：配置全局异常处理器 #

如果希望所有异常场景下都不会出现伪CORS报错，可以添加全局异常处理器，强制给所有错误响应附加CORS头：

from fastapi import Request
from fastapi.responses import JSONResponse
from starlette.middleware.cors import CORSMiddleware

# 注意：CORS中间件必须挂载在所有其他中间件的最前面
app.add_middleware(
    CORSMiddleware,
    allow_origins=["http://localhost:4200"], # 替换为你的前端实际访问地址
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

# 全局异常捕获，给所有错误响应加CORS头
@app.exception_handler(Exception)
async def catch_all_exception(request: Request, exc: Exception):
    origin = request.headers.get("Origin")
    headers = {}
    if origin:
        headers["Access-Control-Allow-Origin"] = origin
        headers["Access-Control-Allow-Credentials"] = "true"
    return JSONResponse(
        status_code=500,
        content={"detail": f"服务器内部错误: {str(exc)}"},
        headers=headers
    )

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