You need to enable JavaScript to run this app. Swagger OpenAPI 3.0仅GET/POST正常,PUT请求SwaggerUI报CORS错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.10 19:00:03