Flask API浏览器请求返回500无服务端日志 疑似CORS问题排查求助

问题排查步骤 #

• 第一步优先查看浏览器开发者工具「网络」与「控制台」标签的报错信息：
  • 若控制台明确提示跨域相关错误（如No 'Access-Control-Allow-Origin' header is present on the requested resource），同时OPTIONS请求未发送到服务端，先核对请求头Access-Control-Request-Headers字段，确认是否携带了未在现有CORS配置中允许的自定义请求头，部分前端打包工具会默认追加x-requested-with等额外头，不在允许列表中会直接触发预检失败。
  • 若OPTIONS请求已发出但返回非2xx状态，直接查看响应内容确认报错来源，大概率是Flask服务前置的反向代理、CDN、WAF组件拦截了请求，未转发到Flask进程，因此服务端无访问日志。
• 第二步验证前置组件拦截逻辑：若线上Flask服务前部署了Nginx、负载均衡等组件，优先查看这类组件的访问日志，确认OPTIONS请求是否被直接拦截返回。

解决方案 #

1. 替换自定义CORS逻辑为官方维护的flask-cors扩展：
   你当前使用的after_request方案仅在请求正常完成业务逻辑处理后才会追加CORS头，若请求在进入路由前就触发错误（如404、405、参数校验失败），不会返回CORS头导致浏览器判为跨域失败。flask-cors会自动处理OPTIONS预检请求，不受后续业务逻辑影响。
   安装命令：
   pip install flask-cors
   配置示例：

from flask import Flask
from flask_cors import CORS

app = Flask(__name__)
CORS(app, resources={
    r"/*": {
        "origins": "*",
        "allow_headers": ["Content-Type", "Authorization", "Auth-Token"],
        "methods": ["GET", "PUT", "POST", "DELETE"]
    }
})

2. 若确认是前置Nginx拦截了OPTIONS请求，在对应站点的Nginx配置location块中追加如下规则：

location / {
    if ($request_method = OPTIONS) {
        add_header Access-Control-Allow-Origin *;
        add_header Access-Control-Allow-Headers "Content-Type,Authorization,Auth-Token";
        add_header Access-Control-Allow-Methods "GET,PUT,POST,DELETE";
        add_header Access-Control-Max-Age 86400;
        return 204;
    }
    # 保留原有代理到Flask的配置不变
    proxy_pass http://127.0.0.1:你的Flask服务端口;
}

3. 配置完成后使用curl命令直接验证OPTIONS请求响应：
   curl -X OPTIONS -H "Origin: 你前端打包后部署的域名" -H "Access-Control-Request-Method: POST" 你的接口地址 -i
   若返回204状态码且携带正确的CORS响应头，再到浏览器验证即可。

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