Swagger OpenAPI 3.0仅GET/POST正常,PUT请求SwaggerUI报CORS错误如何解决
根因分析
CORS是浏览器独有的安全策略,curl、Postman等工具不会触发CORS校验,所以调用正常。你遇到的报错是因为托管swagger.json文件的Nginx服务返回的CORS头中Access-Control-Allow-Methods缺少PUT方法,导致SwaggerUI在浏览器中发起PUT请求前的OPTIONS预检请求被拦截。你后端接口本身已经配置了PUT的CORS支持,问题出在swagger.json的服务侧配置。
解决方案
方案1:修改托管swagger.json的Nginx配置
找到对应站点的Nginx配置文件,调整swagger.json路径的CORS规则,示例配置如下:
server { # 原有监听、域名配置保留 location /medic/ic-swagger.json { # 处理OPTIONS预检请求 if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods 'GET, POST, PUT, OPTIONS'; add_header Access-Control-Allow-Headers 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type'; add_header Content-Length 0; add_header Content-Type text/plain; return 204; } # 普通请求统一添加CORS头 add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods 'GET, POST, PUT, OPTIONS'; add_header Access-Control-Allow-Headers 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type'; # 原有静态文件配置(root、expires、ETag等)保留即可 } }
修改完成后执行nginx -t检查配置合法性,确认无误后执行nginx -s reload重载配置生效。
方案2:如果swagger.json由后端框架自动生成(非Nginx托管)
如果是SpringBoot等后端框架直接生成swagger接口文档,添加全局CORS配置即可,以SpringBoot为例:
@Configuration public class GlobalCorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOriginPatterns("*") // 允许PUT方法 .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*") .allowCredentials(true) .maxAge(3600); } }
验证方式
重载配置后重新执行curl -I "http://192.168.2.120:8087/medic/ic-swagger.json",确认返回头中Access-Control-Allow-Methods已经包含PUT即可,此时SwaggerUI调用PUT请求就会正常。
内容的提问来源于stack exchange,提问作者user3008410
相关产品推荐
相关产品推荐

