swagger打开空白页

### 解决 Swagger UI 页面打开显示空白的问题

对于 FastAPI 和 Spring Boot 应用程序中遇到的 Swagger UI 显示空白问题，有多种可能的原因以及对应的解决方案。

#### 清除浏览器缓存
当发现 Swagger UI 页面突然变成空白而之前可以正常工作时，尝试清除浏览器缓存可能是最简单有效的办法之一。这一步骤能够移除可能导致渲染失败的老化或损坏的数据[^2]。

#### 配置文件检查
如果最近更改过应用程序配置，则应仔细审查这些变更是否影响到了 Swagger 的行为。特别是对于 Spring Boot 用户来说，在 `application.yml` 或其他配置文件里设置不当可能会阻止 swagger-ui.html 被正确加载[^5]。

#### 正确引入静态资源
确保所有的前端依赖项都已妥善处理，并且服务器端已经配置好以服务必要的静态文件（如 HTML/CSS/JS）。在某些情况下，Spring Boot 可能会因为找不到正确的路径而导致页面无法加载[^4]。

#### 使用最新版本库
确认所使用的框架及其插件均为最新稳定版。开发者社区经常发布修复此类 bug 的更新；因此升级到最新的兼容版本有助于解决问题[^3]。

#### 示例代码片段
下面是一个简单的 Python Flask 应用程序示例，展示了如何通过安装并集成 flask-swagger-ui 来启用 API 文档功能：

from flask import Flask
from flasgger import Swagger

app = Flask(__name__)
Swagger(app)

@app.route('/api/example')
def example():
    """
    Example endpoint returning a list of colors.
    
    ---
    responses:
      200:
        description: A JSON object containing an array of color names.
    """
    return {"colors": ["red", "green", "blue"]}