Swagger UI（OpenAPI UI）执行按钮失效问题解决咨询

• 检查浏览器控制台错误
  按F12打开开发者工具，切换到Console标签页，查看是否存在JS报错、资源加载失败或跨域（CORS）相关错误。跨域是常见诱因，若出现No 'Access-Control-Allow-Origin'类报错，需在服务端配置CORS规则，允许Swagger UI所在域名的访问请求。

• 验证OpenAPI规范合法性
  确认你的OpenAPI（Swagger）yaml/json文件符合官方规范，无语法或逻辑错误。可通过Swagger Editor本地版本导入文件检查，未定义的引用、参数格式错误、路径配置缺失等问题，都会导致Swagger UI解析失败，进而使执行按钮失效。

• 核对版本兼容性
  不同版本的Swagger UI对OpenAPI规范的支持范围不同：

  • Swagger UI 3.x适配OpenAPI 3.0+
  • Swagger UI 2.x仅支持Swagger 2.0规范
    若API文档为OpenAPI 3.0，但使用了旧版Swagger UI，会引发功能异常，建议升级至匹配版本。

• 确认请求参数完整性
  点击执行按钮前，检查所有必填参数（路径参数、查询参数、请求体必填字段）是否已正确填写。部分Swagger UI版本不会对未填必填项给出提示，此时按钮不会触发请求。

• 检查静态资源加载状态
  在开发者工具的Network标签页，确认Swagger UI相关的JS、CSS文件（如swagger-ui-bundle.js、swagger-ui-standalone-preset.js）全部加载成功（状态码200）。资源加载失败会导致交互功能异常，需确认静态资源的引用路径配置正确。

• 排查服务端可用性
  用curl或Postman直接调用目标API，验证服务端能否正常响应。若服务端本身无法处理请求，Swagger UI的执行按钮自然不会有反馈，需优先排查服务端问题。

• 清理浏览器缓存
  浏览器缓存的旧版Swagger UI资源可能引发冲突，按Ctrl+Shift+R强制刷新页面，或清空浏览器缓存后重新加载。

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