Spring Cloud GCP连接Firestore Native模式查询报no matching index found错误

问题根因 #

1. 依赖不匹配 #

你当前使用的spring-cloud-gcp-starter-data-datastore是面向Firestore Datastore模式（原Google Cloud Datastore）设计的依赖，无法适配原生模式Firestore的API规则，两者的索引体系、数据访问逻辑完全独立，原生模式的自动索引规则对Datastore客户端不生效。

2. 查询逻辑的索引要求差异 #

就算是在Datastore模式下，你当前的查询是对applicationId做等值过滤的同时对该字段做排序，旧版本（1.2.8.RELEASE）的Datastore客户端对这类查询的索引判定规则更严格，不会自动触发单字段索引创建，需要手动配置。 #

解决方案 #

方案一：切换为原生Firestore适配依赖（推荐） #

适配原生模式Firestore的标准实现方案如下：

1. 替换POM依赖

<!-- 移除原来的datastore starter，替换为firestore原生starter -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-gcp-starter-data-firestore</artifactId>
</dependency>

建议将gcp.version升级到2.4.x及以上稳定版本，旧版本对原生Firestore的支持存在较多兼容性问题。
2. 调整实体类注解

import com.google.cloud.spring.data.firestore.mapping.Document;
import org.springframework.data.annotation.Id;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Getter
@Setter
@Document(collectionName = "user_profile")
public class UserProfile {
    @Id
    // Firestore默认文档ID为字符串类型，若要保留Long类型需要自定义ID生成逻辑适配
    private String id;
    private String applicationId;
    private String firstName;
}

3. 调整Repository接口

import com.google.cloud.spring.data.firestore.repository.FirestoreRepository;
import java.util.List;
import org.springframework.data.domain.Sort;

public interface UserProfileRepository extends FirestoreRepository<UserProfile, String> {
    // 显式声明Sort参数避免动态传参的序列化问题
    List<UserProfile> findByApplicationId(String applicationId, Sort sort);
}

调整后单字段过滤+同字段排序的查询会自动使用Firestore原生自动索引，无需手动创建。 #

方案二：保留Datastore依赖（仅适合将Firestore切换为Datastore模式的场景） #

如果业务侧确定使用Datastore模式，可以手动创建缺失索引：

1. 登录Google Cloud控制台，进入Datastore的索引管理页面
2. 创建针对user_profile类别、applicationId字段升序的单字段复合索引
3. 等待索引部署生效后即可正常执行查询

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