Docker部署Swagger UI无法使用Try out功能：内部端口问题

我之前也碰到过这个问题，核心原因是Swagger UI默认会采用容器内部的服务地址（比如容器IP+内部端口10010）来生成API请求，而不是我们外部访问的localhost:15000，所以导致「Try it out」发送的请求地址不对，无法正常调用接口。下面给你几个实用的解决办法：

方案1：硬编码外部访问地址到Swagger配置 #

找到你的Swagger文档配置文件（比如swagger.yaml/swagger.json），或者代码里的Swagger定义部分，直接指定外部访问的host和路径：

如果用Swagger 2.0格式（yaml示例） #

swagger: "2.0"
info:
  title: "Your API"
  version: "1.0.0"
host: "localhost:15000" # 外部访问的host+端口
basePath: "/"
# 其他API定义...

如果用OpenAPI 3.0格式（yaml示例） #

openapi: "3.0.0"
info:
  title: "Your API"
  version: "1.0.0"
servers:
  - url: "http://localhost:15000/" # 直接指定外部访问的完整基础URL
# 其他API定义...

如果是代码里定义Swagger（swagger-jsdoc示例） #

const swaggerDefinition = {
  openapi: '3.0.0',
  info: {
    title: 'Your API',
    version: '1.0.0',
  },
  servers: [
    { url: 'http://localhost:15000/' }
  ]
};

这种方式简单直接，适合固定部署环境的场景。

方案2：通过swagger-ui-express动态适配当前访问地址 #

如果不想硬编码地址，可以利用swagger-ui-express的配置项，让Swagger UI自动使用当前浏览器地址栏的host和端口来构建API请求：

const express = require('express');
const swaggerUi = require('swagger-ui-express');
const swaggerDocument = require('./swagger.json');

const app = express();

app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument, {
  swaggerOptions: {
    useAbsolutePaths: true, // 启用绝对路径，自动适配当前页面的host
    validatorUrl: null, // 可选：关闭在线校验，避免跨域或校验服务不可用的问题
  },
}));

app.listen(10010, () => {
  console.log('Server running on port 10010');
});

useAbsolutePaths这个配置会让Swagger UI自动拾取当前页面的访问地址（比如你打开的http://localhost:15000/api-docs），然后用这个地址的host和端口来生成API请求，完美适配不同的部署环境。

方案3：用环境变量动态传递外部地址 #

如果需要更灵活的部署（比如本地测试、线上服务器用不同地址），可以通过Docker环境变量传递外部地址，然后在代码里读取这个变量：

第一步：修改docker-compose.yaml，添加环境变量 #

version: "3"
services:
  app:
    build: .
    ports:
      - 15000:10010
    environment:
      - API_BASE_URL=http://localhost:15000/ # 外部访问的基础URL

第二步：在代码里读取环境变量配置Swagger #

const swaggerDefinition = {
  openapi: '3.0.0',
  info: {
    title: 'Your API',
    version: '1.0.0',
  },
  servers: [
    { 
      url: process.env.API_BASE_URL || 'http://localhost:10010/' 
      // 默认用内部端口，部署时优先取环境变量
    }
  ]
};

这样在不同环境部署时，只需要修改docker-compose.yaml里的API_BASE_URL即可，不用改动代码或Swagger配置文件。

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