Spring Boot中Firestore转Java对象遇字段映射失败问题求助

问题核心原因 #

• Firestore的DocumentSnapshot.toObject()方法使用自身的CustomClassMapper完成映射，不识别Gson的@SerializedName注解，导致带空格、特殊字符的Firestore字段无法匹配Java实体字段。
• 实体类存在错误映射：比如将对应"Espécie exclusiva do Brasil"的字段错误标注了@SerializedName("\nEspécie (Simplificado)")，完全不匹配目标字段。
• 部分Firestore字段名包含末尾空格（如"Ordenamento Pesqueiro "），注解未完全匹配该字段名。

解决方案 #

1. 替换为Firestore专属注解 #

使用Firestore官方提供的@PropertyName注解（包路径：com.google.cloud.firestore.annotation.PropertyName），该注解是Firestore映射器唯一识别的字段关联注解。

2. 修正错误映射关系 #

逐一核对每个@PropertyName的值，确保完全匹配Firestore中的字段名（包括空格、重音符号、末尾空格等细节）。

3. 确保Lombok注解生效 #

确认项目已正确引入Lombok依赖，且IDE启用了Lombok支持，保证@Getter/@Setter能生成符合规范的getter/setter方法（Firestore映射依赖这些方法完成赋值）。

修改后的Species实体类代码 #

package com.example.Rest.FireBase.Model;

import com.google.cloud.firestore.annotation.PropertyName;
import lombok.*;

@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Species {
    @PropertyName("Categoria de Ameaça")
    private String categoriaDeAmeaca;

    @PropertyName("Espécie exclusiva do Brasil")
    private String especieExclusivaDoBrasil;

    @PropertyName("Estados de Ocorrência")
    private String estadosDeOcorrencia;

    @PropertyName("Principais Ameaças")
    private String principaisAmeacas;

    @PropertyName("Sigla Categoria de Ameaça")
    private String siglaCategoriaDeAmeaca;

    @PropertyName("Plano de Ação Nacional para Conservação (PAN)")
    private String planoDeAcaoNacionalParaConservacao;

    @PropertyName("Família")
    private String familia;

    @PropertyName("Bioma")
    private String bioma;

    @PropertyName("Nível de Proteção na Estratégia Nacional")
    private String nivelDeProtecaoNaEstrategiaNacional;

    @PropertyName("Espécie (Simplificado)")
    private String especieSimplificado;

    @PropertyName("Nome Comum")
    private String nomeComum;

    @PropertyName("Ordenamento Pesqueiro ")
    private String ordenamentoPesqueiro;

    @PropertyName("Grupo")
    private String grupo;

    @PropertyName("Fauna/Flora")  
    private String faunaFlora;

    @PropertyName("Presença em Áreas Protegidas")
    private String presencaEmAreasProtegidas;
}

注：Java字段名改为小驼峰命名（符合Java编码规范），不影响映射逻辑，只要@PropertyName的值与Firestore字段完全一致即可。

验证效果 #

修改后重新运行项目，控制台的"No setter/field for XXX found"警告会消失，Firestore中的所有字段都能正确映射到Java实体类中，返回的JSON数据也不会再出现大量null值。

内容的提问来源于stack exchange，提问作者João Victor Ambrozio