一、核心问题原因拆解 #

1. 版本兼容性冲突 #

你使用的Spring Boot 1.5.5.RELEASE和Springfox 2.9.2存在严重的版本不匹配：

• Spring Boot 1.5.x对应的Springfox兼容版本应为2.7.x系列，2.9.2是为Spring Boot 2.x设计的跨版本适配，会触发大量内部逻辑冲突，尤其是请求处理器扫描、Guava依赖适配层面。
• 你提到的Guava内存异常，本质是Springfox 2.9.2依赖的Guava版本与Spring Boot 1.5.x自带的Guava版本冲突——即使手动替换也无法完全解决底层逻辑的兼容性问题，因为框架内部对Guava的API调用方式在两个版本差异极大。

2. 自定义API扫描逻辑的性能灾难 #

看你提供的Docket配置，apis()方法里的自定义判断逻辑是启动变慢的直接元凶：

.apis( (wmrh)->{ 
    final StringBuffer sb = new StringBuffer();
    sb.append( wmrh.getClass().getTypeName() +"\n\t"+ wmrh );
    final RequestHandlerKey rhk = wmrh.key();
    boolean result = false;
    for( String pathMapping : rhk.getPathMappings() ) {
        sb.append( "\n\t-> "+ pathMapping );
        result |= pathMapping.startsWith( "/api/public/" );
    }
    sb.append( "\n\t=> "+ result +", time: "+ Util.formatTime( System.currentTimeMillis() - TIME ) +" after start." );
    LOG.debug( sb.toString() );
    return result;
} )

这段代码会在启动时对每一个请求处理器执行字符串拼接、循环遍历、日志打印操作，如果项目有大量Controller接口，会直接拖垮启动速度，甚至因为循环日志输出导致IO阻塞，出现“无限启动”的假象。

3. 框架防护缺失的原因 #

Springfox是社区维护工具，对于跨版本的非兼容场景没有强制版本校验机制——早期Spring生态版本迭代快，框架无法覆盖所有组合。而你的自定义扫描逻辑属于业务侧代码，框架无法感知这种性能陷阱。

二、修复方案 #

1. 版本回退到兼容组合 #

立即将Springfox版本降级到2.7.0，这是Spring Boot 1.5.x最稳定的兼容版本，无需手动替换Guava，依赖会自动对齐：

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.7.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.7.0</version>
</dependency>

2. 优化API扫描逻辑 #

把自定义路径判断换成Springfox内置工具类，避免手动遍历和日志输出：

.apis(RequestHandlerSelectors.basePackage("你的public API所在包路径"))
.paths(PathSelectors.ant("/api/public/**"))

如果必须基于路径映射判断，也简化为简洁的流式判断：

.apis(wmrh -> wmrh.key().getPathMappings().stream()
    .anyMatch(path -> path.startsWith("/api/public/")))

三、Swagger/Springfox的适用性与替代方案 #

1. 关于Spring体系的适用性 #

Springfox对于Spring Boot 2.x及以上版本仍然是可靠选择，但Spring Boot 1.x这类老旧版本已被官方停止维护，兼容性问题会越来越多。如果项目能升级到Spring Boot 2.x+，可以使用Springfox 3.x版本，体验会有明显提升。

2. 替代工具推荐 #

• SpringDoc OpenAPI：目前Spring生态最主流的Swagger替代方案，基于OpenAPI 3.0标准，支持Spring Boot 1.x和2.x，启动速度快、内存占用低，自带UI且配置更简洁。
• Knife4j：国内开源的API文档工具，基于Swagger/OpenAPI，增强了UI体验和扩展功能，适配国内开发者习惯，对Spring Boot兼容性好。
• RapiDoc：轻量级OpenAPI文档渲染工具，UI更现代化，支持多种交互方式，可配合SpringDoc使用。

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