必须显式注册 corsmiddleware，且 allow_origins 与 allow_credentials 冲突会导致 cors 失效；正确顺序是先创建 app = fastapi() 再 add_middleware；allow_methods 必须含 options；allow_headers 需覆盖前端实际发送的头。
必须显式注册 CORSMiddleware，否则跨域无效
FastAPI 不会自动启用跨域支持，CORSMiddleware 必须手动添加到应用实例中，且只能注册一次。漏掉这一步，或放在 app = FastAPI() 之前，中间件根本不会生效。
- 正确顺序：先创建
app = FastAPI()，再调用app.add_middleware(...) - 错误写法：
app = FastAPI(..., middleware=[...])—— 这种构造参数方式在新版 FastAPI 中已被弃用，不触发中间件 - 调试技巧：启动后访问任意接口，在响应头里找
access-control-allow-origin；没有就说明中间件没注册成功
allow_origins 和 allow_credentials 不能同时用 ["*"]
这是最常踩的坑：只要设置了 allow_credentials=True（比如前端要传 Cookie 或 Bearer Token），allow_origins 就绝不能是 ["*"]。否则 FastAPI 会静默忽略整个 CORS 配置，浏览器预检请求直接失败，控制台报错但后端日志无记录。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 开发环境安全写法：
allow_origins=["http://localhost:3000"]（精确匹配协议+域名+端口） - 生产环境必须列全可信域名：
allow_origins=["https://app.example.com", "https://www.example.com"] - 想动态判断源？可以用函数代替列表：
allow_origins=lambda origin: origin in ["https://a.com", "https://b.com"]，但注意 Starlette 要求返回布尔值
allow_methods 必须显式包含 OPTIONS，尤其用 POST/PUT/DELETE 时
浏览器对非简单请求（如带 Content-Type: application/json 的 POST、任何 PUT 或 DELETE）会先发 OPTIONS 预检。如果 allow_methods 没包含 "OPTIONS"，预检就 405，后续请求永远不会发出。
- 开发期图省事：
allow_methods=["*"]—— 它隐含覆盖所有标准方法，包括OPTIONS - 生产环境推荐显式列出：
allow_methods=["GET", "POST", "PUT", "DELETE", "OPTIONS"] - 别信“
["*"]在生产不能用”这种说法：Starlette 允许它，只要allow_origins是具体列表而非["*"]
allow_headers 至少要覆盖前端实际发的头
allow_headers=["*"] 在开发期可用，但生产环境若用它，Starlette 会抛 ValueError（除非你同时设了 expose_headers）。更稳妥的做法是只放开真正需要的头。
- 必加项：
"Content-Type"（几乎所有 JSON 请求都带）、"Authorization"（JWT 认证）、"X-Requested-With"（部分旧框架依赖） - 常见遗漏：
"Accept"、"X-CSRF-Token"—— 如果前端代码明确设置了这些，就必须出现在allow_headers里 - 注意大小写：HTTP 头名不区分大小写，但 Starlette 内部匹配时按原样比对，建议全小写写法保持一致
allow_origins 和 allow_credentials 的耦合关系 —— 它不是“配了就行”，而是“配错就彻底失效”。哪怕其他参数全对，只要这一对冲突，CORS 就形同虚设。大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
