Spring Boot + GraphQL + MongoDB环境下基于Connection模式的分页实现咨询

我太懂你现在的困扰了——Spring GraphQL官方关于Connection模式分页的文档确实不够清晰，而且大多例子都是基于JPA的，用MongoDB的时候很容易摸不着头脑。下面我一步步给你梳理从Repository到Controller，再到配置的完整实现方案，帮你搞定这个问题。

一、先确认核心依赖（确保你已经引入） #

首先要保证项目里已经包含了Spring GraphQL和MongoDB的起步依赖，比如在pom.xml（Maven）里：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-graphql</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-mongodb</artifactId>
    </dependency>
</dependencies>

二、自定义BookRepository方法（适配MongoDB） #

MongoRepository本身支持分页查询，但为了适配Connection模式，我们需要返回Slice<Book>而非Page<Book>。Slice比Page更轻量，不需要查询总条数，正好契合Connection模式只关心是否还有更多数据的需求，它自带hasNext()、hasPrevious()等状态方法，完美匹配Connection的hasNextPage、hasPreviousPage字段。

你的Repository接口应该这么写：

import org.springframework.data.domain.Slice;
import org.springframework.data.domain.Pageable;
import org.springframework.data.mongodb.repository.MongoRepository;

public interface BookRepository extends MongoRepository<Book, String> {
    // 基于Pageable查询，返回Slice<Book>
    Slice<Book> findAll(Pageable pageable);
}

三、编写GraphQL查询的Resolver实现 #

接下来要实现GraphQL中定义的books和book查询方法。这里需要把Connection模式的参数（first/last/before/after）转换成MongoDB能识别的Pageable，再用Spring GraphQL提供的工具把Slice<Book>转换成BookConnection类型。

示例Resolver代码：

import org.springframework.graphql.data.pagination.PaginationUtils;
import org.springframework.graphql.data.pagination.SliceConnectionAdapter;
import org.springframework.graphql.data.pagination.CursorStrategy;
import org.springframework.stereotype.Component;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Slice;
import java.util.Optional;

@Component
public class BookQueryResolver {

    private final BookRepository bookRepository;
    private final CursorStrategy cursorStrategy;

    // 构造注入依赖
    public BookQueryResolver(BookRepository bookRepository, CursorStrategy cursorStrategy) {
        this.bookRepository = bookRepository;
        this.cursorStrategy = cursorStrategy;
    }

    // 实现Connection模式的books查询
    public BookConnection books(Integer first, Integer last, String before, String after) {
        // 将Connection参数转换为Pageable
        Pageable pageable = PaginationUtils.createPageable(first, last, before, after, cursorStrategy);
        
        // 查询获取Slice<Book>
        Slice<Book> bookSlice = bookRepository.findAll(pageable);
        
        // 把Slice适配为BookConnection
        return SliceConnectionAdapter.adapt(bookSlice, cursorStrategy);
    }

    // 实现单个book的查询
    public Optional<Book> book(String id) {
        return bookRepository.findById(id);
    }
}

这里要注意：PaginationUtils是Spring GraphQL提供的工具类，专门用来处理Connection参数到Pageable的转换；SliceConnectionAdapter则负责把查询得到的Slice转换成符合GraphQL规范的BookConnection，自动生成edges、pageInfo等字段。

四、正确配置CursorStrategy和ConnectionFieldTypeVisitor #

你之前的配置可能问题出在Adapter的选择和CursorStrategy的定义上。对于MongoDB，推荐使用Keyset游标策略（基于唯一键比如id来做游标，比offset分页性能更好），而且只需要配置SliceConnectionAdapter即可（因为我们用的是Slice类型）。

示例配置类：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.graphql.data.pagination.ConnectionFieldTypeVisitor;
import org.springframework.graphql.data.pagination.SliceConnectionAdapter;
import org.springframework.graphql.data.pagination.KeysetCursorStrategy;
import org.springframework.graphql.data.pagination.CursorStrategy;
import org.springframework.graphql.execution.GraphQlSource;
import org.springframework.core.io.Resource;
import org.springframework.core.io.support.ResourcePatternUtils;
import java.util.List;

@Configuration
public class GraphQLConfig {

    // 定义游标策略：基于Book的id字段作为游标
    @Bean
    public CursorStrategy cursorStrategy() {
        return new KeysetCursorStrategy(List.of("id"), Book.class);
    }

    // 配置GraphQL Source，注册Connection类型转换器
    @Bean
    public GraphQlSource graphQlSource(CursorStrategy strategy) throws Exception {
        GraphQLTypeVisitor visitor = ConnectionFieldTypeVisitor.create(List.of(
            new SliceConnectionAdapter(strategy)
            // 不需要WindowConnectionAdapter，因为我们用的是Slice而非Window
        ));

        return GraphQlSource.schemaResourceBuilder()
            .schemaResources(ResourcePatternUtils.getResourcePatternResolver(null)
                .getResources("classpath:graphql/schema.graphqls")) // 替换成你的schema路径
            .typeVisitors(visitor)
            .build();
    }
}

五、验证GraphQL Schema的正确性 #

你的Schema中已经定义了Book和Query类型，Spring GraphQL的ConnectionFieldTypeVisitor会自动帮你生成BookConnection、BookEdge、PageInfo这些关联类型，不需要你手动编写。不过如果你想自定义的话，也可以补充这些类型：

type BookConnection {
    edges: [BookEdge!]!
    pageInfo: PageInfo!
}

type BookEdge {
    node: Book!
    cursor: String!
}

type PageInfo {
    hasNextPage: Boolean!
    hasPreviousPage: Boolean!
    startCursor: String
    endCursor: String
}

常见问题排查 #

1. 如果之前配置没生效，检查是否在GraphQlSource中正确注册了typeVisitors
2. 确保Repository返回的是Slice<Book>而非Page<Book>，SliceConnectionAdapter只处理Slice类型
3. 游标策略的字段要正确，比如用id的话，要保证Book实体的id字段能被正确序列化/反序列化为游标字符串

备注：内容来源于stack exchange，提问作者operatiay