Swagger UI升级4.x后忽略url查询参数默认加载PetStore如何解决

Swagger UI 自4.0.0版本起，出于安全防护考虑，默认禁用了通过URL查询参数传递配置的能力。
3.x版本中该能力默认开启，因此拼接?url=https://example.com/docs/simrws.yaml参数可以正常覆盖默认配置、加载自定义接口Schema；升级到4.x后，未做显式配置的前提下，Swagger UI会直接忽略URL中携带的所有配置参数，直接加载初始化阶段硬编码的默认示例Swagger Petstore，整个忽略参数的流程不会触发异常，因此浏览器控制台无任何报错输出。

根据你的部署方式选择对应操作即可：

• 原生静态资源/自定义前端初始化部署
  找到Swagger UI的初始化代码段，在配置对象中显式添加queryConfigEnabled: true配置项，开启URL参数配置能力，示例代码如下：

  window.ui = SwaggerUIBundle({
    // 保留原有已配置的dom_id、presets、layout等配置项
    queryConfigEnabled: true, // 新增该行即可
  });
  

  如果不需要动态切换不同Schema地址，也可以不开启上述开关，直接在初始化配置中写死要加载的Schema地址，同样可以绕过默认加载Petstore的问题：

  window.ui = SwaggerUIBundle({
    // 保留原有其他配置项
    url: "https://example.com/docs/simrws.yaml", // 直接指定默认加载的Schema地址
  });
  

• 基于后端框架封装的Swagger中间件部署（如swagger-ui-express、SpringDoc、NestJS Swagger模块等）
  找到对应框架暴露的Swagger自定义配置项，在Swagger配置对象中开启queryConfigEnabled开关即可，多数封装库会将原生Swagger配置收纳在swaggerOptions字段下，配置完成后重启对应服务即可生效。

安全提示：开启queryConfigEnabled后，任意访问者都可以通过URL参数指定Swagger UI加载的Schema地址，若你的部署场景存在公网访问要求，建议在服务层增加URL参数白名单校验，仅允许加载受信任的Schema文件地址，避免恶意内容注入风险。

配置修改完成后，清空浏览器缓存重新访问带参数的地址，即可正常加载目标接口文档。

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