在Unreal Engine 4中使用VaRest插件读取Firestore数据的最佳方式是什么

前置准备 #

• 已安装和当前UE4版本适配的VaRest插件，在项目插件管理中启用VaRest并重启编辑器
• 已在Firebase控制台开启Firestore数据库，获取到项目ID，开发阶段可先将数据库权限配置为测试可读，生产环境再替换为身份验证逻辑

配置流程 #

1. Firestore REST接口规则确认 #

Firestore官方提供的标准REST读取路径格式为：
https://firestore.googleapis.com/v1/projects/你的项目ID/databases/(default)/documents/目标集合名
单文档读取直接在集合名后拼接文档ID即可，带过滤条件的查询直接在路径后追加对应查询参数即可。

2. VaRest插件基础配置 #

• 打开UE4项目设置，找到VaRest配置页，关闭Enable Content Compression选项，避免Firestore返回的压缩内容解析失败
• 在VaRest全局默认请求头中添加Content-Type: application/json，无需每次请求单独配置

具体操作步骤 #

步骤1：构造VaRest请求对象 #

蓝图实现

调用Construct VaRest Request节点，请求方法选择GET，填入对应Firestore REST请求地址即可。

C++实现

UVaRestRequestJSON* Request = UVaRestRequestJSON::ConstructRequest(this);
Request->SetVerb(ERequestVerb::GET);
// 替换为你自己的Firestore请求地址
Request->SetURL(TEXT("https://firestore.googleapis.com/v1/projects/xxx/databases/(default)/documents/Users/123"));

步骤2：绑定请求回调并发起请求 #

• 蓝图中绑定OnRequestComplete委托，首先判断返回状态码是否为200，状态码为200即为请求成功
• C++绑定示例：

Request->OnRequestComplete.AddDynamic(this, &AYourActor::OnFirestoreRequestFinished);
Request->ProcessRequest();

步骤3：解析返回数据 #

Firestore REST返回的所有字段都会带类型标识，比如字符串字段封装在stringValue下，整数字段封装在integerValue下，不能直接用字段名取值
示例解析逻辑：
要获取用户名字段，需要按层级documents -> fields -> username -> stringValue逐层读取，用VaRest接口实现的代码如下：

FString UserName = Request->GetResponseObject()->GetObjectField(TEXT("fields"))->GetStringField(TEXT("username"));

注意事项 #

• 生产环境禁止使用公开可读权限，需要在请求头中添加Authorization: Bearer 用户登录后获取的ID Token参数做身份校验
• 批量读取数据不要高频发起单次请求，建议用Firestore批量查询接口合并请求，避免触发请求频率限制
• VaRest默认请求超时时间为30秒，弱网场景可适当调大超时参数避免请求失败
• 所有字段解析前要做非空判断，避免数据库对应字段不存在时触发UE4崩溃
• 禁止在客户端硬编码Firebase服务账号密钥，敏感权限逻辑需要放在服务端处理，避免数据泄露风险

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