解决Flask CORS问题：从配置到FastAPI的迁移-Python教程-PHP中文网

解决Flask CORS问题：从配置到FastAPI的迁移

聖光之護

发布： 2025-09-07 11:57:21

原创

565人浏览过

解决flask cors问题：从配置到fastapi的迁移

本文旨在帮助开发者解决在使用Flask框架时遇到的CORS（跨域资源共享）问题。通过分析常见错误配置和请求头，提供详细的排查步骤。同时，考虑到flask-cors可能存在的问题，本文推荐使用FastAPI框架作为替代方案，并提供快速迁移的示例代码，以确保跨域请求的顺利进行。

CORS（跨域资源共享）问题是Web开发中常见的挑战，特别是在前后端分离的项目中。当浏览器检测到跨域请求时，会执行安全策略，阻止未经授权的请求。本文将深入探讨如何解决在使用Flask框架时遇到的CORS问题，并提供一种替代方案，即使用FastAPI框架。

Flask CORS 配置检查

首先，确保flask-cors库已正确安装：

pip install flask-cors

登录后复制

然后，检查Flask应用中的CORS配置。最简单的配置方式是允许所有来源的请求：

from flask import Flask, request, jsonify
from flask_cors import CORS

app = Flask(__name__)
CORS(app)

@app.route("/process", methods=['POST'])
def process():
    print('process')
    # process here
    return jsonify({'response': 'OK'})

if __name__ == '__main__':
    app.run(debug=True, port=5000)

登录后复制

然而，在生产环境中，允许所有来源可能存在安全风险。建议限制允许的来源：

from flask import Flask, request, jsonify
from flask_cors import CORS

app = Flask(__name__)
CORS(app, origins=["http://localhost:3001"]) # 仅允许来自 http://localhost:3001 的请求

@app.route("/process", methods=['POST'])
def process():
    print('process')
    # process here
    return jsonify({'response': 'OK'})

if __name__ == '__main__':
    app.run(debug=True, port=5000)

登录后复制

注意事项：

百度智能云·曦灵

百度旗下的AI数字人平台

查看详情

确保前端请求的Origin与CORS配置中的允许来源一致。
如果需要支持多种来源，可以将origins设置为一个列表：origins=["http://localhost:3001", "http://example.com"]
如果配置了Access-Control-Allow-Credentials: true，则Access-Control-Allow-Origin不能设置为*，必须指定具体的域名。

Content-Type 与 Preflight 请求

对于POST请求，特别是包含Content-Type: application/json或Content-Type: multipart/form-data的请求，浏览器可能会发送一个OPTIONS预检请求（preflight request）。 Flask需要正确处理这个OPTIONS请求。 flask-cors库通常会自动处理这些预检请求。

注意事项：

确保你的Flask路由也支持OPTIONS方法，即使你不需要在路由处理函数中做任何事情。
如果手动处理OPTIONS请求，请确保返回正确的Access-Control-Allow-Origin、Access-Control-Allow-Methods和Access-Control-Allow-Headers头。

排查403 Forbidden 错误

403 Forbidden 错误通常不是由CORS直接引起的，而是表示服务器拒绝了该请求。这可能是由于以下原因：

服务器端存在认证或授权问题。
请求的资源不存在或不可访问。
服务器配置了其他安全策略，例如防火墙规则。

检查服务器端的日志，查看是否有更详细的错误信息，以帮助你确定问题的根源。

使用 VSCode REST Client 进行测试

VSCode REST Client 是一个非常有用的工具，可以用来测试API端点。但是，需要注意的是，REST Client 不会像浏览器那样强制执行CORS策略。这意味着即使你的API端点存在CORS问题，REST Client 仍然可以正常工作。

切换到 FastAPI

如果在使用flask-cors时仍然遇到问题，可以考虑切换到FastAPI。 FastAPI是一个现代、高性能的Python Web框架，它内置了对CORS的支持，并且通常更容易配置。

以下是将上述Flask代码迁移到FastAPI的示例：

from fastapi import FastAPI, File, UploadFile
from fastapi.middleware.cors import CORSMiddleware
from fastapi.responses import JSONResponse

app = FastAPI()

origins = [
    "http://localhost:3001",  # 允许特定的源
    "*", # 注意：生产环境不建议使用 *，除非你真的需要允许所有来源
]

app.add_middleware(
    CORSMiddleware,
    allow_origins=origins,
    allow_credentials=True,
    allow_methods=["*"],  # 允许所有方法
    allow_headers=["*"],  # 允许所有头部
)

@app.post("/process")
async def process(image: UploadFile = File(...)):
    print('process')
    # 在这里处理上传的图片
    return JSONResponse({"response": "OK"})

登录后复制

注意事项：

确保安装了fastapi和uvicorn：pip install fastapi uvicorn
使用uvicorn main:app --reload命令运行FastAPI应用（假设你的代码保存在main.py文件中）。
allow_origins、allow_credentials、allow_methods和allow_headers是CORSMiddleware的关键参数，用于配置CORS策略。