swagger-ui 无法访问

### 解决Swagger-UI无法访问的问题

对于Spring Boot项目中遇到的`swagger-ui.html`页面404错误，有几种常见原因以及对应的解决方案。

#### 1. 检查依赖项配置
确保项目的`pom.xml`文件里包含了必要的Swagger依赖，并且这些依赖被正确声明。通常情况下，应当包含两个主要组件：一个是用于生成API文档的核心库；另一个则是提供Web界面展示功能的部分[^4]：

<dependencies>
    <!-- Swagger API 文档 -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>${swagger.version}</version>
    </dependency>

    <!-- Swagger UI 展示层 -->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>${swagger.ui.version}</version>
    </dependency>
</dependencies>

#### 2. 启用并配置Swagger Bean
为了使Swagger能够正常工作，还需要在应用程序中注册相应的Bean定义。这可以通过创建一个新的Java类来完成，该类负责设置Docket实例以及其他任何所需的自定义选项[^5]:

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}

#### 3. 处理安全性和权限控制
如果启用了安全性框架（如Spring Security），则可能需要调整其配置以允许未授权用户查看Swagger UI资源。一种简单的方法是在配置类中添加路径匹配规则，使得特定URL模式下的请求无需身份验证即可访问[^2]：

@Override
protected void configure(HttpSecurity http) throws Exception {
    http.authorizeRequests()
            // 放行Swagger相关静态资源和接口
            .antMatchers("/v2/api-docs", "/configuration/ui",
                         "/swagger-resources/**", "/configuration/security",
                         "/swagger-ui.html", "/webjars/**").permitAll()
            ...
}

#### 4. 尝试替代方案
当标准版Swagger出现问题时，考虑采用其他开源工具作为备选，比如Knife4j。它不仅提供了更美观友好的用户体验，而且兼容OpenAPI 3.x规范，有助于解决某些版本不一致带来的难题。

<!-- 替代方案：使用 Knife4j 开源增强版 -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.1.0</version>
</dependency>