如何解决Swagger UI自动跳转加载Petstore示例的问题

你之前的配置全部失效，核心是踩了Swagger UI高版本的几个默认规则坑：

• queryConfigEnabled是控制「是否允许从URL查询参数读取配置」的总开关，这个开关本身不支持通过URL参数、远程configUrl配置开启。你试图在URL里拼接queryConfigEnabled=true属于逻辑悖论：开关没开启时，URL上的所有参数都不会被解析，传了也不会生效。
• 你在项目根目录、src目录、Docker应用根目录放的swagger-config.yaml/json不会被自动加载。这个配置文件仅在你从Swagger UI源码自行编译构建时才会被打包进去，如果你用的是npm安装的预编译包（比如swagger-ui-dist、swagger-ui-express），包内已经内置了编译好的默认配置，你在外层放多少份同名文件都不会被识别，配置CONFIG_URL环境变量同理，预编译包没有读这个环境变量的逻辑。
• 你修改dist/swagger-initializer.js能生效，是因为刚好改到了预编译包的初始化入口，命中了高优先级的初始化传参位置，但直接修改node_modules目录下的文件本身就不是持久化方案，依赖重装后必然丢失。

根据你实际的集成方式选对应方案即可，不需要修改node_modules内的文件：

服务端框架集成场景（swagger-ui-express、NestJS Swagger等） #

直接在服务端初始化Swagger UI的配置项里显式传入参数，这是最稳定的方案，配置优先级最高不会被覆盖：

// swagger-ui-express 示例
const swaggerUi = require('swagger-ui-express');
const swaggerSpec = require('./swagger-spec');

app.use('/swagger', swaggerUi.serve, swaggerUi.setup(swaggerSpec, {
  // 要支持URL传参配置就加这行
  queryConfigEnabled: true,
  // 不需要支持URL换文档的话直接写死地址即可，甚至不用开上面的开关
  // swaggerUrl: '/swagger/swagger.json'
}));

其他框架逻辑完全一致，找到Swagger初始化的配置入口，把参数加进去就行。

直接托管swagger-ui-dist静态资源场景 #

不要直接托管node_modules内的原始文件，把初始化文件拷贝到自己项目的静态资源目录维护：

1. 先把初始化文件拷到自己的静态资源目录：
   cp node_modules/swagger-ui-dist/swagger-initializer.js ./your-static-dir/swagger/
2. 编辑拷贝后的文件，在SwaggerUI({})入参里加上queryConfigEnabled: true，或者直接把默认的Petstore地址替换成你自己的/swagger/swagger.json
3. 在package.json里加postinstall钩子，每次依赖重装后自动同步文件，避免手动维护：

{
  "scripts": {
    "postinstall": "cp node_modules/swagger-ui-dist/swagger-initializer.js ./your-static-dir/swagger/"
  }
}

Docker部署场景 #

直接在Docker构建阶段修改镜像内的初始化配置，不需要额外挂载文件：

FROM node:18-alpine
# 省略你的常规构建步骤：拷贝代码、安装依赖、构建项目等
# 构建阶段直接替换默认配置
RUN sed -i 's|https://petstore.swagger.io/v2/swagger.json|/swagger/swagger.json|g' /app/node_modules/swagger-ui-dist/swagger-initializer.js \
    && sed -i 's|queryConfigEnabled: false|queryConfigEnabled: true|g' /app/node_modules/swagger-ui-dist/swagger-initializer.js

小提示：如果没有动态切换Swagger文档地址的需求，直接在初始化配置里写死url参数即可，不需要开启queryConfigEnabled，从根源上避免跳转到默认Petstore页面，也减少参数被篡改的风险。

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