如何在无数据库依赖下生成Spring Boot OpenApi文档？

方案一：Mock核心JPA/JDBC Bean #

直接Mock掉Spring初始化JPA和JDBC时需要的核心Bean，让Spring跳过真实数据库的初始化流程。修改测试类如下：

@SpringBootTest
@AutoConfigureMockMvc
@MockBean({
    DeviceUpdateService.class,
    SomeConfiguration.class,
    // Mock JPA/JDBC核心组件，避免初始化真实数据库
    EntityManagerFactory.class,
    DataSource.class,
    JpaTransactionManager.class
})
// 移除对PostgresBaseTest的继承
class GenerateApiDocTest {
    // 测试逻辑：通过MockMvc请求OpenAPI文档接口并保存结果
}

这样Spring容器会使用Mock的Bean替代真实的数据库相关组件，不会再抛出entityManagerFactory创建失败的错误。

方案二：通过Profile禁用JPA自动配置 #

创建专门的测试Profile，在该环境下排除JDBC和JPA的自动配置类，从根源上阻止Spring加载数据库相关逻辑：

1. 在测试类上激活自定义Profile：

@SpringBootTest
@AutoConfigureMockMvc
@ActiveProfiles("openapi-doc")
@MockBean({DeviceUpdateService.class, SomeConfiguration.class})
class GenerateApiDocTest {
    // 测试逻辑
}

2. 在src/test/resources下创建application-openapi-doc.yml配置文件：

spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
      - org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration
      - org.springframework.boot.autoconfigure.transaction.TransactionAutoConfiguration

该配置会让Spring跳过所有数据库相关的自动配置，完全摆脱数据库依赖。

方案三：仅加载OpenAPI相关上下文（更轻量） #

如果你的OpenAPI配置是独立的，可以只导入OpenAPI相关的配置类，而不是加载完整Spring上下文：

@SpringBootTest(classes = {OpenApiConfiguration.class}) // 只导入OpenAPI配置类
@AutoConfigureMockMvc
@MockBean({DeviceUpdateService.class, SomeConfiguration.class})
class GenerateApiDocTest {
    // 测试逻辑
}

这种方式会最小化Spring上下文的范围，只加载生成OpenAPI文档必需的组件，进一步提升测试效率。

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