无数据库连接时运行spring-boot-maven-plugin start目标的解决方案

方案1：通过Profile批量Mock所有Repository #

创建一个仅在OpenAPI生成阶段激活的配置类，批量Mock所有Repository接口，无需修改业务代码：

1. 新增配置类，指定专属Profile：

import org.mockito.Mockito;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.util.ClassUtils;

import java.util.Set;

@Configuration
@Profile("openapi-generate")
public class OpenApiRepositoryMockConfig {

    // 替换为你的Repository实际包路径
    private static final String REPOSITORY_PACKAGE = "com.yourcompany.yourapp.repository";

    @SuppressWarnings("unchecked")
    @Bean
    public void registerMocks() {
        // 扫描包下所有JpaRepository接口
        Set<Class<?>> repositoryClasses = ClassUtils.getAllInterfacesForPackage(REPOSITORY_PACKAGE,
                clazz -> JpaRepository.class.isAssignableFrom(clazz));

        // 为每个Repository注册Mock实例
        repositoryClasses.forEach(repoClass -> {
            Mockito.mock((Class<? extends JpaRepository>) repoClass);
        });
    }
}

2. 构建时指定该Profile：
   修改Maven启动命令，激活openapi-generate Profile：

mvn spring-boot:start -Dspring.profiles.active=openapi-generate

启动时Spring会自动为所有Repository创建Mock实例，既满足Controller的依赖注入要求，又不需要实际数据库连接。

方案2：完全排除数据库相关自动配置+Mock依赖 #

直接排除所有数据库和Spring Data JPA的自动配置类，同时为Controller依赖的Repository提供Mock Bean：

1. 修改启动类的@SpringBootApplication注解，排除数据库相关配置：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.data.jpa.JpaRepositoriesAutoConfiguration;
import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration;
import org.springframework.boot.autoconfigure.jdbc.DataSourceTransactionManagerAutoConfiguration;
import org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration;

@SpringBootApplication(exclude = {
        DataSourceAutoConfiguration.class,
        DataSourceTransactionManagerAutoConfiguration.class,
        HibernateJpaAutoConfiguration.class,
        JpaRepositoriesAutoConfiguration.class
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 搭配方案1中的OpenApiRepositoryMockConfig配置类，确保Controller依赖的Repository有Mock实例可用。

方案3：SpringDoc离线生成模式（无需启动服务） #

如果不需要启动完整Spring Boot服务，SpringDoc支持离线扫描Controller类直接生成OpenAPI文档：

修改springdoc-openapi-maven-plugin的配置，启用离线模式：

<plugin>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-maven-plugin</artifactId>
    <version>1.6.0</version>
    <executions>
        <execution>
            <id>generate-openapi</id>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <!-- 指定Controller所在包 -->
                <packagesToScan>com.yourcompany.yourapp.controller</packagesToScan>
                <!-- 启用离线模式，无需启动服务 -->
                <offline>true</offline>
                <outputFileName>openapi.json</outputFileName>
                <outputDirectory>${project.build.directory}</outputDirectory>
            </configuration>
        </execution>
    </executions>
</plugin>

这种方式完全跳过服务启动流程，直接通过类扫描生成OpenAPI文档，从根源上避免了数据库连接和Repository实例化问题，是最轻量化的方案。

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