Firestore含受限字符字段的推荐存储方式咨询

针对Firestore字段路径不允许使用~、*、/、[、]这些字符的问题，有几个实用的解决思路，推荐按优先级选择：

1. 调整数据结构（优先推荐） #

不要把食品名称直接作为字段名，而是将食品条目封装成数组或嵌套对象的形式存储。比如把原来的键值对结构：

{
  "Apple/Red": 95,
  "Banana~Ripe": 105
}

改成：

{
  "foodItems": [
    {"name": "Apple/Red", "calories": 95},
    {"name": "Banana~Ripe", "calories": 105}
  ]
}

这种方式完全避开了字段名的字符限制，还能轻松扩展存储更多属性（比如分量、摄入时间），查询和维护也更符合Firestore的设计逻辑。

2. URL编码/解码 #

利用encodeURIComponent和decodeURIComponent对食品名称进行编码后作为字段名，读取时再解码。示例（JavaScript）：

// 编码字段名
const encodedName = encodeURIComponent("Apple/Red"); // 得到 "Apple%2FRed"
// 写入Firestore
await db.collection("calories").doc(userId).set({
  [encodedName]: 95
}, { merge: true });

// 读取时解码
const doc = await db.collection("calories").doc(userId).get();
const decodedData = Object.fromEntries(
  Object.entries(doc.data()).map(([key, value]) => [decodeURIComponent(key), value])
);

这个方案实现简单，不需要自定义替换规则，编码后的字符也符合Firestore的字段名要求。

3. 自定义字符替换 #

如果不想用URL编码，可以自定义受限字符的替换规则，比如把每个受限字符映射成唯一的占位符，注意占位符不能是食品名称中可能出现的字符串。示例：

// 编码规则：替换受限字符
const encodeKey = (key) => {
  return key.replace(/~/g, "__TILDE__")
            .replace(/\*/g, "__STAR__")
            .replace(/\//g, "__SLASH__")
            .replace(/\[/g, "__LBRACKET__")
            .replace(/\]/g, "__RBRACKET__");
};

// 解码规则：还原原字符
const decodeKey = (key) => {
  return key.replace(/__TILDE__/g, "~")
            .replace(/__STAR__/g, "*")
            .replace(/__SLASH__/g, "/")
            .replace(/__LBRACKET__/g, "[")
            .replace(/__RBRACKET__/g, "]");
};

使用时在写入前编码，读取后解码即可。但要注意如果后续食品名称出现和占位符相同的字符串，会导致解码错误，需要提前规避这种情况。

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