OpenAPIClientAxios加载openapi.json初始化失败原因排查

问题原因分析 #

1. 响应来源：浏览器缓存
   你之前用Firefox成功请求过openapi.json，浏览器会缓存该响应。当Node.js客户端（运行在浏览器环境中）发起请求时，浏览器直接读取本地缓存的文件，没有向服务器发送新请求。而缓存的响应未包含CORS所需的Access-Control-Allow-Origin头，因此触发跨域错误。

2. 服务器未被调用的原因
   浏览器缓存机制优先返回了本地存储的响应，完全跳过了向服务器发起GET请求的步骤，所以你的Flask服务器没有检测到请求。

解决方案 #

• 强制绕过缓存
  在请求openapi.json时添加随机查询参数，让浏览器认为是新请求，避免读取缓存：

  const api = new OpenAPIClientAxios({
    definition: `http://localhost:8090/openapi.json?t=${Date.now()}`
  })
  const client = await api.init<Client>()
  

• 确认CORS配置覆盖所有路由
  你当前的CORS(app.app)理论上对所有路由生效，但需要验证Connexion自动生成的/openapi.json路由是否被Flask-CORS正确处理。可以检查Flask-CORS的DEBUG日志，看是否有针对该路由的CORS处理记录；也可以显式指定允许的源，确保覆盖所有路径。

• 用curl验证服务器响应头
  直接用命令行测试服务器是否返回正确的CORS头：

  curl -v http://localhost:8090/openapi.json
  

  查看响应头中是否包含Access-Control-Allow-Origin，如果没有，说明Flask-CORS未正确应用到该路由，可能需要调整Connexion和Flask-CORS的初始化顺序，或者显式为/openapi.json路由添加CORS规则。

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