找不到依赖项 'org.springdoc:springdoc-openapi-starter-webmvc-ui:1.6.9'

### 解决方案 `springdoc-openapi-starter-webmvc-ui` 是 `springdoc-openapi` 提供的一个模块，用于支持 Spring MVC 和 OpenAPI UI 集成。然而，在 Maven 中查找该依赖时可能会遇到版本不匹配或无法找到的情况。 以下是可能的原因以及解决方案： #### 1. 版本兼容性问题 `sprindoc-openapi` 的命名空间和模块名称在不同版本之间可能存在变化。例如，早期版本使用的是 `springdoc-openapi-ui` 而不是 `springdoc-openapi-starter-webmvc-ui`[^3]。因此，建议确认当前使用的版本是否确实存在此模块。 对于 `1.6.9` 版本，正确的依赖应该是 `springdoc-openapi-ui`，而不是 `springdoc-openapi-starter-webmvc-ui`。如果需要使用后者，则应升级到更高版本（如 `2.x.x` 或以上），因为这些新功能是在后续版本中引入的。 ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.6.9</version> </dependency> ``` #### 2. 检查 Maven Central Repository 是否有对应版本 有时特定版本可能未发布至中央仓库或者被移除。可以通过访问 [Maven Central](https://search.maven.org/) 并搜索 `springdoc-openapi-starter-webmvc-ui` 来验证是否存在目标版本。如果没有发现所需版本，则可能是官方已废弃或更名。 #### 3. 替代方案：Knife4j 如果仍然无法解决问题，可以考虑切换到其他工具库，比如 Knife4j。它提供了类似的 API 文档生成功能，并且具有良好的社区支持。其 Maven 坐标如下所示[^2]: ```xml <dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-openapi2-spring-boot-starter</artifactId> <version>4.0.0</version> </dependency> ``` 需要注意的是，Knife4j 主要基于 Swagger 实现，而并非完全遵循 OpenAPI 3 标准；但在大多数情况下能够满足需求。 #### 4. 自定义 Java 配置方式 当通过 XML 文件或其他方法难以实现正确加载时，也可以尝试采用纯 Java 编程方式进行初始化设置。下面是一个简单的例子展示如何手动注册 DispatcherServlet 及关联 Bean 定义[^4]: ```java package com.example.config; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer; @Configuration @ComponentScan(basePackages = {"com.example"}) public class WebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer { @Override protected Class<?>[] getRootConfigClasses() { return new Class[]{RootConfig.class}; } @Override protected Class<?>[] getServletConfigClasses() { return new Class[]{WebConfig.class}; } @Override protected String[] getServletMappings() { return new String[]{"/"}; } } ``` 这种做法虽然稍微复杂一点，但它允许开发者拥有更大的灵活性来调整框架行为。 --- ### 总结 综上所述，针对找不到依赖项 `'org.springdoc:springdoc-openapi-starter-webmvc-ui:1.6.9'` 这一情况，推荐先核实实际可用的 artifact 名称与版本号组合是否一致；其次可选用替代产品 Knife4j 继续开发工作流程；最后还可以借助编程手段完成必要的组件装配过程。