为何Swagger-UI无法识别PostgREST生成的OpenAPI规范版本字段？

核心问题分析 #

你遇到的错误本质是Swagger UI没有正确获取到PostgREST返回的OpenAPI规范内容，而非规范本身的版本字段无效——毕竟你已经通过curl和Swagger Editor验证过内容的有效性。最可能的原因有两个：浏览器跨域限制，或者Swagger UI的API_URL配置导致请求指向了错误的地址。

具体修复步骤 #

1. 修正Swagger UI的API_URL配置 #

Swagger UI是在浏览器端运行的，你当前设置的API_URL: "http://localhost:3000"会让浏览器向用户本地的3000端口请求规范，而非部署PostgREST的服务器端口。需要把API_URL改成服务器的公网IP/域名：

- name: Setup Swagger-UI container
  docker_container:
    name: swagger-ui-report
    state: started
    restart_policy: always
    restart: "true"
    image: swaggerapi/swagger-ui:latest
    network_mode: host
    env:
      # 替换成你的服务器IP或域名
      API_URL: "http://<你的服务器IP>:3000"

2. 调整PostgREST的CORS允许源 #

PostgREST当前的PGRST_SERVER-CORS-ALLOWED-ORIGINS设置为http://localhost:3000，但这是PostgREST自身的地址，而Swagger UI的访问地址（比如http://<服务器IP>:8080）才是需要被允许的跨域源。修改配置：

- name: Setup PostgREST container
  docker_container:
    name: postgrest-report
    state: started
    restart_policy: always
    restart: "true"
    image: postgrest/postgrest
    pull: true
    network_mode: host
    env:
      PGRST_DB_URI: postgres://report:<password>@localhost:5432/report
      PGRST_DB_SCHEMA: public
      PGRST_DB_ANON_ROLE: report #In production this role should not be the same as the one used for the connection
      PGRST_SERVER_PROXY_URI: "http://127.0.0.1:3000"
      # 替换成Swagger UI的访问地址
      PGRST_SERVER-CORS-ALLOWED-ORIGINS: "http://<你的服务器IP>:8080"

3. 验证请求内容 #

修改配置并重启容器后，打开Swagger UI页面，按F12打开浏览器开发者工具：

• 切换到「Network」标签，刷新页面
• 找到Swagger UI请求API_URL的GET请求，查看Response内容是否和你curl localhost:3000的结果一致
• 如果返回内容为空、状态码非200，或者有跨域错误提示，再针对性排查网络或CORS配置

额外提示 #

如果服务器有防火墙，确保3000（PostgREST）和8080（Swagger UI）端口已经对外开放，允许浏览器访问。

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