如何配置SpringDoc让Spring Data Rest生成的OpenAPI使用正确方法名？

快速配置方案（无需注解） #

针对Spring Data Rest生成的端点，springdoc提供了内置配置项可以直接指定operationId的生成策略，无需手动添加@Operation注解：

在Spring Boot的application.yml中添加：

springdoc:
  data-rest:
    operation-id-strategy: METHOD_NAME

如果用application.properties则是：

springdoc.data-rest.operation-id-strategy=METHOD_NAME

配置后，插件会直接将Repository中的方法名（比如findByTestname）作为对应接口的operationId，替代默认生成的executeSearch-user-get这类格式。

自定义扩展方案（按需调整） #

如果需要更灵活的定制逻辑，比如对特定方法做修改，可以创建一个OperationCustomizer Bean来手动覆盖operationId：

import org.springdoc.core.customizers.OperationCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.rest.core.annotation.RepositoryRestResource;
import org.springframework.web.method.HandlerMethod;

@Configuration
public class OpenApiCustomConfig {
    @Bean
    public OperationCustomizer repositoryOperationIdCustomizer() {
        return (operation, handlerMethod) -> {
            // 仅处理带有RepositoryRestResource注解的类的方法
            if (handlerMethod.getBeanType().isAnnotationPresent(RepositoryRestResource.class)) {
                operation.setOperationId(handlerMethod.getMethod().getName());
            }
            return operation;
        };
    }
}

这种方式可以根据需求添加额外逻辑，比如给某些方法的operationId统一加前缀，或者过滤特定方法。

注意事项 #

• 确保springdoc-openapi-maven-plugin和springdoc-openapi-data-rest依赖版本匹配，建议使用最新稳定版本，避免版本兼容问题。
• operation-id-strategy配置仅对Spring Data Rest生成的端点生效，不会影响普通Controller的接口生成逻辑。

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